Skip to main content

​
What it does

AI Calls send your input to an AI model with a custom prompt you define. Unlike Hermes’ built-in AI formatting, AI Calls give you complete control over the prompt and output.

​
AI providers

ProviderModelsAPI Key Required
HermesGPT-OSS-120BNo (included with subscription)
OpenAIGPT-5, GPT-5 ProYes
AnthropicClaude Sonnet 4.5, Opus 4.5, Haiku 4.5Yes
xAIGrok 4, Grok 4.1 FastYes

​
Configuration

SettingDefaultDescription
ProviderHermesWhich AI service to use
ModelDefault for providerSpecific model
Prompt TemplateRequiredYour custom prompt
Output HandlingInjectWhat to do with the response
StreamingOffShow response as it generates

​
Advanced settings

SettingDefaultDescription
Temperature0.7Creativity (0 = focused, 2 = creative)
Max TokensModel defaultResponse length limit
System PromptNoneAdditional AI instructions
Use VisionOffInclude screenshot for context
Conversation HistoryOffRemember previous messages

​
Output handling

OptionWhat happens
InjectInsert response at cursor
ClipboardCopy response to clipboard
NotificationShow as macOS notification
PopupDisplay in floating bubble
Popup + InjectShow popup and insert text
You can select multiple options.

​
Template variables

Use these in your prompt template:
VariableDescription
{transcription}What you said
{selected_text}Currently highlighted text

​
Example prompts

​
Summarize

Trigger: “summarize this” Prompt: 
Summarize the following text in 3 bullet points:

{selected_text}

​
Translate

Trigger: “translate to spanish” Prompt: 
Translate the following to Spanish:

{transcription}

​
Explain code

Trigger: “explain this code” Prompt: 
Explain this code simply, as if to a junior developer:

{selected_text}

​
Draft email

Trigger: “draft email about” Prompt: 
Write a professional email about the following topic:

{transcription}

Keep it concise and friendly.

​
Answer question

Trigger: “ask hermes” Prompt: 
Answer this question helpfully and concisely:

{transcription}

​
Fix grammar

Trigger: “fix this” Prompt: 
Fix any grammar, spelling, or punctuation errors in this text. Only return the corrected text, nothing else:

{selected_text}

​
Creating an AI Call trigger

1

Open Triggers

Go to Settings → Triggers.
2

Create new trigger

Click + or New Trigger.
3

Set the phrase

Enter your trigger phrase (e.g., “summarize this”).
4

Choose matching mode

Exact if using selected text, Prefix if using voice input.
5

Select AI Call

Choose AI Call as the action type.
6

Choose provider and model

Select your AI provider. Add API key if required.
7

Write your prompt

Enter your prompt template using variables.
8

Set output handling

Choose what to do with the response.
9

Save

Click Save.

​
Using your own API keys

To use OpenAI, Anthropic, or xAI:
  1. Go to Settings → Integrations
  2. Enter your API key for the provider
  3. Keys are stored securely and never shared

​
Vision context

When Use Vision is enabled, Hermes includes a screenshot with your prompt. This lets the AI understand what’s on your screen. Use cases:
  • “What’s wrong with this code?” (AI sees the code)
  • “Summarize this page” (AI sees the content)
  • “Help me fill out this form” (AI sees the form fields)

​
Tips

  • Be specific in prompts — Clear instructions get better results
  • Use system prompts for persistent instructions (e.g., “Always respond in bullet points”)
  • Test with Hermes AI first — It’s included, no API key needed
  • Start with low temperature (0.3–0.5) for factual tasks
  • Use higher temperature (0.7–1.0) for creative tasks

Text Formatting

Built-in edit and reply actions.

Variables

All available template variables.