clove  by mirrorange

Claude.ai reverse proxy with OAuth support

Created 2 months ago
463 stars

Top 65.5% on SourcePulse

GitHubView on GitHub
Project Summary

Clove is a reverse proxy enabling access to Claude.ai via the standard Claude API, targeting AI application developers and users seeking broader Claude integration. It offers full Claude API functionality, including native system messages and pre-fill, by leveraging OAuth authentication, a first for Claude reverse proxies.

How It Works

Clove operates in two primary modes: OAuth and Web Proxy. The OAuth mode utilizes Claude's official API, providing superior functionality and stability. When OAuth is unavailable, it seamlessly switches to a Web Proxy mode, simulating the Claude.ai website to maintain compatibility. This dual approach ensures maximum usability across various AI applications, including SillyTavern and Claude Code.

Quick Start & Requirements

  • Install via pip: pip install "clove-proxy[rnet]"
  • Requires Python 3.13+.
  • Official documentation: README_en.md

Highlighted Details

  • First reverse proxy supporting OAuth authentication for Claude's official API.
  • High compatibility with applications like SillyTavern and Claude Code.
  • Supports advanced API features like native system messages and pre-fill.
  • Web Proxy mode enhances functionality with tool calling and stop sequences.
  • Features a user-friendly web management interface for configuration.

Maintenance & Community

  • Project is actively maintained.
  • Contact via GitHub Issues, Pull Requests, or email: orange@freesia.ink.

Licensing & Compatibility

  • Licensed under the MIT License.
  • Permissive for commercial use and integration with closed-source applications.

Limitations & Caveats

  • Android Termux users require a specific installation (pip install clove-proxy) and cannot use web proxy features or automatic OAuth authentication.
  • Web Proxy mode has limitations with applications making numerous parallel tool calls.
  • Prompt structure may be affected when using Web Proxy mode, especially with free accounts or specific model/account combinations.
Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
4
Star History
87 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.