Metadata-Version: 2.4
Name: raqkid-proxy
Version: 1.0.0
Summary: OpenAI-compatible API proxy for Raqkid/Axentra AI endpoints
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.104.0
Requires-Dist: uvicorn>=0.24.0
Requires-Dist: httpx>=0.25.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: httpx; extra == "dev"

# raqkid-proxy

OpenAI-compatible API proxy for [Raqkid/Axentra](https://raqkidendpoints.vercel.app) AI endpoints. Connect Claude Code, OpenCode, Cursor, or any OpenAI-compatible client to free AI models.

## Install

```bash
pip install raqkid-proxy
```

Or from source:

```bash
git clone https://github.com/yourname/raqkid-proxy.git
cd raqkid-proxy
pip install .
```

## Usage

```bash
# Start with defaults (port 3456)
raqkid-proxy

# Custom port and key
raqkid-proxy --port 8080 --key YOUR_KEY

# All options
raqkid-proxy --port 3456 --host 0.0.0.0 --key YOUR_KEY --log-level debug
```

### Connect Claude Code

```bash
export ANTHROPIC_BASE_URL=http://localhost:3456/v1
export ANTHROPIC_API_KEY=sk-proxy
claude
```

### Connect OpenCode / Cursor

```bash
export OPENAI_API_BASE=http://localhost:3456/v1
export OPENAI_API_KEY=sk-proxy
```

### Run as module

```bash
python -m raqkid_proxy --port 3456
```

## Available Models

| Model Name            | Backend          | Tier    |
|-----------------------|------------------|---------|
| `axentra-v4turbo`     | Axentra v4 Turbo | Free    |
| `chatgpt-gpt4`        | ChatGPT GPT-4    | Free    |
| `deepseek-v3`         | DeepSeek V3      | Free    |
| `llama-v3`            | Llama 3          | Free    |
| `claude-sonnet4_6`    | Claude Sonnet 4.6| Free    |
| `chatgpt-gpt5`        | ChatGPT GPT-5    | Premium |
| `deepseek-v3_2`       | DeepSeek V3.2    | Premium |
| `llama-v4`            | Llama 4          | Premium |
| `claude-opus4_8`      | Claude Opus 4.8  | Premium |

## CLI Options

```
-p, --port       Port to listen on (default: 3456)
--host           Host to bind to (default: 0.0.0.0)
-k, --key        Raqkid API key
--base-url       Raqkid API base URL
--log-level      Uvicorn log level: debug|info|warning|error
```

## How It Works

The proxy translates OpenAI chat completion requests into simple GET requests that the Raqkid API understands, then wraps the response back into OpenAI format. Supports both regular and streaming responses.

```
Client (Claude Code) --> raqkid-proxy --> Raqkid API --> AI Model
     (OpenAI format)      (translate)    (simple GET)   (response)
```

## License

MIT
