Promptly Logo

Adding More Models

Learn how to add and customize AI models in Promptly

Promptly comes pre-configured with several popular AI models, but you can add more models or customize the existing ones to suit your needs.

Accessing Model Settings

To manage your models in Promptly:

  1. Open Promptly
  2. Click on the Promptly menu in the menu bar
  3. Select Preferences (or use ⌘,)
  4. Navigate to the Models tab

Understanding Model Groups

Promptly organizes models into groups based on their provider:

  • OpenAI: GPT models like GPT-3.5 and GPT-4
  • Anthropic: Claude models like Claude 3 Opus, Sonnet, and Haiku
  • Google: Gemini models
  • Ollama: Local models like Llama, Mistral, and others

Each group requires the corresponding API key, except for Ollama models which run locally.

Adding New Models

Adding Provider-Supported Models

To add a model that's officially supported by a provider but not listed in Promptly:

  1. In the Models tab, find the relevant provider group
  2. Click the "+" button at the bottom of the group
  3. Enter the model information:
    • Display Name: What you want to call the model in Promptly
    • API Name: The exact model identifier used by the provider's API
  4. Click "Add" to save the model

For example, to add a new OpenAI model:

  • Display Name: GPT-4 Turbo
  • API Name: gpt-4-turbo-preview

Adding Custom Ollama Models

For Ollama models, the process is similar but requires Ollama to be installed:

  1. First, install Ollama if you haven't already
  2. Pull the desired model using Ollama (from terminal or Ollama app)
  3. In Promptly's Preferences > Models, find the Ollama group
  4. Click the "+" button
  5. Enter:
    • Display Name: A friendly name (e.g., "Mistral 7B")
    • API Name: The exact model name as used in Ollama (e.g., "ollama:mistral")
  6. Click "Add" to save the model

Editing Existing Models

To modify an existing model:

  1. Navigate to Preferences > Models
  2. Find the model you want to edit
  3. Click the edit (pencil) icon next to the model
  4. Update the display name or API name
  5. Click "Save" to apply your changes

Hiding and Showing Models

You can hide models you don't use to keep your model picker more organized:

  1. In Preferences > Models, find the model you want to hide
  2. Uncheck the "Show in model picker" option next to the model

To show it again, simply check the same option.

Model Priority and Ordering

The order of models in the model picker follows the order in the Preferences > Models tab. You can reorganize models by dragging them into your preferred order.

Troubleshooting

If a model doesn't appear in your model picker:

  • Ensure "Show in model picker" is enabled for that model
  • Check that you've entered the correct API key for the model's provider
  • Verify that the API name exactly matches the provider's specification
  • For Ollama models, confirm that Ollama is running and the model is pulled

With custom models, always double-check the API name, as even small typos can cause connection issues.