Skip to content

Commit d045142

Browse files
committed
README & buildVars: mention Mistral and OpenRouter
1 parent cc51047 commit d045142

File tree

2 files changed

+18
-21
lines changed

2 files changed

+18
-21
lines changed

buildVars.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,9 @@ def _(arg):
3939
# Add-on description
4040
# Translators: Long description to be shown for this add-on on add-on information from add-ons manager
4141
"addon_description": [
42-
_("Open AI is an NVDA add-on designed to seamlessly integrate the capabilities of the Open AI API into your workflow. Whether you're looking to craft comprehensive text, translate passages with precision, concisely summarize documents, or even interpret and describe visual content, this add-on does it all with ease.")
42+
_("Open AI is an NVDA add-on designed to seamlessly integrate the capabilities of the Open AI API into your workflow. Whether you're looking to craft comprehensive text, translate passages with precision, concisely summarize documents, or even interpret and describe visual content, this add-on does it all with ease."),
43+
"\n",
44+
_("The add-on also supports integration with Mistral and OpenRouter services, thanks to their shared API format.")
4345
],
4446
# version
4547
"addon_version": time.strftime("%y.%m.%d"),

readme.md

Lines changed: 15 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,29 +2,24 @@
22

33
This add-on designed to seamlessly integrate the capabilities of the Open AI API into your workflow. Whether you're looking to craft comprehensive text, translate passages with precision, concisely summarize documents, or even interpret and describe visual content, this add-on does it all with ease.
44

5+
The add-on also supports integration with Mistral and OpenRouter services, thanks to their shared API format.
6+
57
## Installation Steps
68

79
1. Navigate to the [releases page](https://github.com/aaclause/nvda-OpenAI/releases) to find the latest version of the add-on.
810
2. Download the latest release from the provided link.
911
3. Execute the installer to add the add-on to your NVDA environment.
1012

11-
## Prerequisites for Use
13+
## API Key Configuration
14+
15+
To use this add-on, you need to configure it with an API key from your selected service provider(s) ([OpenAI](https://platform.openai.com/), [Mistral AI](https://mistral.ai/), and/or [OpenRouter](https://openrouter.ai/). Each provider offers a straightforward process for API key acquisition and integration.
1216

13-
To fully unlock the capabilities of the OpenAI NVDA add-on, you must obtain an API key from OpenAI. Here's how to configure it for use:
17+
Once you have your API key, the next step is to integrate it with the add-on:
1418

15-
1. Acquire an API key by registering for an OpenAI account at [https://platform.openai.com/api-keys](https://platform.openai.com/api-keys).
16-
2. With the API key ready, you have two options for configuration:
17-
- Through the NVDA settings dialog:
18-
1. Access the NVDA menu and navigate to the "Preferences" submenu.
19-
2. Open the "Settings" dialog and select the "Open AI" category.
20-
3. Input your API key in the provided field and click "OK" to confirm.
21-
- Using environment variables:
22-
1. Press `Windows+Pause` to open System Properties.
23-
2. Click on "Advanced system settings" and select "Environment Variables".
24-
3. Create a new variable under "User variables":
25-
1. Click on "New".
26-
2. Enter `OPENAI_API_KEY` as the variable name and paste your API key as the value.
27-
4. Click "OK" to save your changes.
19+
- Navigate through the NVDA menu to 'Preferences' and then 'Settings'. In the 'Settings' dialog, find the "Open AI" category.
20+
- In this category, you will notice a group labeled 'API Keys' which contains buttons named after the supported service providers (e.g., "OpenAI API keys...").
21+
- Click on the relevant button for your service. A dialogue will appear, prompting not only for your API key but also for an organization key if you have one. This is particularly useful for integrating with services that differentiate between personal and organizational usage.
22+
- Fill in your API key and, if applicable, your organization key in the respective fields and click 'OK' to save your settings.
2823

2924
You are now equipped to explore the features of the OpenAI NVDA add-on!
3025

@@ -45,7 +40,7 @@ Within this dialog, you will be able to:
4540

4641
To further improve your interaction with the interface, please take note of the following:
4742

48-
- The multiline "System", "History", and "Prompt" fields come equipped with context menus filled with commands that can be quickly executed using keyboard shortcuts.
43+
- The multiline "System prompt", "Messages", and "Prompt" fields come equipped with context menus filled with commands that can be quickly executed using keyboard shortcuts. It is the same for the models list.
4944
These shortcuts are active when the relevant field is in focus.
5045
For example, the keys 'j' and 'k' allow you to navigate to the previous and next messages, respectively, when the focus is on the History field.
5146

@@ -63,13 +58,13 @@ Conversely, when the checkbox is left unticked, only the current user prompt is
6358

6459
You can switch between the two modes at any time during a session.
6560

66-
#### About the `System` Field
61+
#### About the "System prompt" Field
6762

68-
The `System` field is designed to fine-tune the AI model's behavior and personality to match your specific expectations.
63+
The "System prompt" field is designed to fine-tune the AI model's behavior and personality to match your specific expectations.
6964

70-
- **Default Prompt**: Upon installation, the add-on includes a default system prompt ready to use.
65+
- **Default System Prompt**: Upon installation, the add-on includes a default system prompt ready to use.
7166
- **Customization**: You have the freedom to personalize the system prompt by modifying the text directly within the field. The add-on will remember the last system prompt you used and automatically load it the next time you launch the dialog. This behavior can be disabled in settings.
72-
- **Reset Option**: Want to go back to the standard configuration? Simply use the context menu to reset the `System` field to its default value effortlessly.
67+
- **Reset Option**: Want to go back to the standard configuration? Simply use the context menu to reset the "System promt" field to its default value effortlessly.
7368

7469
Please be aware that the system prompt is included in the AI model's input data, consuming tokens accordingly.
7570

0 commit comments

Comments
 (0)