🚀 Aura AI Router

Local AI Router with smart failover, 60-90% token savings, and multi-provider support.

Drop-in OpenAI-compatible proxy for all your AI coding tools.

Quick Start

npx aura-ai-router

Dashboard opens at http://localhost:3000

Features

• 🔄 Smart Failover — Auto-switch between providers when rate-limited
• 💰 Save 60-90% Tokens — 22-pass input optimization + 4-tier output reduction
• 🌐 Multi-Provider — OpenAI, Anthropic, Gemini, + free providers
• 🔑 OAuth Support — Google, GitHub Copilot, Claude Code, Codex
• 📊 Dashboard — Real-time stats, logs, quota tracking
• 🦴 Caveman Mode — Make LLM respond 65% shorter
• 💾 Persistent — SQLite storage, survives restarts
• 🌍 Vi/En — Bilingual interface

How It Works

Your AI Tool (VS Code, Cursor, Cline...)
    ↓ http://localhost:3000/api/v1/chat/completions
Aura AI Router
    ├─ Token Saver (22 passes, save 60-90% input)
    ├─ Response Cache (instant for repeat requests)
    ├─ Conversation Pruner (keep context lean)
    ├─ Smart Routing (classify → route to best model)
    └─ Failover (Provider 1 → 2 → 3 → free)
    ↓
AI Provider (Gemini, OpenAI, Anthropic...)

Setup with AI Tools

VS Code + Continue

{
  "models": [{
    "provider": "openai",
    "title": "Aura Router",
    "apiBase": "http://localhost:3000/api/v1",
    "apiKey": "any",
    "model": "gemini-pro"
  }]
}

Cursor

Settings → Models → OpenAI API Base URL: http://localhost:3000/api/v1

Claude Code CLI

export ANTHROPIC_BASE_URL=http://localhost:3000/api/v1

Model Aliases

| Alias | Provider | Actual Model | |-------|----------|-------------| | gpt-4 | OpenAI | gpt-4-turbo-preview | | gpt-3.5-turbo | OpenAI | gpt-3.5-turbo | | claude-3 | Anthropic | claude-3-5-sonnet-20241022 | | gemini-pro | Gemini | gemini-2.5-flash |

API

# Chat completions (OpenAI-compatible)
curl http://localhost:3000/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-pro","messages":[{"role":"user","content":"Hello"}]}'

# Manage keys
curl http://localhost:3000/api/config/keys

# View logs
curl http://localhost:3000/api/logs

# Optimizer stats
curl http://localhost:3000/api/config/optimizer

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | PORT | 3000 | Server port |

Development

git clone https://github.com/tdevstudio/aura-ai-router
cd aura-ai-router
npm install
npm run dev

License

MIT — by Tdev.Studio

Contact

• Website: tdev.site
• Telegram: @HaQuangTung