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.1.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.1-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: promptolian-2.3.1.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.1.tar.gz
Algorithm Hash digest
SHA256 22e2a8fc3d760b8122c026e829f8ab90edee27d66b5997e2ee1840df371800e1
MD5 0016d6b5ecdeb4ba334d3c8082956907
BLAKE2b-256 8578f8482d834cfbb9d03e817950c60e969dc74b0a0d57ec5aa769593e2da3f9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: promptolian-2.3.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4480057ec27b67273c66acf36d2605bec516a7764aee5afbc6bd1048b80dcb61
MD5 5ddab6238706c9dc7f11468fe7942674
BLAKE2b-256 1b7d1c322baf7f280c827e8a490ea32b4ab300bb4dbde90cd23b524e0ff11042

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