tuxevil-rotator
tuxevil/tuxevil-rotator
OpenAI-compatible proxy that rotates free-tier LLM accounts with per-model quota routing
tuxevil-rotator is a TypeScript OpenAI-compatible gateway that gives any agent one local endpoint over several free-tier LLM providers, with multi-account load balancing, per-model quota routing and cost auditing.
What tuxevil-rotator does
The gateway offers multi-account load balancing, per-model quota routing, account health scoring, access control with virtual keys and cost auditing, and it works even with a single account. Supported providers are Google Antigravity, Ollama Cloud, OpenAI Codex and OpenCode Zen, and the design lets new providers slot in without changing core engine logic. The project began as a multi-account rotator for Google Antigravity.
Version 4.0.0 redesigned the WebUI with live routing health, account management, request history and usage analytics, and version 3.11.0 added install-agent, which configures detected or selected agents locally or over SSH. The old ghcr.io/tuxevil/pi-antigravity-rotator image is deprecated in favor of ghcr.io/tuxevil/tuxevil-rotator:latest, and the package migrates legacy config files. The project also sends anonymous telemetry to a public stats dashboard.
Key features
- Single OpenAI-compatible local endpoint for several providers
- Multi-account load balancing with account health scoring
- Per-model quota routing and cost auditing
- Virtual Keys for access control
- install-agent command that configures agents locally or over SSH
- WebUI with live routing health, request history and usage analytics
When to use it
- Giving an agent one local endpoint that spreads requests across several free-tier accounts
- Tracking which provider account has quota left for each model
- Issuing separate virtual keys to different tools while auditing their usage
Who it is for: Developers who run agents against free-tier LLM providers and want routing across accounts.
How it fits with Hermes Agent
A general OpenAI-compatible proxy for any agent; the repository is tagged hermes-agent but the README does not describe a Hermes-specific setup.
Note: Routing traffic through this proxy may violate provider Terms of Service and risk account restriction or bans, and the README advises against using primary accounts.
FAQ
What is tuxevil-rotator?
tuxevil-rotator is an OpenAI-compatible gateway that rotates across multiple free-tier LLM provider accounts. It adds per-model quota routing, account health scoring, virtual keys and cost auditing.
Does tuxevil-rotator work with Hermes Agent?
It exposes an OpenAI-compatible endpoint that any agent can use, and the repository is tagged hermes-agent. The README does not describe a Hermes-specific setup.
Is tuxevil-rotator free and open source?
Yes, the repository is released under the MIT license. The README warns that using the proxy may breach provider terms and risk account bans.
Similar models for Hermes Agent
All modelsSelf-hosted multi-protocol LLM gateway with one base URL across many providers
Socialpranker agentburnLocal profiler that shows which 5-hour window burned your usage, and where tokens went
SouthpawIN TurbofitAdaptive local-inference provider that fits the best sustainable model to your hardware
piyush-tyagi-13 llm-keypoolFree-tier LLM API key pool with rotation, 429 cooldowns and a local OpenAI-compatible proxy
InfiniteWhispers HermesAgent-MultiModelFully local multi-model setup for Hermes Agent with Ollama, Mixture-of-Agents routing and a tuning guide
nujovich Hermes TelemetryBudget enforcement and observability plugin for Hermes Agent that stops runs before they overspend
Related guides: How to install Hermes Agent