Skip to content

v1.0.0 β€” First Stable Release 🐒⚑

Choose a tag to compare

@Kame696 Kame696 released this 25 May 23:47
· 41 commits to main since this release

🐒⚑ KAME v1.0.0 β€” First Stable Release

The Key-Aware Management Engine for Agent Zero. Production-validated across 1,163 KAME operations and 117 rate-limit events in a single day of intensive A0 usage. Zero engine crashes, 99% pool-healthy uptime, sleep precision within the random jitter window (Β±300ms on a 7.7s sleep).

Highlights

  • Identity-Aware Health: per-provider:model pool isolation.
  • RPM-Aware Predictive Selection: 60-second sliding window per key.
  • Anti-Dogpile + Anti-Thundering-Herd: concurrent calls spread automatically.
  • ETA-Driven Sleep: sleep until the soonest recovery β€” never burn wasted 429 requests.
  • Trust the Connection: zero artificial timeouts on chat, utility, or compression.
  • Smart Quarantine: parses providers retry-delay and respects it to the second.
  • Long-Delay Warning: surfaces >60s delays (likely daily quotas) for operator awareness.
  • Verbose Trace Mode: opt-in observability with key short-id, selection latency, pool snapshot.
  • Clean Uninstall: monkey-patches reverted automatically.

Install

  1. Download the KAME_v1.0.0.zip asset below.
  2. Extract api_rotation_by_kame/ into your Agent Zero /a0/usr/plugins/ directory.
  3. In Agent Zero β†’ Settings β†’ Model Provider, enter API keys comma-separated: key1, key2, key3, ...
  4. Restart Agent Zero.

Look for the active banner on startup:

🐒⚑ KAME v1.0.0 β€” ACTIVE

Compatibility

  • Agent Zero v1.14+ (verified through v1.15)
  • Python 3.10+
  • All LiteLLM-supported providers (Google, OpenAI, Anthropic, Mistral, Groq, DeepSeek, xAI, ...)
  • No new dependencies

License

MIT β€” see LICENSE.

Support the project

If KAME saved you from rate-limit hell, consider a tip:

Bitcoin β€” 36BGYhMEVFgY8PLGMVux93pjGt92KVM6dJ

Full changelog

See CHANGELOG.md for the complete version history (v0.4.x β†’ v1.0.0).


🐒⚑ 4P1 R0T4T10N β€” 4FRE3D0M