> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Model System Overview

> How ArgentOS routes tasks to the right model tier for optimal cost and performance.

## Overview

ArgentOS uses a **model router** to automatically select the best model for each task. Simple queries go to fast, cheap models. Complex reasoning goes to powerful, expensive ones. This saves money without sacrificing quality.

## The Tier System

| Tier         | Score Range | Default Model            | Cost   | Use Case                                 |
| ------------ | ----------- | ------------------------ | ------ | ---------------------------------------- |
| **LOCAL**    | \< 0.3      | Qwen3 30B-A3B via Ollama | Free   | Simple lookups, quick replies            |
| **FAST**     | 0.3 - 0.5   | Claude Haiku             | Low    | Straightforward questions, memory recall |
| **BALANCED** | 0.5 - 0.8   | Claude Sonnet            | Medium | Most conversations, tool use             |
| **POWERFUL** | > 0.8       | Claude Opus              | High   | Complex reasoning, multi-step planning   |

The model router scores each incoming message on a 0-1 complexity scale and routes it to the corresponding tier.

## Key Features

<CardGroup cols={2}>
  <Card title="Automatic Routing" icon="route">
    No manual model selection needed. The router scores complexity and picks the right tier.
  </Card>

  <Card title="Cost Optimization" icon="piggy-bank">
    Simple tasks use cheap models, saving budget for complex work.
  </Card>

  <Card title="Provider Diversity" icon="shuffle">
    Mix local models, Anthropic, MiniMax, Z.AI, and OpenRouter.
  </Card>

  <Card title="Failover" icon="shield-halved">
    Automatic fallback when a provider is unavailable.
  </Card>
</CardGroup>

## Dashboard Integration

The dashboard shows a **model badge** on each message indicating which tier was used:

| Color  | Tier     | Cost   |
| ------ | -------- | ------ |
| Green  | LOCAL    | Free   |
| Yellow | FAST     | \$     |
| Blue   | BALANCED | \$\$   |
| Purple | POWERFUL | \$\$\$ |

## Deep Dives

<CardGroup cols={2}>
  <Card title="Router Architecture" icon="diagram-project" href="/models/router-architecture">
    How complexity scoring and tier routing work
  </Card>

  <Card title="Providers" icon="cloud" href="/models/providers">
    Supported model providers and configuration
  </Card>

  <Card title="Provider Registry" icon="list" href="/models/provider-registry">
    Dynamic catalog of 15+ providers and 60+ models
  </Card>

  <Card title="Auth Profiles" icon="key" href="/models/auth-profiles">
    Managing multiple API keys and subscriptions
  </Card>

  <Card title="Failover" icon="rotate" href="/models/failover">
    How automatic failover and cooldown work
  </Card>
</CardGroup>