# Curtly

> Curtly is an in-memory LLM token optimization proxy and quota governor that cuts token costs by 50-70% via dual-stage optimization: up to 60-90% input prompt compression via Safe Vault AST parsing, and 35-74% output brevity injection via the Output Brevity Governor.

## Core Platform Subpages

### Benchmarks & Empirical Proof
- [Live Benchmark Inspector](https://curtly.dev/benchmark): Interactive 12-task real-world workload suite, 5-family tokenizer matrix, 3-way OpenCode agent runs, and 2,283 standardized academic accuracy evaluations (HumanEval 89.0%, MBPP 82.3%, GSM8k 94.5%, SWE-bench Lite 32.7%, TypeScript AST 100.0%).
- [Dual-Stage Token Economics](https://curtly.dev/features/dual-stage-optimization): Comprehensive breakdown of why output tokens cost 3.5x to 5x more than input tokens, and how output savings account for 54.8% (single turn) to 85.7% (5-turn agent loop) of total dollar savings.
- [Benchmark Inspector Feature](https://curtly.dev/features/benchmark-inspector): Technical deep-dive into the live verification harness and test assertions.

### Interactive Financial ROI Calculators
- [Global Token ROI Calculator](https://curtly.dev/calculator): Real-time interactive financial savings simulator across 13 frontier models.
- [Claude Fable 5.1 ROI](https://curtly.dev/calculator/fable-5-1): Token compression analysis and cost modeling for Anthropic Claude Fable 5.1.
- [GPT 6 Astra ROI](https://curtly.dev/calculator/gpt-6-astra): Token compression analysis and cost modeling for OpenAI GPT 6 Astra.
- [Claude Opus 5 ROI](https://curtly.dev/calculator/opus-5): Token compression analysis and cost modeling for Anthropic Claude Opus 5.
- [DeepSeek R1 ROI](https://curtly.dev/calculator/deepseek-r1): Reasoning token compression analysis and cost modeling for DeepSeek R1.
- [Kimi K3 ROI](https://curtly.dev/calculator/kimi-k3): Token compression analysis and cost modeling for Moonshot AI Kimi K3.
- [GLM-5.3 ROI](https://curtly.dev/calculator/glm-5-3): Token compression analysis and cost modeling for Zhipu AI GLM-5.3.
- [Qwen 3.8 Max ROI](https://curtly.dev/calculator/qwen-3-8-max): Token compression analysis and cost modeling for Alibaba Qwen 3.8 Max.
- [Claude Mythos Preview ROI](https://curtly.dev/calculator/mythos-preview): Token compression analysis and cost modeling for Anthropic Claude Mythos Preview.
- [GPT-5.6 Sol ROI](https://curtly.dev/calculator/gpt-5-6-sol): Token compression analysis and cost modeling for OpenAI GPT-5.6 Sol.
- [Hunyuan Frontier ROI](https://curtly.dev/calculator/hunyuan-frontier): Token compression analysis and cost modeling for Tencent Hunyuan Frontier.
- [Muse Spark 1.3 ROI](https://curtly.dev/calculator/muse-spark-1-3): Token compression analysis and cost modeling for Meta Muse Spark 1.3.
- [GPT-5.6 Terra ROI](https://curtly.dev/calculator/gpt-5-6-terra): Token compression analysis and cost modeling for OpenAI GPT-5.6 Terra.
- [GPT-5.6 Luna ROI](https://curtly.dev/calculator/gpt-5-6-luna): Token compression analysis and cost modeling for OpenAI GPT-5.6 Luna.

### Feature Deep-Dives
- [Input Prompt Compression](https://curtly.dev/features/input-prompt-compression): In-memory AST comment pruner, RAG deduplication, and conversational filler stripping.
- [Output Efficiency Injection](https://curtly.dev/features/output-efficiency-injection): Output Brevity Governor cutting verbose greetings, apologies, and duplicate summaries.
- [Safe Vault AST Engine](https://curtly.dev/features/safe-vault): Abstract Syntax Tree isolation guaranteeing 0.00% syntax distortion on code, JSON, and SQL.
- [Zero Syntax Corruption](https://curtly.dev/features/zero-syntax-corruption): AST guarantees and verification tests ensuring valid compilation on all languages.
- [Architecture Comparison](https://curtly.dev/features/architecture-comparison): Comparison with naive regex compressors, vector store embeddings, and raw proxies.
- [Latency Governor](https://curtly.dev/features/latency-governor): Deterministic in-memory execution delivering 1.8ms - 5.3ms latency overhead (P95 <8ms).
- [Multi-Model Tokenizer](https://curtly.dev/features/multi-model-tokenizer): Exact native BPE counting for Claude BPE, o200k_base, DeepSeek BPE, Qwen BPE, and Gemini 256k.
- [ROI Calculator Engine](https://curtly.dev/features/roi-calculator): Formula specification for single-turn and multi-turn cached agent economics.

### Technical Documentation
- [Documentation Hub](https://curtly.dev/docs): Overview of Curtly architecture and integration options.
- [Introduction](https://curtly.dev/docs/introduction): Core system overview, token overhead economics, and pipeline guarantees.
- [Quickstart Guide](https://curtly.dev/docs/quickstart): 2-minute drop-in proxy setup for OpenAI SDK, Claude Code CLI, and OpenCode.
- [Compression Modes](https://curtly.dev/docs/compression-modes): Fast/Algo (deterministic AST), Smart (balanced neural + vault), and Aggressive modes.
- [Safe Vault Architecture](https://curtly.dev/docs/safe-vault): Technical reference on entity tokenization, hex locks, and AST restoration.
- [Compress Endpoint API Reference](https://curtly.dev/docs/compress-endpoint): HTTP request schemas, headers, response format, and error handling.
- [SDK & Framework Integrations](https://curtly.dev/docs/sdk-integrations): Code examples for Node.js, Python, LangChain, LlamaIndex, and Cursor.
- [Security & Compliance](https://curtly.dev/docs/security-compliance): Zero data retention, volatile RAM execution, TLS 1.3, and SHA-256 API key hashing.

### Developer Portals & Legal
- [Developer Console / Dashboard](https://curtly.dev/dashboard): API key provisioning, request telemetry, latency graphs, and token savings metrics.
- [Authentication](https://curtly.dev/login): Secure magic link login.
- [Pricing Plans](https://curtly.dev/#pricing): Free ($0/mo, 500 req), Starter ($19/mo, 25k req), Growth ($29/mo, 100k req), Enterprise ($199/mo, 1M req).
- [Terms of Service](https://curtly.dev/terms): SLA terms and API usage rules.
- [Privacy Policy](https://curtly.dev/privacy): Zero-storage data handling commitments.
- [Refund Policy](https://curtly.dev/refund): 14-day money-back guarantee terms.
- [Full LLM Specification](https://curtly.dev/llms-full.txt): Complete architectural reference and benchmark data sheet.

## System Architecture

```
[ Client App / OpenCode / Claude Code / Cursor / Python SDK ]
                      │
                      ▼ (HTTPS / TLS 1.3)
      [ Curtly In-Memory Optimization Layer ]
                      │
     ┌────────────────┴────────────────┐
     ▼                                 ▼
[ Stage 1: Input Vault ]      [ Stage 2: Output Brevity Governor ]
- Safe Vault AST locks        - Strips verbose greetings
- Comment & license pruner    - Suppresses conversational filler
- ANSI & git diff filter      - Enforces concise execution
- JSON schema minifier        - Cuts output tokens by 35-74%
- Cuts input tokens by 58.2%  (Represents 54.8-85.7% $ savings)
     └────────────────┬────────────────┘
                      │
                      ▼
[ LLM Provider: OpenAI / Anthropic / Groq / DeepSeek / Local ]
```

## Quick Proxy Integration

### Endpoint
`POST https://curtly.dev/api/v1/chat/completions`

### Headers
- `Authorization: Bearer <CURTLY_API_KEY>`
- `X-Curtly-Compress-Input: true`
- `X-Curtly-Mode: smart`

### Python Example
```python
from openai import OpenAI

client = OpenAI(
    base_url="https://curtly.dev/api/v1",
    api_key="your_curtly_api_key"
)

response = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": "Analyze SQL execution plan."}]
)
print(response.choices[0].message.content)
```