This documentation refers to PhraseExpress v17 beta. The documentation for the production version 16 is available here.

AI Text Processing

Before you can use AI features, the desired AI model must be initialized in PhraseExpress first:

To enable an AI engine:
  1. Open the PhraseExpress main program window and select File » Settings » AI text processing.
  2. Select the desired AI engine from the popup.
  3. Configure the AI engine as described below.

PhraseExpress supports multiple AI engines. You can configure them one after the other and switch between them in above dialog window as needed. This is a one-time procedure.

PhraseExpress itself does not perform any AI processing itself but integrates 3rd party AI engines into the user interface.

Due to the early stage of AI technology, the AI text output can be nonsensical, and the feature is considered experimental. It is provided "as-is" and is not part of the official PhraseExpress specification.

OpenAI/ChatGPT

Video tutorial

Using the commercial OpenAI service requires an "API key" which you receive after registering an account at OpenAI.com (not to be confused with ChatGPT!).

To enter the OpenAI API key in PhraseExpress:
  1. Register an account at OpenAI.com (select "API", not "ChatGPT"!).
  2. Go to your OpenAI user profile and create a personal "API key" (example: 43943f3fd-r46f-0kqeb-55c-6lk3l2s183ab8).
  3. Open the PhraseExpress Settings » AI text processing.
  4. Select "OpenAI" as the Engine.
  5. Copy & paste the API key into the API key input box.

A green check mark indicates successful activation in PhraseExpress:

If the check mark does not appear, check for typos or excess characters or spaces. Use the clipboard to prevent typos. Also, check your internet connection and account status with OpenAI. We can't provide any support here as we do not operate the OpenAI service.

Your prompts/text will transmitted over the internet to the "OpenAI" online service (OpenAI privacy policy) via a https port 443 to "https://api.openai.com/v1" or "https://api.openai.com/v1/chat" .

PhraseExpress itself does not perform the AI processing but integrates the 3rd party service OpenAI into the user interface. Fees may apply for each text processing.

GPT4All (self-hosted)

PhraseExpress supports the free AI engine "GPT4All" with a variety of language models:

Benefits:
  • No subscription required. There are no charges or fees.
  • This engine is self-hosted. No AI related data leaves your computer.
  • Independent from internet access.
Disadvantages:
  • Requires significant computational resources.
  • The locally running engine may be significantly slower than online providers.
  • A selection of language models may not be allowed for commercial use.
To enable GPT4All:

Video tutorial

  1. Open the PhraseExpress settings » AI text processing.
  2. Select "GPT4All" from the drop-down menu "Engine".
  3. Click "Configure". PhraseExpress opens the Microsoft Store, if the required Python component could not be found on your PC.
  4. Download and install the Python component and return to PhraseExpress.
  5. Select the desired language model(s). Please check GTP4All homepage for system requirements.

PhraseExpress will list all successfully initialized language models. Those can later be selected in the actual AI dialog windows.

Additional language models can be added/removed at any time in this settings window.

Ollama (self-hosted)

PhraseExpress supports the free AI engine "Ollama" with a variety of language models.

Benefits:
  • No subscription required. There are no charges or fees.
  • This engine is self-hosted. No AI related data leaves your computer.
  • Independent from internet access.
  • Makes use of your GPU for improved performance.
Disadvantages:
  • Requires significant computational resources.
  • The locally running engine may be significantly slower than online providers.
  • A selection of language models may not be allowed for commercial use.
To enable Ollama:

Video tutorial

  1. Open the PhraseExpress settings » AI text processing.
  2. Select "Ollama" from the drop-down menu "Engine".
  3. Click "Configure". PhraseExpress will open the provider homepage.
  4. Download and install the Ollama software from the provider webpage and then return to PhraseExpress.
  5. Select the desired language model(s). Please check Ollama homepage for details.

After download & installation, PhraseExpress lists all successfully initialized language models. Those can later be selected in the actual AI dialog windows.

Additional language models can be added/removed at any time in this settings window.

Presets

PhraseExpress comes with a selection of presets, enabling you to use the AI technology out of-the-box:

Adding new Presets

To create a new preset:
  1. Open the "PhraseExpress Settings » AI text processing"
  2. Click the Plus-button right next to the preset list.
  3. Under "Preset label", give your new preset a descriptive name.
  4. Under "Instruction" (aka "prompt"), describe in natural words, how you want the AI to process the text:

  5. Click the cog wheel to select the desired AI engine, language model and AI-related parameters.

You now have quick access to your new preset by selecting any text in a phrase and right-clicking into the phrase contents:

Presets are saved in the PhraseExpress program configuration file.

Editing presets

To edit a custom preset, double-click the desired preset in the list, or select it and press the pencil icon.

Deleting presets

To delete a preset, select it in the list of presets, click the trash bin in the lower right of the settings page and confirm the confirmation dialog.

Sample presets shipped with PhraseExpress can be deleted but not restored. You would need to recreate them on your own.

Custom instructions

In this dialog, you describe in natural language how you want the AI to respond.

Table of Contents


Table of Contents