TokenPak

Open source

TokenPak is open source.

The proxy, Prompt Packing engine, client integrations, local dashboard, Savings Ledger, and Spend Guard are Apache 2.0 licensed and run entirely on your machine. This page lists what ships today; anything not yet verified is labeled as such.

Install

pip bash
python -m pip install tokenpak
tokenpak setup --start

The setup wizard detects optional provider API keys, asks which compression profile to use, and writes your configuration. With --start it also starts the proxy on 127.0.0.1:8766 (the default port); without it, run tokenpak start later.

What's in the open-source core

Context tools and request records

Explicit compression operations can reduce eligible content. The built-in Pak builder preserves conversation turns; byte-preserved routes report zero product-attributed reduction.

Local proxy, no cloud

Runs at 127.0.0.1. Byte-preserved passthrough; your prompts and credentials stay in your environment and the provider flow you already use.

Client integrations

Tested SDK adapters: OpenAI SDK, Anthropic SDK and LiteLLM. First-class integrations: Claude Code and Codex. Compatibility targets (not yet independently verified): Cursor, Cline, Continue and Aider.

Savings Ledger + Spend Guard

Local telemetry store, A/B replay, 57 built-in compression recipes, semantic vault indexing, and Spend Guard, a pre-send circuit breaker that holds a request before it reaches the provider when it would exceed a limit. By default the limit is the model's context window; dollar and rolling caps are opt-in.

What ships today

Inventory of the open-source features in the current release.

Feature Status
Explicit context tools; conversation history preserved by default Shipped
Local proxy at 127.0.0.1 Shipped
Tested SDK adapters: OpenAI SDK, Anthropic SDK, LiteLLM Shipped
First-class integrations: Claude Code and Codex Shipped
Client integrations — compatibility targets: Cursor, Cline, Continue, Aider Unverified
Routing policy configuration and observe-mode records Shipped; enforcement not active by default
Savings Ledger + local telemetry Shipped
Vault indexing + semantic search Shipped
Local dashboard (TUI + web) Shipped
A/B testing + request replay Shipped
57 built-in compression recipes Shipped
Spend Guard — pre-send circuit breaker (context-window limits on by default; dollar and rolling caps opt-in) Shipped
TIP-1.0 protocol contracts + conformance gate Shipped
Pak recall data plane (storage, FTS, inspect) Shipped
PAKPlan preview / explain / report (read-only) Shipped

Source + package

Ready to try it?

tokenpak runs entirely on your machine. Nothing to sign up for.