Skip to content
View Kame696's full-sized avatar

Block or report Kame696

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Kame696/README.md

🐒⚑ KAME

I build free tools that make AI agents faster and harder to stop.

KAME API key rotation Discord License: MIT


πŸ”‘ KAME β€” the best free API key rotation for AI agents

Join the quota of many API keys, projects and accounts into one. Your agent owns fifteen API keys and uses one. That one hits a rate limit, a daily quota or an "overloaded" provider, and the turn ends while fourteen healthy keys sit there untouched. KAME uses all of them: the healthiest key for every call, the next key when a call fails, and β€” if you keep a list of fallback models β€” the next model when your provider is busy. Your agent keeps going.

Repository What it is
🏠 kame-api-rotation Start here: what KAME does and which port to install
πŸ…°οΈ kame-api-rotation-for-agent-zero The Agent Zero plugin β€” v1.8.2.8
πŸ…· kame-api-rotation-for-hermes The Hermes Agent plugin β€” v1.8.2.8

What you get, on both:

  • ⚑ Every key used. The least-loaded healthy key per call; a refused call moves to the next key at once.
  • 🧠 Every error read, never guessed. The provider's own retry time, per-minute vs daily quota, out-of-credit, a revoked key β€” 82 providers learned from their own documentation.
  • πŸ”€ Your fallback models, one big pool. Every reply starts on your best model; a busy, spent or slow one hands the reply to the next model of your list in seconds.
  • 🏎️ Speed first. A late reply races a backup key, then the next model β€” the first to answer is shown; a cut answer is continued, not restarted. Median reply on a bad Gemini day: 2.6 s.
  • πŸ‘€ You see what happened. Which model answered each reply and how long it took; a live panel with every key, every rest, every switch.
  • πŸ”’ Free, MIT, no telemetry. Keys never leave your machine and never appear in a log.

No provider allowlist anywhere: every decision is made on the evidence in the response, so a provider that does not exist yet is already covered.


πŸ§ͺ What else is coming

I work on two things besides rotation, and they will land here as they become worth other people's time:

  • Chemistry β€” the field I actually come from, and the reason I care whether a long unattended run survives the night.
  • AI agents β€” the tooling around them: what makes one reliable enough to leave alone, and what quietly makes one useless.

Nothing ships here until it has been run against something real. Every project above was built while using it daily and fixed from its own logs.


πŸ‘‹ Say hello

Discord β€” kame055856

Bug report, a log that looks wrong, or an idea for a port to another host: all welcome. If a plugin of mine broke your agent, I would genuinely rather hear it than not.


⭐ Like it?

Free, MIT, nothing to upsell β€” written by one person against a real free tier, on real quotas that really run out. A ⭐ costs nothing and helps someone else find the fix for a problem they are currently blaming on themselves.


Not affiliated with Agent Zero or Nous Research. Just a person with too many API keys and not enough quota.

Pinned Loading

  1. kame-api-rotation-for-agent-zero kame-api-rotation-for-agent-zero Public

    🐒⚑ The best free API key rotation + automatic model fallback for Agent Zero. Many keys and models as one pool: every 429 / RESOURCE_EXHAUSTED read, each key rested exactly as long as needed, a late…

    Python 22 2

  2. kame-api-rotation-for-hermes kame-api-rotation-for-hermes Public

    🐒⚑ The best free API key rotation + automatic model fallback for Hermes Agent. Many keys and models as one pool: every 429 / RESOURCE_EXHAUSTED read, each key rested exactly as long as needed, a la…

    Python 2