# CLIProxyAPI

CLIProxyAPI is a proxy server that exposes OpenAI-, Gemini-, Claude-, Codex-, and Grok-compatible application programming interface (API) endpoints for supported command-line interface (CLI) and OAuth providers. It is open source and self-hosted, installable on Proxmox and Unraid.

Canonical page: https://ourlocalhost.com/app/2711/cliproxyapi

## Description

CLIProxyAPI is a proxy server that exposes OpenAI-, Gemini-, Claude-, Codex-, and Grok-compatible application programming interface (API) endpoints for supported command-line interface (CLI) and OAuth providers. It lets homelab users connect multiple CLI provider accounts to standard client applications or software development kits (SDKs) through one locally hosted endpoint. Keep it on a trusted local area network (LAN) or virtual private network (VPN) because provider availability and authentication depend on upstream services.

## Platform availability

Available on 2 of 10 platforms: Unraid, Proxmox.

## Health score

80/100 (Excellent), based on 5 of 5 factors.
- Maintained: 100 (last commit 7 days ago)
- Popular: 95 (58,553 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=cliproxyapi
- Unraid: https://ca.unraid.net/apps/cliproxyapi-1z0uprg0dt0glk?q=CLIProxyAPI

## Common questions

### Why do I get 'command not found' after installing CLIProxyAPI?

Move the pre-built binary to /usr/local/bin with sudo and make it executable so the cliproxy command is available; skipping this step can cause command not found.

### What should I set in a minimal CLIProxyAPI config before starting the server?

Set the listening port, such as 8317, and add your Gemini API key under gemini-api-key; without the key, the app cannot use Gemini.

### What should I back up to avoid re-authenticating CLIProxyAPI accounts?

Back up the auth-dir folder, such as ~/.cli-proxy-api, because it stores local authentication data; deleting or sharing it can force re-authentication or expose account access.

### What authentication methods are supported for Kimi, OpenAI, Gemini, Muse, and Devin?

Kimi supports OAuth or compatible API interfaces, and OpenAI models can be accessed through Codex OAuth. Gemini supports Gemini API, AI Studio, Vertex AI, Gemini CLI, or Antigravity accounts, while Muse uses Meta login or API keys and Devin uses --devin-login.

---
Source: Our Local Host (https://ourlocalhost.com/app/2711/cliproxyapi), the self-hosted and open-source app directory.
