How-To Guide
Use GitHub Copilot Models with Hermes
Configure Hermes Agent to use GitHub Copilot models via your existing Copilot subscription.
Quick answer
If you already pay for GitHub Copilot, configure it as a Hermes provider to use those models at no extra cost — Hermes draws on your existing Copilot allocation. Authenticate with your Copilot subscription in config; it's a cost-free way to add capacity if you're already a Copilot subscriber.
If you have a GitHub Copilot subscription, you can use those models with Hermes at no additional cost. Uses your existing Copilot allocation for Hermes tasks.
Managed cloud · API costs included · Skill library · Cancel anytime
Before you start:
- ☑Hermes Agent installed
- ☑Active GitHub Copilot subscription
- ☑GitHub CLI (gh) installed and authenticated
Steps
- 1
Ensure Copilot subscription
You need an active GitHub Copilot subscription
- 2
Authenticate GitHub CLI
Run gh auth login with Copilot scope
- 3
Set the provider
In config.yaml, set model: provider: copilot
- 4
Choose a model
Access GPT-4 and other models through your Copilot subscription
- 5
Verify authentication
Run gh auth status to confirm Copilot access
Pro Tips
- 💡Reuses your existing Copilot subscription — no separate API costs
- 💡Supports GPT-4 and other models in your Copilot plan
- 💡Use a different aux model to avoid Copilot-ACP issues (e.g., MiMo instead of Qwen)
Troubleshooting
❌ Copilot-ACP authentication errors
✅ Re-run gh auth login with Copilot scope. Check the fix-copilot-acp-issues guide for common issues.
❌ Model not available
✅ Some models require Copilot Pro or Business plans. Check your subscription tier.
❌ Falling back to other auth
✅ Check ~/.hermes/logs/gateway.log for specific auth errors. Usually fixed by re-authenticating gh.
FAQ
Can I use my GitHub Copilot subscription with Hermes?
Yes. Configure Copilot as a provider and Hermes uses your existing Copilot allocation at no additional cost beyond the subscription you already pay for.
Are there limits using Copilot through Hermes?
You're drawing on your Copilot allocation, so heavy agent use counts against it. It's great for moderate use without a separate provider bill.
I'm hitting Copilot-ACP auth errors — what helps?
A common fix is switching your auxiliary model away from Qwen to MiMo, since some aux configurations trip up the Copilot-ACP integration's auth.