dario  by askalf

Route LLM tools via Claude subscription

Created 3 months ago
307 stars

Top 87.2% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

dario enables Claude Pro/Max subscribers to use their existing subscription across various LLM tools (Cursor, Aider, etc.) by acting as a local endpoint. It replays Claude Code's wire shape, bypassing per-token API bills and offering cost savings and unified integration for developers.

How It Works

dario captures and replays the exact wire shape of Claude Code's interactive sessions. This precise replication fools Anthropic's billing classifier, ensuring requests from integrated tools are routed to the subscription pool rather than incurring metered API charges. It effectively translates tool-specific API calls into the format recognized by the Claude subscription.

Quick Start & Requirements

  • Install: npm install -g @askalf/dario or use the Docker image ghcr.io/askalf/dario:latest.
  • Login: dario login (or dario login --manual for headless).
  • Start Proxy: Run dario proxy in a separate terminal.
  • Configure Tools: Set export ANTHROPIC_BASE_URL=http://localhost:3456 and export ANTHROPIC_API_KEY=dario.
  • Prerequisites: Node.js/npm. Bun is recommended for optimal TLS compatibility.
  • Docs: DISCLAIMER.md, MIGRATION.md, Docker guide.

Highlighted Details

  • Subscription Cost Savings: Utilizes existing Claude Pro/Max plans, eliminating per-token API fees for integrated tools.
  • Wire-Shape Evasion: Replays precise Claude Code request structures to bypass Anthropic's billing classifier.
  • Automated Drift Defense: Hourly, 30-min, and daily watchers automatically detect and patch Anthropic's silent wire-shape/classifier changes.
  • Overage Guard: Halts proxy on "overage" signals to prevent unintended charges, with configurable auto-resume.
  • Multi-Account Pooling: Supports pooling multiple Claude accounts for failover and load balancing.
  • Unified Endpoint: Single localhost:3456 endpoint for Anthropic, OpenAI, Groq, and local Ollama backends.

Maintenance & Community

A sophisticated, automated drift detection system (hourly, 30-min, daily watchers) counters Anthropic's undocumented changes, ensuring continuous operation. Fixes are typically deployed within an hour of Claude Code releases. Community engagement occurs via GitHub issues/PRs; @ask_alf provides drift bulletins.

Licensing & Compatibility

MIT license. Permissive for commercial use.

Limitations & Caveats

dario is an unofficial, third-party tool unaffiliated with Anthropic. Users bear responsibility for terms compliance and credential security. Not suitable for safety-critical or production environments without independent review; lacks vendor-managed SLAs. Relies on continuous maintenance against Anthropic's undocumented API evolution.

Health Check
Last Commit

19 hours ago

Responsiveness

Inactive

Pull Requests (30d)
156
Issues (30d)
54
Star History
48 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.