cli2api 0.1.0__tar.gz

cli2api-0.1.0/.dockerignore

@@ -0,0 +1,74 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+tests/
+
+# Environment
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Docker
+Dockerfile
+docker-compose.yaml
+.dockerignore
+
+# Documentation
+*.md
+README.md
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+
+# Logs
+*.log
+
+# Claude
+.claude/

cli2api-0.1.0/.env.example

@@ -0,0 +1,22 @@
+# CLI2API Configuration
+# Copy this file to .env and customize as needed
+
+# Server settings
+CLI2API_HOST=0.0.0.0
+CLI2API_PORT=8000
+CLI2API_DEBUG=false
+
+# CLI executable path (auto-detected if not set)
+# CLI2API_CLAUDE_CLI_PATH=/opt/homebrew/bin/claude
+
+# Timeout (in seconds)
+CLI2API_DEFAULT_TIMEOUT=300
+
+# Default model
+CLI2API_DEFAULT_MODEL=sonnet
+
+# Custom models (comma-separated)
+# CLI2API_CLAUDE_MODELS=sonnet,opus,haiku
+
+# Logging
+CLI2API_LOG_LEVEL=INFO

cli2api-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

cli2api-0.1.0/.gitignore

@@ -0,0 +1,56 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+PIPFILE.lock
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+
+# Environment
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+*.log
+
+# Claude
+.claude/

cli2api-0.1.0/Dockerfile

