koe-setup

Configure Koe voice input for macOS with Volcengine ASR and OpenAI LLM settings.

411|52|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/missuo/koe --skill koe-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: koe-setup
Source: https://github.com/missuo/koe/tree/main/skills/koe-setup
Command: npx skills add https://github.com/missuo/koe --skill koe-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps macOS users install and configure Koe without getting stuck on permissions, cloud credentials, voice correction settings, or hotkey setup.

Core Features & Use Cases

  • Installation and Permissions: Check whether Koe is installed, guide installation, and configure microphone, Accessibility, and Input Monitoring permissions.
  • Service Configuration: Set up Volcengine ASR credentials, connect an OpenAI-compatible LLM, and recommend suitable models and secure environment variable usage.
  • Personalization: Generate domain-specific dictionaries, customize correction prompts, configure hotkeys and feedback sounds, and verify that voice input pastes correctly into applications.
  • Use Case: A developer can use this Skill to install Koe, connect speech recognition and text correction services, create a dictionary containing technical terminology, and test hands-free voice input in a terminal or editor.

Quick Start

Ask the Koe setup skill to check the installation, configure the required credentials and permissions, create a personalized dictionary, and verify voice input.

Frequently Asked Questions about koe-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up voice input on macOS using Koe?

To set up Koe for macOS voice input, you must install the application, grant microphone, Accessibility, and Input Monitoring permissions, and configure your speech recognition and text correction credentials. This ensures reliable voice-to-text pasting across applications.

What credentials do I need to configure Koe speech recognition?

Configuring Koe speech recognition requires a Volcengine ASR account for transcription and an OpenAI-compatible LLM endpoint for text correction. You need to set these as secure environment variables to enable the voice-to-text workflow.

Can I customize a dictionary for voice input with technical terminology?

You can generate domain-specific dictionaries for Koe voice input to improve transcription accuracy. This allows you to add technical terminology and customize correction prompts so the LLM accurately refines your speech.

Does Koe voice input work without an LLM endpoint?

Koe requires an OpenAI-compatible LLM endpoint for complete functionality because the LLM performs the language-model correction on transcribed speech. Without it, the voice input workflow cannot automatically refine and correct your text.

Why is my Koe voice-to-text not pasting into applications?

If Koe voice-to-text is not pasting correctly, you likely lack the required macOS Accessibility or Input Monitoring permissions. Troubleshooting involves verifying these permissions are granted and checking your hotkey and feedback settings.

What's the best way to change hotkeys for macOS voice input?

The best way to change hotkeys for macOS voice input is through the Koe personalization settings. You can configure custom hotkeys and adjust feedback sounds to verify that your voice input activates reliably.