Skip to main content

Drop-in SDK for Anthropic & OpenAI — compresses prompts transparently. CLI + REST API + Claude Code MCP.

Project description

Promptolian — Context Reliability Proxy for AI Agents

Proxy layer for AI agents — keeps context intact across long conversations and eliminates redundant token costs. One line to add, zero changes to your agent logic.

promptolian.com · Pricing · Dashboard · Docs


Install

pip install promptolian            # core (rule-based, no deps)
pip install "promptolian[proxy]"   # + transparent API proxy
pip install "promptolian[nlp]"     # + NLP compression (spacy)
pip install "promptolian[mcp]"     # + Claude Code MCP tool
pip install "promptolian[full]"    # everything

Quick Start

# Start transparent proxy at http://localhost:3002
python -m promptolian.proxy
# or with context history compression:
python -m promptolian.proxy --compress

Point your Anthropic or OpenAI client at http://localhost:3002 — no other changes needed.


Context Engine

KV-sandwich architecture — preserves what matters, compresses what doesn't:

  • HEAD (first 2 turns): verbatim — session framing preserved
  • MIDDLE: entity-encoded + compressed — redundant tokens removed
  • TAIL (last 4 turns): verbatim — recent facts + task state intact

Benchmark results (25 sessions, Factory.ai 6-dimension scoring):

Promptolian Anthropic built-in OpenAI built-in
Quality score 4.26 / 5 3.44 / 5 3.35 / 5
Compression 21.8% 98.7% 99.3%

Tool Schema Caching

The proxy adds cache_control to tool schemas and re-injects them on subsequent calls. Anthropic bills cached tokens at 10%.

Without proxy: 500 calls/day × 5 tools × 120 tok × 30 days = 9M tok/mo → $27.00
With proxy:    9M tok × 10% cache rate                       = 900K tok/mo → $2.70

Plans

Plan Price Sessions Keys
Free $0 SQLite · self-hosted
Solo $9/mo PostgreSQL · always-on 1
Team $49/mo PostgreSQL · always-on Up to 10

promptolian.com/pricing.html

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

promptolian-2.3.2.tar.gz (35.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

promptolian-2.3.2-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

File details

Details for the file promptolian-2.3.2.tar.gz.

File metadata

  • Download URL: promptolian-2.3.2.tar.gz
  • Upload date:
  • Size: 35.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for promptolian-2.3.2.tar.gz
Algorithm Hash digest
SHA256 eb5320bd17ad4cd9ccd9a4b9804099dc55968e6ca4f09fe53352d1b843ef74f3
MD5 3d109f367e944c57b78be75681d27d29
BLAKE2b-256 0fc4423a2d610dacc3778ebd0c47ba760a3ab73d4a17c982c426fcb95b3e574a

See more details on using hashes here.

File details

Details for the file promptolian-2.3.2-py3-none-any.whl.

File metadata

  • Download URL: promptolian-2.3.2-py3-none-any.whl
  • Upload date:
  • Size: 29.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for promptolian-2.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 208350a02b480aac3ef6f2cacdaa375693e7810c5aba1d5b0045c8cf16b9038a
MD5 67963127049ef0cd00ad4e62fa81d593
BLAKE2b-256 6e15220c56d79cd216141719050fdd2d0afddfa7650b174aaabca6ec52024c45

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page