Gibby Mascot

Subscribe NOW!

Sari la conținut

7. AI Integration

AI-enhanced voice input with text refinement and natural language command conversion.

AI features are disabled by default. Enable them in Settings to access these features.

Features

  • Text Refinement — Correct transcription errors and improve text quality
  • Command Assistant — Convert natural language speech into keyboard commands

AI Providers (iOS)

KeyMod supports multiple AI providers simultaneously:

Field Description
Name Display name (e.g., "OpenAI", "My Local Server")
API Base URL The API endpoint (e.g., https://api.openai.com/v1)
Model Name The model to use (e.g., gpt-4o)
API Key Stored securely in the iOS Keychain

AI Providers (Android)

Provider Options
AI provider OpenAI, Anthropic, Google Gemini, Mistral AI, Groq, Alibaba (Qwen), DeepSeek, or Custom
API endpoint Set the URL for the AI service
Model Choose the AI model
AI role "Command Assistant" (voice → keyboard actions) or "Text Refinement" (voice → improved text)

System Prompt Roles

  • Text Refinement: Corrects speech-to-text errors, improves grammar and clarity
  • Command Assistant: Converts natural language into keyboard commands. OS-specific prompts for Windows, macOS, and Linux.
  • Custom: User-defined system prompt for specialized behavior

Macro Context in AI

When AI is enabled, your defined macros are automatically included in the system prompt, allowing the AI to suggest or invoke them by name.

Troubleshooting

API Key Not Working (iOS)

Symptom Solution
"API key not configured" Verify the API key is correct — check for extra spaces or typos. Check the API Base URL — must include the full path (e.g., https://api.openai.com/v1). Verify the model name exists on the provider. For local providers (Ollama), ensure the API Key Optional flag is set.

Text Refinement Slow

Check your network connection. Try a faster model — smaller models (gpt-3.5-turbo, llama3-8b) respond faster. Use a local provider (Ollama) to eliminate network latency. Check the AI Request History for error messages.

Next Steps