Skip to main content

Drop-in Context Assurance for AI agents: reduce avoidable token usage and AI cost with evidence selection, receipts, exact recovery, and verification.

Project description

Entroly

Entroly — Context Assurance That Helps Lower AI Costs

Use less unnecessary AI context without rebuilding how you work.
Entroly selects useful evidence, removes avoidable repetition, keeps important originals recoverable, and records what your AI received.

Entroly is a local-first Context Assurance layer for developers, teams, and AI applications. It works through supported proxy, wrapper, plugin, SDK, and MCP paths with Claude Code, Codex, OpenClaw, Hermes Agent, OpenCode, GitHub Copilot, Cursor, Aider, local models, and OpenAI/Anthropic-compatible applications.

A small one-time setup is required; no agent-architecture rewrite.

What Entroly does

AI applications often send repeated files, long histories, logs, and low-value material to a model. Entroly can:

  • select useful evidence under an explicit budget;
  • remove duplicate or low-value context;
  • preserve omitted originals through content-addressed recovery handles;
  • create Context Receipts showing what was included, omitted, and risky;
  • verify whether output claims are supported by supplied evidence;
  • report provider-observed usage separately from local-only reductions;
  • work across cloud and local models without locking you to one agent runtime.

Savings and quality depend on the workload, provider, model, budget, and integration. Entroly does not promise a universal compression percentage or guaranteed bill reduction.

Install

pip install -U entroly

Check the local path before connecting a paid model:

entroly verify-claims
entroly simulate
entroly value
  • verify-claims checks installation, receipts, recovery, and verification.
  • simulate estimates context reduction locally without making a model call.
  • value separates observed provider-bound usage from local-only reductions.

Connect a supported AI tool

Automatic project setup:

cd /your/repo
entroly go

Examples:

# Claude Code
entroly attach create --client claude --project . --ttl 4h --install

# Codex
entroly attach create --client codex --project . --ttl 4h --install

# OpenClaw
entroly attach create --client openclaw --project . --ttl 4h --install

# Pay-as-you-go API or custom application
entroly proxy

For an MCP client, register the installed entroly command with no arguments:

entroly

Package-runner alternatives:

uvx --from entroly entroly
npx -y entroly-mcp

Claude Code MCP registration:

claude mcp add entroly -- uvx --from entroly entroly

Generic MCP configuration:

{
  "mcpServers": {
    "entroly": {
      "command": "uvx",
      "args": ["--from", "entroly", "entroly"]
    }
  }
}

How it works

Files, documents, history, and tool output
                  ↓
       Entroly Context Assurance
       • rank useful evidence
       • select under budget
       • preserve exact originals
       • create a receipt
       • optionally verify output
                  ↓
        Your existing AI model

Local indexing, selection, receipts, and recovery storage do not require an Entroly cloud service. The selected prompt still goes to the provider configured by your application. No outbound analytics are enabled by default.

Honest cost reporting

Entroly keeps different evidence classes separate:

Path What can be reported
Provider-bound proxy request Observed pre/post input tokens and modeled input-cost avoidance with pricing provenance
SDK, MCP, plugin, or npm operation Local context reduction; $0 claimed when provider delivery is not observable
Fixed-price subscription Context efficiency where supported; the subscription price may not change
Unknown or legacy history Preserved operational history; excluded from savings claims

Modeled provider cost avoidance is not a provider invoice.

Technical capabilities

  • budgeted evidence selection;
  • recoverable compression;
  • Context Receipts and Context Commits;
  • strict ccr:<24-hex> exact-recovery handles;
  • hash-only full-content retrieval with no semantic-query fallback;
  • WITNESS evidence-support verification;
  • pure-Python runtime with optional Rust acceleration;
  • separate Node/WASM runtime;
  • MCP, proxy, CLI, SDK, CI, OpenClaw, Hermes Agent, and OpenCode integrations;
  • local-first operation and fail-open adapter behavior.

WITNESS evaluates support against supplied evidence; it does not establish universal truth.

Everyday users

A future desktop experience, Entroly Simple Mode, is specified for people who do not want to learn about tokens, proxies, MCP, JSON, or agent architecture. It is not shipped yet, and Entroly does not claim a one-click consumer experience today.

Links

mcp-name: io.github.juyterman1000/entroly

Apache-2.0 licensed.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

entroly-1.0.74.tar.gz (7.7 MB view details)

Uploaded Source

Built Distribution

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

entroly-1.0.74-py3-none-any.whl (1.4 MB view details)

Uploaded Python 3

File details

Details for the file entroly-1.0.74.tar.gz.

File metadata

  • Download URL: entroly-1.0.74.tar.gz
  • Upload date:
  • Size: 7.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for entroly-1.0.74.tar.gz
Algorithm Hash digest
SHA256 172bbad004e4740d81e7336345f2127131d77cf59a7f7876d7e76531e046ca3e
MD5 b70f769f396472be73be15137dae0c3e
BLAKE2b-256 7f4c1c7538bd0d370e026c20dce9fe54890b5cbff16594978405d63c6e095972

See more details on using hashes here.

File details

Details for the file entroly-1.0.74-py3-none-any.whl.

File metadata

  • Download URL: entroly-1.0.74-py3-none-any.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for entroly-1.0.74-py3-none-any.whl
Algorithm Hash digest
SHA256 03466eee0bb4e0e1f50ff185c884e04d3e21247dbfae1fc25b203083b4c6cd66
MD5 1a7e9dd1d9ab77dfea09a2e74123fce7
BLAKE2b-256 4f1fe439fc5db9669cdd42ed2763e2e034162f1059c9744ebaa477e18a136879

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