cliproxy-server-termux 1.0.0

package/README.md

@@ -0,0 +1,123 @@
+# CLIProxyAPIPlus Server for Termux
+
+> Multi-provider AI API proxy with OAuth support for Android Termux
+
+[![npm version](https://badge.fury.io/js/cliproxy-server-termux.svg)](https://www.npmjs.com/package/cliproxy-server-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
+
+```bash
+npm install -g cliproxy-server-termux
+```
+
+## Quick Start
+
+### 1. Login with OAuth
+
+```bash
+cliproxy-login
+```
+
+Follow the prompts to authenticate with your AI provider accounts.
+
+### 2. Start Server
+
+```bash
+cliproxy
+```
+
+Server will start on `http://localhost:8317/v1`
+
+### 3. Test API
+
+```bash
+curl http://localhost:8317/v1/models
+```
+
+## Usage with Codex
+
+Install the companion Codex package:
+
+```bash
+npm install -g cliproxy-codex-termux
+```
+
+Then use Codex with all models available:
+
+```bash
+codex
+# Press / then type "model" to see all available models
+```
+
+## Available 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
+
+```bash
+# Check if port 8317 is already in use
+lsof -i :8317
+
+# Kill existing process
+pkill cliproxyapi
+```
+
+### OAuth login fails
+
+Make sure you have:
+1. Active internet connection
+2. Valid credentials for the provider
+3. 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
+
+## Links
+
+- [GitHub Repository](https://github.com/julianromli/CLIProxyAPIPlus-Easy-Installation)
+- [Report Issues](https://github.com/julianromli/CLIProxyAPIPlus-Easy-Installation/issues)
+- [Codex Package](https://www.npmjs.com/package/cliproxy-codex-termux)

package/bin/cliproxy-login.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const binaryPath = join(__dirname, 'cliproxyapi');
+
+console.log('🔐 Starting OAuth login flow...\n');
+
+// Run OAuth login
+const login = spawn(binaryPath, ['oauth', 'login'], {
+    stdio: 'inherit',
+    env: {
+        ...process.env,
+    }
+});
+
+login.on('error', (err) => {
+    console.error('Failed to start OAuth login:', err);
+    process.exit(1);
+});
+
+login.on('exit', (code) => {
+    if (code === 0) {
+        console.log('\n✅ Login successful!');
+        console.log('You can now start the server with: cliproxy');
+    }
+    process.exit(code || 0);
+});

package/bin/cliproxy.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const binaryPath = join(__dirname, 'cliproxyapi');
+const configPath = join(__dirname, '..', 'config', 'config-termux.yaml');
+
+// Start CLIProxyAPIPlus server
+const server = spawn(binaryPath, ['-config', configPath], {
+    stdio: 'inherit',
+    env: {
+        ...process.env,
+    }
+});
+
+server.on('error', (err) => {
+    console.error('Failed to start CLIProxyAPIPlus server:', err);
+    process.exit(1);
+});
+
+server.on('exit', (code) => {
+    process.exit(code || 0);
+});
+
+// Handle termination
+process.on('SIGINT', () => {
+    server.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+    server.kill('SIGTERM');
+});

package/bin/cliproxyapi

@@ -0,0 +1 @@
+Not Found

package/config/config-termux.yaml

@@ -0,0 +1,38 @@
+# CLIProxyAPI-Plus Configuration for Termux
+# Optimized for Android/Termux environment
+
+# Server port (default: 8317)
+port: 8317
+
+# Directory to store OAuth tokens
+# Termux uses standard home directory
+auth-dir: "~/.cli-proxy-api"
+
+# API keys for authentication (use any dummy key)
+# These are accepted by the proxy for compatibility with OpenAI clients
+api-keys:
+  - "sk-dummy"
+  - "sk-termux-cliproxy"
+
+# Quota exceeded behavior
+quota-exceeded:
+  switch-project: true      # Auto-switch to another project when quota exceeded
+  switch-preview-model: true # Auto-switch to preview model when quota exceeded
+
+# Browser settings for Termux
+# Termux uses termux-open to launch browser
+incognito-browser: false
+
+# Network settings optimized for mobile
+request-retry: 3
+request-timeout: 60
+
+# Remote management settings
+remote-management:
+  allow-remote: false       # Only allow localhost access for security
+  secret-key: ""            # Leave empty to disable management API
+  disable-control-panel: false
+
+# Logging
+log-level: "info"           # Options: debug, info, warn, error
+log-file: "~/.cli-proxy-api/cliproxy.log"

package/package.json

@@ -0,0 +1,58 @@
+{
+    "name": "cliproxy-server-termux",
+    "version": "1.0.0",
+    "description": "CLIProxyAPIPlus server for Termux - Multi-provider AI API proxy with OAuth support",
+    "type": "module",
+    "main": "bin/cliproxy.js",
+    "bin": {
+        "cliproxy": "bin/cliproxy.js",
+        "cliproxy-login": "bin/cliproxy-login.js"
+    },
+    "files": [
+        "bin/cliproxy.js",
+        "bin/cliproxy-login.js",
+        "bin/cliproxyapi",
+        "config/config-termux.yaml",
+        "scripts/postinstall.js",
+        "README.md"
+    ],
+    "scripts": {
+        "postinstall": "node scripts/postinstall.js"
+    },
+    "keywords": [
+        "cliproxy",
+        "cliproxyapiplus",
+        "gemini",
+        "claude",
+        "openai",
+        "grok",
+        "qwen",
+        "api-proxy",
+        "oauth",
+        "termux",
+        "android",
+        "arm64",
+        "ai",
+        "multi-provider"
+    ],
+    "author": "CLIProxyAPIPlus",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/julianromli/CLIProxyAPIPlus-Easy-Installation.git"
+    },
+    "homepage": "https://github.com/julianromli/CLIProxyAPIPlus-Easy-Installation#readme",
+    "bugs": {
+        "url": "https://github.com/julianromli/CLIProxyAPIPlus-Easy-Installation/issues"
+    },
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "os": [
+        "android",
+        "linux"
+    ],
+    "cpu": [
+        "arm64"
+    ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+import { mkdir, copyFile, access, constants } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const CONFIG_DIR = join(homedir(), '.config', 'cliproxyapi');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.yaml');
+const SOURCE_CONFIG = join(process.cwd(), 'config', 'config-termux.yaml');
+
+async function postinstall() {
+    try {
+        console.log('📦 Setting up CLIProxyAPIPlus...\n');
+
+        // Create config directory
+        await mkdir(CONFIG_DIR, { recursive: true });
+        console.log('✅ Created config directory:', CONFIG_DIR);
+
+        // Check if config already exists
+        try {
+            await access(CONFIG_FILE, constants.F_OK);
+            console.log('⚠️  Config file already exists, skipping copy');
+        } catch {
+            // Copy default config
+            await copyFile(SOURCE_CONFIG, CONFIG_FILE);
+            console.log('✅ Copied default config to:', CONFIG_FILE);
+        }
+
+        console.log('\n🎉 Installation complete!');
+        console.log('\nNext steps:');
+        console.log('1. Run: cliproxy-login');
+        console.log('2. Complete OAuth authentication');
+        console.log('3. Start server: cliproxy');
+        console.log('\nServer will run on: http://localhost:8317');
+    } catch (error) {
+        console.error('❌ Installation failed:', error);
+        process.exit(1);
+    }
+}
+
+postinstall();