diff --git a/README.md b/README.md index 445b7e5..c1b1dba 100644 --- a/README.md +++ b/README.md @@ -15,10 +15,79 @@ Just go to the [extension's page](https://chrome.google.com/webstore/detail/leaf 4. Click "Load unpacked" and select the repository folder ## Configuration -The plugin can be configured by clicking the plugin button in the Chrome toolbar. It requires inserting an API key from [OpenAI](https://platform.openai.com/account/api-keys). You also need to choose which tools you wish to enable. +The plugin can be configured by clicking the plugin button in the Chrome toolbar. -If you feel advanced, you can also change the request JSON sent to OpenAI and also the base URL. -To do that, go to the 'Advance Configuration' component in the configuration page. By default, the value is +It requires inserting an API key from [OpenAI](https://platform.openai.com/account/api-keys). + +You also need to choose which tools you wish to enable. See the [Issues](#issues) section if you have problems activating the tools. + +## Usage +These are the tools that are currently available: + +### Auto-complete +Select a text and press `Alt+C` to trigger the auto-complete tool. + +### Improve +Select a text and press `Alt+I` to trigger the improvement tool. The original text will be commented out and the improved text will be inserted below it. + +### Ask +Select a text and press `Alt+A` to trigger the ask tool. The original text will be deleted and the answer will be inserted in its place. + +For example: "Create a table 4x3 that the first row is boldface" will be replaced with, e.g.: +```latex +\begin{tabular}{|c|c|c|} +\hline +\textbf{Column 1} & \textbf{Column 2} & \textbf{Column 3}\\ +\hline +Entry 1 & Entry 2 & Entry 3\\ +\hline +Entry 4 & Entry 5 & Entry 6\\ +\hline +Entry 7 & Entry 8 & Entry 9\\ +\hline +\end{tabular} +``` + +You can then, for example: +1. Write before the table: Place the following tabular inside a table environment, center it, and give the following title: "The comparison of the three approaches" +2. Select the sentence and the table +3. Press `Alt+A` to trigger the ask tool. + +The result will be: +```latex +\begin{table}[h] +\centering +\caption{The comparison of the three approaches} +\begin{tabular}{|c|c|c|} +\hline +\textbf{Column 1} & \textbf{Column 2} & \textbf{Column 3}\\ +\hline +Entry 1 & Entry 2 & Entry 3\\ +\hline +Entry 4 & Entry 5 & Entry 6\\ +\hline +Entry 7 & Entry 8 & Entry 9\\ +\hline +\end{tabular} +\end{table} +``` + +## Using non-GPT Models +Other LLM deployments/models are supported as long as they can be accessed via OpenAI Chat Completion API. Some examples: [vLLM models](https://docs.vllm.ai/en/latest/getting_started/quickstart.html#using-openai-chat-api-with-vllm), [LLAMA models](https://github.com/c0sogi/llama-api#usage-chat-completion), and [easyLLM](https://philschmid.github.io/easyllm/examples/chat-completion-api/). + +Use the plugin's JSON editor to change the URL and the model. See [Issue #8](https://github.com/bThink-BGU/LeafLLM/issues/8) for further details. + +## Issues +If nothing happens when you use the plugin, verify that the plugin's shortcuts are not in conflict with other plugins' shortcuts. To do so, go to [chrome://extensions/shortcuts](chrome://extensions/shortcuts). + +If you encounter any problem/question, please open an issue in the project's repository. + +## Privacy +The plugin saves its configuration locally on the user's computer. The plugin sends the API key and the selected text to OpenAI only, and only for the purpose it was made for (i.e., completing and improving text and asking GPT questions). The plugin's authors are not responsible for what OpenAI does with this data. The plugin's authors do not collect any data from the plugin's users. + +## Advanced Configuration +If you feel advanced, you can also change the request JSON sent to OpenAI and the base URL. +To do that, go to the 'Advance Configuration' component on the configuration page. By default, the value is ```json { "openai": { @@ -51,67 +120,3 @@ To do that, go to the 'Advance Configuration' component in the configuration pag } ``` Base is the default configuration which is overridden by the specific command configuration. - -## Usage -These are the tools that are currently available: - -### Auto-complete -Select a text and press `Alt+C` to trigger the auto-complete tool. - -### Improve -Select a text and press `Alt+I` to trigger the improvement tool. The original text will be commented out and the improved text will be inserted below it. - -### Ask -Select a text and press `Alt+A` to trigger the ask tool. The original text will be deleted and the answer will be inserted in its place. - -For example: "Create a table 4x3 that the first row is bold face" will be replaced with, e.g.,: -```latex -\begin{tabular}{|c|c|c|} -\hline -\textbf{Column 1} & \textbf{Column 2} & \textbf{Column 3}\\ -\hline -Entry 1 & Entry 2 & Entry 3\\ -\hline -Entry 4 & Entry 5 & Entry 6\\ -\hline -Entry 7 & Entry 8 & Entry 9\\ -\hline -\end{tabular} -``` - -You can then, for example: -1. Write before the table: Place the following tabular inside a table environment, center it, and give the following title: "The comparison of the three approaches" -2. Select the sentence and the table -3. Press `Alt+a` to trigger the ask tool. - -The result will be: -```latex -\begin{table}[h] -\centering -\caption{The comparison of the three approaches} -\begin{tabular}{|c|c|c|} -\hline -\textbf{Column 1} & \textbf{Column 2} & \textbf{Column 3}\\ -\hline -Entry 1 & Entry 2 & Entry 3\\ -\hline -Entry 4 & Entry 5 & Entry 6\\ -\hline -Entry 7 & Entry 8 & Entry 9\\ -\hline -\end{tabular} -\end{table} -``` - -## Using non-GPT Models -Other LLM deployments/models are supported as long as they can be accessed via OpenAI Chat Completion API. Some examples: [vLLM models](https://docs.vllm.ai/en/latest/getting_started/quickstart.html#using-openai-chat-api-with-vllm), [LLAMA models](https://github.com/c0sogi/llama-api#usage-chat-completion), and [easyLLM](https://philschmid.github.io/easyllm/examples/chat-completion-api/). - -Use the plugin's JSON editor to change the URL and the model. See [Issue #8](https://github.com/bThink-BGU/LeafLLM/issues/8) for further details. - -## Issues -If nothing happens when you use the plugin, verify that the plugin's shortcuts are not in conflict with other plugins' shortcuts [here](chrome://extensions/shortcuts). - -If you encounter any problem/question, please open an issue in the project's repository. - -## Privacy -The plugin saves its configuration locally on the users' computer. The plugin sends the API key and the selected text to OpenAI only, and only for the purpose it was made for (i.e., completing and improving text and asking GPT questions). The plugin's authors are not responsible for what OpenAI do with this data. The plugin's authors do not collect any data from the plugin's users.