Skip to main content

​
Overview

ArgentOS is designed to stay online even when individual API providers or accounts hit limits. The failover system automatically rotates between auth profiles and providers, using exponential backoff to avoid hammering rate-limited services.

​
Failover Chain

When an API call fails, ArgentOS follows this chain:

​
Example

1

Initial failure

Call to anthropic:titanium fails (429 rate limit).
2

Cooldown and retry

anthropic:titanium enters cooldown. Retry with anthropic:webdevtoday.
3

Continue rotation

If that also fails, try anthropic:semfreak.
4

Cross-provider fallback

If all Anthropic profiles are in cooldown, try MiniMax or Z.AI (if configured for the current tier).
5

Final error

If no providers are available, return an error to the user.

​
Exponential Backoff

When a profile hits a rate limit, it enters an exponential backoff cooldown:
The cooldown resets after a successful call from the profile.

​
Cooldown Management

​
Viewing Cooldown Status

The status command shows which profiles are active, which are in cooldown, and when they will be available again.

​
Manual Reset

Clears all cooldown timers, making all profiles immediately available.

​
Error Types

Different errors trigger different behaviors:
Context overflow errors specifically do not trigger profile rotation since the issue is with the request, not the provider.

​
Provider-Specific Notes

Max subscriptions have weekly quotas that reset on a rolling basis. When one account’s quota is exhausted, failover to another subscription keeps the agent running.
MiniMax cannot accept tool call history with Anthropic-format IDs. Failover to MiniMax only works for:
  • Fresh sessions with no tool history
  • Non-tool conversations
The model router accounts for this and avoids routing mid-session tool conversations to MiniMax.
Local models via Ollama have no rate limits or costs but are limited in capability. The LOCAL tier is always available as an ultimate fallback for simple queries.