Deploy Caveman proxy

Deploy and Host Caveman proxy on Railway

Caveman's proxy shrinks tool output, logs and JSON in your AI API calls, so requests use fewer input tokens. This template runs it on your own URL, locked by a proxy token generated per deploy.

Not affiliated with or endorsed by Caveman.

About Hosting Caveman proxy

Official image pinned to bin-v4.0.2, with a volume and health check. Nothing to sign in to: the URL shows cave_unauthorized by design; /health/ready shows it's up. Only non-streaming requests get compressed, so Claude Code and Codex pass through unchanged.

Call it from your code

1. On the canvas, click caveman-proxy. Copy its URL from Settings, Networking, and the value of CAVEMAN_AUTH_TOKEN from Variables: that is your proxy token.
2. Point your SDK at the proxy and send the token in the x-cave-api-key header, next to your own provider key. Anthropic in Python:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://YOUR_PROXY_URL",
    api_key="YOUR_ANTHROPIC_KEY",
    default_headers={"x-cave-api-key": "YOUR_PROXY_TOKEN"},
)

3. For OpenAI use base_url="https://YOUR_PROXY_URL/openai/v1"; for Gemini call https://YOUR_PROXY_URL/gemini/v1beta/models/MODEL:generateContent. A response header x-cave-optimization: caveman-compression shows the request was compressed.
4. Set a provider key on the deploy form instead, and clients send only the proxy token.

Common Use Cases

• Shrink tool output in SDK agents
• One AI API gateway for a team
• Caveman middleware for your app

Dependencies for Caveman proxy Hosting

• caveman-proxy

Deployment Dependencies

• Team deploy guide
• Routes and providers

Implementation Details

Also serves Caveman's middleware API. Keep one replica (SQLite on the volume). Idles at about 30 MB, fitting Free; heavy use outgrows the 0.5 GB volume on Free and Trial.

Why Deploy Caveman proxy on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Caveman proxy on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

Updated 2026-11-06: first release, caveman-proxy bin-v4.0.2.