@@ -0,0 +1,44 @@
+# Multi-stage build for CLI2API
+FROM python:3.11-slim as base
+
+# Set environment variables
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# Create app user
+RUN useradd -m -u 1000 cli2api && \
+    mkdir -p /app && \
+    chown -R cli2api:cli2api /app
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    curl \
+    ca-certificates && \
+    rm -rf /var/lib/apt/lists/*
+
+# Copy dependency files
+COPY --chown=cli2api:cli2api pyproject.toml ./
+
+# Install Python dependencies
+RUN pip install -e .
+
+# Copy application code
+COPY --chown=cli2api:cli2api cli2api/ ./cli2api/
+
+# Switch to non-root user
+USER cli2api
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# Run the application
+CMD ["uvicorn", "cli2api.main:app", "--host", "0.0.0.0", "--port", "8000"]

cli2api-0.1.0/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: cli2api
+Version: 0.1.0
+Summary: OpenAI-compatible API over Claude Code CLI
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: pydantic-settings>=2.6.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Provides-Extra: dev
+Requires-Dist: httpx>=0.28.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# CLI2API
+
+OpenAI-compatible API over Claude Code CLI.
+
+## Why CLI2API?
+
+Claude Code CLI is powerful but not all tools support it directly. CLI2API bridges this gap by exposing Claude Code as an OpenAI-compatible API.
+
+**Use Cases:**
+
+- **IDE Integration** — Connect Kilo Code, Roo Code, Cursor, or other editors that support OpenAI API
+- **Custom Applications** — Build apps using familiar OpenAI SDK instead of spawning CLI processes
+- **Team Sharing** — Run one CLI2API server and share Claude access across your team
+- **Tool Compatibility** — Use Claude with any tool that supports OpenAI API format (LangChain, AutoGPT, etc.)
+
+## Requirements
+
+- Python 3.11+
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
+
+## Installation
+
+### Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.com/anoxis/CLI2API.git
+cd CLI2API
+
+# Install dependencies
+pip install -e .
+
+# Start server
+./cli2api.sh
+```
+
+### Add to PATH (Recommended)
+
+For easy access from anywhere:
+
+```bash
+# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
+export PATH="$PATH:/path/to/CLI2API"
+
+# Then run from anywhere
+cli2api.sh
+```
+
+### Running After Installation
+
+Once installed, you can start the server in several ways:
+
+```bash
+# Using the script (recommended)
+./cli2api.sh
+
+# Using Python module
+python -m cli2api
+
+# Using uvicorn directly
+uvicorn cli2api.main:app --host 0.0.0.0 --port 8000
+```
+
+### Docker
+
+Docker requires the repository to be cloned first:
+
+```bash
+# Clone and build
+git clone https://github.com/anoxis/CLI2API.git
+cd CLI2API
+docker build -t cli2api .
+
+# Run with Claude CLI mounted from host
+docker run -p 8000:8000 \
+  -v $(which claude):/usr/local/bin/claude:ro \
+  -e CLI2API_CLAUDE_CLI_PATH=/usr/local/bin/claude \
+  cli2api
+```
+
+Or use docker-compose:
+
+```bash
+# Edit docker-compose.yaml to mount your Claude CLI path
+docker-compose up -d
+```
+
+### Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## IDE Integration
+
+### Kilo Code / Roo Code
+
+1. Start CLI2API server: `./cli2api.sh`
+2. Open extension settings
+3. Add custom provider:
+   - **Provider Name:** `CLI2API` (or any name)
+   - **API Base URL:** `http://localhost:8000/v1`
+   - **API Key:** `not-needed` (any non-empty value)
+   - **Model:** `sonnet` (or `opus`, `haiku`)
+
+### Cursor / Continue
+
+1. Start CLI2API server
+2. Settings → Models → Add Model
+3. Configure:
+   - **API Base:** `http://localhost:8000/v1`
+   - **API Key:** `any-value`
+   - **Model:** `sonnet`
+
+### Generic OpenAI-compatible client
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="http://localhost:8000/v1",
+    api_key="not-needed"
+)
+
+response = client.chat.completions.create(
+    model="sonnet",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+print(response.choices[0].message.content)
+```
+
+## Usage
+
+### Test with curl
+
+```bash
+# Health check
+curl http://localhost:8000/health
+
+# List models
+curl http://localhost:8000/v1/models
+
+# Chat completion
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model": "sonnet", "messages": [{"role": "user", "content": "Hello"}]}'
+
+# Streaming
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model": "sonnet", "messages": [{"role": "user", "content": "Hello"}], "stream": true}'
+```
+
+## Configuration
+
+Environment variables (prefix `CLI2API_`):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `HOST` | `0.0.0.0` | Server host |
+| `PORT` | `8000` | Server port |
+| `CLAUDE_CLI_PATH` | auto-detect | Path to Claude CLI executable |
+| `DEFAULT_TIMEOUT` | `300` | CLI execution timeout (seconds) |
+| `DEFAULT_MODEL` | `sonnet` | Default model |
+| `CLAUDE_MODELS` | `sonnet,opus,haiku` | Available models (comma-separated) |
+| `LOG_LEVEL` | `INFO` | Logging level |
+| `LOG_JSON` | `false` | JSON format logging |
+| `DEBUG` | `false` | Debug mode |
+
+Copy `.env.example` to `.env` for local configuration.
+
+## Available Models
+
+| Model ID | Description |
+|----------|-------------|
+| `sonnet` | Claude Sonnet (default) |
+| `opus` | Claude Opus |
+| `haiku` | Claude Haiku |
+
+## API Endpoints
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /health` | Health check |
+| `GET /` | API info |
+| `GET /v1/models` | List available models |
+| `GET /v1/models/{id}` | Get model info |
+| `POST /v1/chat/completions` | Chat completions (OpenAI compatible) |
+| `POST /v1/responses` | Responses API (OpenAI compatible) |
+
+## Security Notice
+
+CLI2API does **not** implement authentication. It is designed for **local use only**.
+
+- Do not expose to the internet without additional security measures
+- Use behind a reverse proxy with authentication if network access is needed
+- The API inherits permissions from the Claude CLI authentication on the host
+
+## License
+
+MIT

cli2api-0.1.0/README.md

@@ -0,0 +1,202 @@
+# CLI2API
+
+OpenAI-compatible API over Claude Code CLI.
+
+## Why CLI2API?
+
+Claude Code CLI is powerful but not all tools support it directly. CLI2API bridges this gap by exposing Claude Code as an OpenAI-compatible API.
+
+**Use Cases:**
+
+- **IDE Integration** — Connect Kilo Code, Roo Code, Cursor, or other editors that support OpenAI API
+- **Custom Applications** — Build apps using familiar OpenAI SDK instead of spawning CLI processes
+- **Team Sharing** — Run one CLI2API server and share Claude access across your team
+- **Tool Compatibility** — Use Claude with any tool that supports OpenAI API format (LangChain, AutoGPT, etc.)
+
+## Requirements
+
+- Python 3.11+
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
+
+## Installation
+
+### Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.com/anoxis/CLI2API.git
+cd CLI2API
+
+# Install dependencies
+pip install -e .
+
+# Start server
+./cli2api.sh
+```
+
+### Add to PATH (Recommended)
+
+For easy access from anywhere:
+
+```bash
+# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
+export PATH="$PATH:/path/to/CLI2API"
+
+# Then run from anywhere
+cli2api.sh
+```
+
+### Running After Installation
+
+Once installed, you can start the server in several ways:
+
+```bash
+# Using the script (recommended)
+./cli2api.sh
+
+# Using Python module
+python -m cli2api
+
+# Using uvicorn directly
+uvicorn cli2api.main:app --host 0.0.0.0 --port 8000
+```
+
+### Docker
+
+Docker requires the repository to be cloned first:
+
+```bash
+# Clone and build
+git clone https://github.com/anoxis/CLI2API.git
+cd CLI2API
+docker build -t cli2api .
+
+# Run with Claude CLI mounted from host
+docker run -p 8000:8000 \
+  -v $(which claude):/usr/local/bin/claude:ro \
+  -e CLI2API_CLAUDE_CLI_PATH=/usr/local/bin/claude \
+  cli2api
+```
+
+Or use docker-compose:
+
+```bash
+# Edit docker-compose.yaml to mount your Claude CLI path
+docker-compose up -d
+```
+
+### Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## IDE Integration
+
+### Kilo Code / Roo Code
+
+1. Start CLI2API server: `./cli2api.sh`
+2. Open extension settings
+3. Add custom provider:
+   - **Provider Name:** `CLI2API` (or any name)
+   - **API Base URL:** `http://localhost:8000/v1`
+   - **API Key:** `not-needed` (any non-empty value)
+   - **Model:** `sonnet` (or `opus`, `haiku`)
+
+### Cursor / Continue
+
+1. Start CLI2API server
+2. Settings → Models → Add Model
+3. Configure:
+   - **API Base:** `http://localhost:8000/v1`
+   - **API Key:** `any-value`
+   - **Model:** `sonnet`
+
+### Generic OpenAI-compatible client
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="http://localhost:8000/v1",
+    api_key="not-needed"
+)
+
+response = client.chat.completions.create(
+    model="sonnet",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+print(response.choices[0].message.content)
+```
+
+## Usage
+
+### Test with curl
+
+```bash
+# Health check
+curl http://localhost:8000/health
+
+# List models
+curl http://localhost:8000/v1/models
+
+# Chat completion
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model": "sonnet", "messages": [{"role": "user", "content": "Hello"}]}'
+
+# Streaming
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model": "sonnet", "messages": [{"role": "user", "content": "Hello"}], "stream": true}'
+```
+
+## Configuration
+
+Environment variables (prefix `CLI2API_`):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `HOST` | `0.0.0.0` | Server host |
+| `PORT` | `8000` | Server port |
+| `CLAUDE_CLI_PATH` | auto-detect | Path to Claude CLI executable |
+| `DEFAULT_TIMEOUT` | `300` | CLI execution timeout (seconds) |
+| `DEFAULT_MODEL` | `sonnet` | Default model |
+| `CLAUDE_MODELS` | `sonnet,opus,haiku` | Available models (comma-separated) |
+| `LOG_LEVEL` | `INFO` | Logging level |
+| `LOG_JSON` | `false` | JSON format logging |
+| `DEBUG` | `false` | Debug mode |
+
+Copy `.env.example` to `.env` for local configuration.
+
+## Available Models
+
+| Model ID | Description |
+|----------|-------------|
+| `sonnet` | Claude Sonnet (default) |
+| `opus` | Claude Opus |
+| `haiku` | Claude Haiku |
+
+## API Endpoints
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /health` | Health check |
+| `GET /` | API info |
+| `GET /v1/models` | List available models |
+| `GET /v1/models/{id}` | Get model info |
+| `POST /v1/chat/completions` | Chat completions (OpenAI compatible) |
+| `POST /v1/responses` | Responses API (OpenAI compatible) |
+
+## Security Notice
+
+CLI2API does **not** implement authentication. It is designed for **local use only**.
+
+- Do not expose to the internet without additional security measures
+- Use behind a reverse proxy with authentication if network access is needed
+- The API inherits permissions from the Claude CLI authentication on the host
+
+## License
+
+MIT

cli2api-0.1.0/cli2api/__init__.py

@@ -0,0 +1,3 @@
+"""CLI2API - OpenAI-compatible API over CLI tools."""
+
+__version__ = "0.1.0"

cli2api-0.1.0/cli2api/__main__.py

@@ -0,0 +1,22 @@
+"""Entry point for running CLI2API as a module."""
+
+import uvicorn
+
+from cli2api.api.dependencies import get_settings
+
+
+def main():
+    """Run the CLI2API server."""
+    settings = get_settings()
+
+    uvicorn.run(
+        "cli2api.main:app",
+        host=settings.host,
+        port=settings.port,
+        reload=settings.debug,
+        log_level=settings.log_level.lower(),
+    )
+
+
+if __name__ == "__main__":
+    main()

cli2api-0.1.0/cli2api/api/__init__.py

@@ -0,0 +1,5 @@
+"""API module with FastAPI routers."""
+
+from cli2api.api.router import api_router
+
+__all__ = ["api_router"]

cli2api-0.1.0/cli2api/api/dependencies.py

@@ -0,0 +1,38 @@
+"""FastAPI dependencies for dependency injection."""
+
+from functools import lru_cache
+from pathlib import Path
+
+from cli2api.config.settings import Settings
+from cli2api.providers.claude import ClaudeCodeProvider
+
+
+@lru_cache
+def get_settings() -> Settings:
+    """Get cached application settings.
+
+    Returns:
+        Singleton Settings instance.
+    """
+    return Settings()
+
+
+@lru_cache
+def get_provider() -> ClaudeCodeProvider:
+    """Get cached Claude provider.
+
+    Returns:
+        Singleton ClaudeCodeProvider instance.
+
+    Raises:
+        RuntimeError: If Claude CLI is not configured.
+    """
+    settings = get_settings()
+    if not settings.claude_cli_path:
+        raise RuntimeError("Claude CLI not found. Set CLI2API_CLAUDE_CLI_PATH.")
+
+    return ClaudeCodeProvider(
+        executable_path=Path(settings.claude_cli_path),
+        default_timeout=settings.default_timeout,
+        models=settings.get_claude_models(),
+    )