How-To Guide
Configure Kimi/Moonshot as Your Hermes Provider
Configure Hermes Agent to use Kimi Code models from Moonshot AI — excellent for coding tasks.
Quick answer
Configure Kimi (Moonshot AI) for coding-heavy work — the K2.5 model is tuned for software development with strong code generation and understanding. Add your Moonshot/Kimi API key in config and select K2.5; it's a popular cost-effective coding model in the Hermes community.
Kimi Code (from Moonshot AI) excels at coding tasks. The K2.5 model is specifically tuned for software development with excellent code generation and understanding.
Managed cloud · API costs included · Skill library · Cancel anytime
Before you start:
- ☑Hermes Agent installed
- ☑Kimi/Moonshot account and API key
Steps
- 1
Get your API key
Sign up at platform.kimi.ai and get your API key
- 2
Add to .env
Add KIMI_API_KEY=sk-kimi-xxx to ~/.hermes/.env
- 3
Set the provider
In config.yaml, set model: provider: kimi-coding
- 4
Choose a model
Set model: default: kimi-k2.5 for coding tasks
Pro Tips
- 💡Keys starting with sk-kimi- use the Kimi Code API automatically
- 💡For legacy Moonshot keys, set KIMI_BASE_URL to api.moonshot.ai/v1
- 💡Kimi K2.5 has strong multi-language support for international projects
Troubleshooting
❌ Wrong endpoint being used
✅ New sk-kimi- keys use api.kimi.com by default. Legacy keys need KIMI_BASE_URL=https://api.moonshot.ai/v1
❌ Model not found
✅ Check exact model name. Kimi models use format like kimi-k2.5, not k2.5.
FAQ
What is Kimi best at?
Coding. Kimi Code's K2.5 model is specifically tuned for software development, with strong code generation and understanding, making it a favorite for dev-heavy Hermes workflows.
How do I configure Kimi in Hermes?
Set your Moonshot/Kimi API key in config and select the K2.5 model. Some users access it through aggregators; direct is usually faster.
Is Kimi cost-effective?
Yes — it's frequently chosen as a cheaper, capable coding model, often combined with other models in a delegation setup.