proxycast  by aiclientproxy

Universal AI client proxy for unified API access

Created 4 weeks ago

New!

1,027 stars

Top 36.5% on SourcePulse

GitHubView on GitHub
Project Summary

ProxyCast addresses the challenge of fragmented AI service access by unifying disparate AI client credentials (like Kiro, Gemini, Tongyi Qianwen) into a single, locally hosted OpenAI-compatible API endpoint. It targets developers and power users seeking to leverage existing AI service quotas across different tools and IDEs, offering significant cost savings and enhanced flexibility without requiring separate API subscriptions.

How It Works

ProxyCast functions as a local API proxy service. It ingests various AI client credentials (e.g., OAuth tokens, API keys) from supported providers. The core logic, inspired by AIClient-2-API, translates incoming requests from any OpenAI-compatible client tool into the specific format required by the underlying AI provider. This allows tools like Claude Code, Cursor, or custom AI agents to seamlessly interact with services like Claude, Gemini, or Qwen through a unified local interface.

Quick Start & Requirements

  • Primary Install: Download platform-specific installers from the Releases page (macOS .dmg, Windows .exe, Linux .deb).
  • Prerequisites: Node.js >= 20.0.0, Rust >= 1.70, pnpm or npm.
  • Setup: Launch the application, load credentials via the "Provider Management" page ("一键读取凭证"), and start the server from the "Dashboard" ("启动服务器").
  • Client Configuration: Set API Base URL to http://localhost:3001/v1 and API Key to proxycast-key in your AI client tools.
  • Links: Tauri (https://tauri.app/), React (https://react.dev/), Rust (https://www.rust-lang.org/).

Highlighted Details

  • Supports unified management for Kiro (Claude models), Gemini CLI/API, Tongyi Qianwen, Antigravity, Vertex AI, and custom OpenAI/Claude APIs.
  • Features intelligent credential management, including automatic token refresh, quota-based provider switching, and credential file change detection.
  • Provides a local API server compatible with OpenAI's Chat API (/v1/chat/completions, /v1/models) and Anthropic's Messages API (/v1/messages).
  • Built as a cross-platform desktop application using Tauri, React, and Rust, offering a graphical user interface.

Maintenance & Community

The project references AIClient-2-API as a core logic inspiration. Specific details regarding active maintainers, community channels (like Discord/Slack), or a public roadmap are not provided in the README.

Licensing & Compatibility

The project is licensed under the GNU General Public License v3 (GPLv3). This strong copyleft license requires derivative works to be distributed under the same license, potentially impacting integration into closed-source commercial applications.

Limitations & Caveats

ProxyCast is explicitly stated as being "for learning and research use only." Users assume all associated risks, and the authors disclaim responsibility for any losses incurred. The tool acts solely as an API proxy and does not provide AI model services itself, relying entirely on third-party providers and their terms of service. Users are responsible for protecting their sensitive API credentials.

Health Check
Last Commit

18 hours ago

Responsiveness

Inactive

Pull Requests (30d)
29
Issues (30d)
70
Star History
1,079 stars in the last 29 days

Explore Similar Projects

Feedback? Help us improve.