cliproxy-server-termux
v1.1.0
Published
CLIProxyAPIPlus server for Termux - Multi-provider AI API proxy with OAuth support
Maintainers
Readme
CLIProxyAPIPlus Server for Termux
Multi-provider AI API proxy with OAuth support for Android Termux
Features
- 🔐 OAuth Authentication - Secure login for multiple AI providers
- 🌐 Multi-Provider Support - Gemini, Claude, OpenAI, Grok, Qwen, and more
- 🚀 Local API Server - Runs on
http://localhost:8317 - 📱 Termux Optimized - Built specifically for Android ARM64
- ⚡ Zero Configuration - Works out of the box
Installation
npm install -g cliproxy-server-termuxQuick Start
1. Login with OAuth
cliproxy-loginFollow the prompts to authenticate with your AI provider accounts.
2. Start Server
cliproxyServer will start on http://localhost:8317/v1
3. Test API
curl http://localhost:8317/v1/modelsUsage with Codex
Install the companion Codex package:
npm install -g cliproxy-codex-termuxThen use Codex with all models available:
codex
# Press / then type "model" to see all available modelsAvailable Commands
| Command | Description |
|---------|-------------|
| cliproxy | Start the API server |
| cliproxy-login | Run OAuth authentication |
Configuration
Config file location: ~/.config/cliproxyapi/config.yaml
Default settings:
- Port:
8317 - Base URL:
http://localhost:8317/v1 - Auth directory:
~/.config/cliproxyapi/auth
Supported Providers
- Google Gemini (2.5 Pro, 3 Pro Preview)
- Anthropic Claude (Opus 4.5, Sonnet 4.5)
- OpenAI (GPT-4, GPT-3.5)
- xAI Grok
- Alibaba Qwen
- Kiro AI
Troubleshooting
Server won't start
# Check if port 8317 is already in use
lsof -i :8317
# Kill existing process
pkill cliproxyapiOAuth login fails
Make sure you have:
- Active internet connection
- Valid credentials for the provider
- Termux storage permission
API returns 401
Run cliproxy-login again to refresh authentication.
Requirements
- Android device with ARM64 architecture
- Termux app
- Node.js 14 or higher
- Internet connection for OAuth
License
MIT
