Skip to content

snipeship/ccflare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ccflare πŸ›‘οΈ

Track Every Request. Go Low-Level. Never Hit Rate Limits Again.

The ultimate Claude API proxy with intelligent load balancing across multiple accounts. Full visibility into every request, response, and rate limit.

video_compressed.mp4

ccflare Dashboard

Why ccflare?

  • πŸš€ Zero Rate Limit Errors - Automatically distribute requests across multiple accounts
  • πŸ“Š Request-Level Analytics - Track latency, token usage, and costs in real-time
  • πŸ” Deep Debugging - Full request/response logging and error traces
  • ⚑ <10ms Overhead - Minimal performance impact on your API calls
  • πŸ’Έ Free & Open Source - Run it yourself, modify it, own your infrastructure

Quick Start

# Clone and install
git clone https://github.com/snipeship/ccflare
cd ccflare
bun install

# Start ccflare (TUI + Server)
bun run ccflare

# Configure Claude SDK
export ANTHROPIC_BASE_URL=http://localhost:8080

Features

🎯 Intelligent Load Balancing

  • Session-based - Maintain conversation context (5hr sessions)

πŸ“ˆ Real-Time Analytics

  • Token usage tracking per request
  • Response time monitoring
  • Rate limit detection and warnings
  • Cost estimation and budgeting

πŸ› οΈ Developer Tools

  • Interactive TUI (bun run ccflare)
  • Web dashboard (http://localhost:8080/dashboard)
  • CLI for account management
  • REST API for automation

πŸ”’ Production Ready

  • Automatic failover between accounts
  • OAuth token refresh handling
  • SQLite database for persistence
  • Configurable retry logic

Documentation

Full documentation available in docs/:

Screenshots

Dashboard Logs
Real-time Dashboard Request Logs
Analytics
Analytics & Usage Tracking

Requirements

  • Bun >= 1.2.8
  • Claude API accounts (Free, Pro, or Team)

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

MIT - See LICENSE for details


Built with ❀️ for developers who ship

Mentioned in Awesome Claude Code

Mentioned in Awesome Claude Code

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •