Botte Proxy

Transparent HTTP proxy that compresses LLM API requests before forwarding them. Inspired by Headroom's proxy mode.

Features

• Transparent — sits between any OpenAI-compatible agent and its LLM API
• Universal compression — uses Universal Compressor's smart routing (JSON, code, logs, tool output)
• Reversible — originals are cached for retrieval on demand (CCR-like)
• Dashboard — real-time savings dashboard at http://localhost:PORT/dashboard
• Stats API — JSON stats at http://localhost:PORT/stats
• Local-first — your data never leaves your machine

Usage

# Start proxy (default target: http://localhost:11434/v1 for Ollama/LocalAI)
python -m skills.botte_proxy.cli proxy --port 8787

# With specific target
python -m skills.botte_proxy.cli proxy --target http://192.168.1.47:11434/v1 --port 8787

# With OpenAI
python -m skills.botte_proxy.cli proxy --target https://api.openai.com/v1 --api-key $OPENAI_API_KEY

# View stats
python -m skills.botte_proxy.cli stats

# View dashboard
open http://localhost:8787/dashboard

Agent Integration

Point any OpenAI-compatible agent at the proxy:

# Claude Code
CLAUDECODE_API_BASE=http://localhost:8787 claude

# Any OpenAI client
export OPENAI_BASE_URL=http://localhost:8787/v1

# Generic
export OPENAI_API_BASE=http://localhost:8787/v1

Architecture

Agent → Proxy (port 8787) → Compress messages → Forward → LLM API
         ↓
      Dashboard (/dashboard)
      Stats (/stats)