Entroly is an Apache-2.0, local-first context layer that selects evidence within a token budget before an agent’s request leaves the machine, records every omission in a receipt, and recovers the exact original bytes from a content-addressed store on demand.
Entroly is the first member of this category whose product is the audit rather than the compression: the savings are modest and self-run, but every drop is receipted, byte-exact recoverable, and verifiable offline with one command, which is a guarantee none of the bigger compressors here offers.
What it is #
A Python package (pip install entroly) carrying the full surface (CLI, SDK, localhost proxy, MCP server, dashboard), plus a Node/WASM CLI on npm, a Rust binary, a Homebrew tap, and a Docker image, all published at the same version and smoke-tested by the release workflow, by a solo maintainer (juyterman1000).
Selection is budgeted and query-conditioned: compress, compress_messages, and optimize return smaller payloads whose omitted spans get content hashes, and entroly recover sha256:... restores any of them exactly.
Delivery is wherever the request already flows: a proxy on localhost:9377 you point ANTHROPIC_BASE_URL or OPENAI_BASE_URL at, an MCP server, a reversible prompt hook for Claude Code, Codex, Cursor, Kiro, Gemini CLI, and VS Code plus a native OpenClaw context-engine plugin, and SDK calls in your own prompt assembly.
A runaway-session rescue compacts bulky tool output in flight while keeping the prompt prefix byte-stable so the provider’s warm cache survives.
Two offline commands are the trust surface: entroly verify-claims runs twelve local checks with no API key, and entroly simulate measures selection on your own repo before you connect a paid key.
Status #
Young, active, and barely discovered: 476 stars as of 2026-10-18, 74 forks, created 2026-03-07, pushed 2026-11-01, PyPI and npm both at 1.0.88 across 106 releases, as of 2026-11-01 (GitHub, PyPI, and npm APIs). October 2026 development around the 1.0.87 release added a session journal of what a session did, returned on resume, source-bound cross-agent review in the work CLI, opt-in paired Decisions choice trials, and a rustls advisory fix. Release 1.0.88 (2026-11-01) shipped the PAC-KV cache-aligned compression (provider page-grid quantization, an economic break-even gate, paged Merkle trees, attention-aware tail compression), the receipt-backed graph memory with hybrid retrieval that main had carried unreleased, and frontier codecs, alongside 62 customer-visible dogfood fixes, an activation report naming a degraded hook’s cause, and the scaffold of an opt-in action gate.
Adoption is near zero for now: about 1,455 PyPI downloads in the trailing month (PyPIstats, unchanged when re-fetched 2026-11-01) and 652 npm downloads summed for 2026-10-02 to 2026-10-31 (nine zero days in the window), and a Hacker News search returns no story about the product (re-checked 2026-11-01, every hit unrelated entropy content).
Its one external listing is the Awesome-Context-Engineering survey’s Context Optimization Engines section, the same list that surfaced LLMLingua here.
The missing community footprint is itself the finding to weigh: at this size the project is one person’s bet with no independent signal in either direction.
Strengths #
- The receipt model answers LLMLingua’s worst property and Headroom’s open question at once: nothing is silently dropped, recovery is byte-exact (the README ships 13-of-13 public SDK recovery probes and a 5,117-of-5,117 source-span fidelity check as repository artifacts), and
entroly verify-claimsproves the installed path works without an API key. - The honesty markers are above the field’s baseline: the README’s own benchmark table shows the SQuAD 2.0 regression (80 to 72 percent) in bold, marks GSM8K as pass-through rather than a win, and prints Wilson confidence intervals with reproduction scripts.
- The proxy’s session rescue keeps the prompt prefix byte-stable during in-flight compaction, which protects provider prompt-cache pricing, a detail most compression layers ignore because it never shows in a benchmark.
- Activation is checkable:
entroly activation status --jsonreports whether a host hook actually ran, and MCP-only integrations are labeled advisory because the model can skip them.
Cautions #
- Every performance number is self-run at hobby scale: the README table runs 20 to 50 samples per row on gpt-4o-mini, a toy next to the multi-thousand-run tables Sourcegraph and Augment publish, and the vendor’s own docs say savings exist only “when requests traverse an Entroly-controlled route”.
- No independent evaluation, no practitioner threads, and four-digit monthly downloads mean the tool has never been fight-tested outside its author’s benchmarks, as of 2026-10-12.
- The native engine is a separate install with runtime repair off by default; without it, query-conditioned selection is unavailable and the README labels reduction figures “unearned”, so the out-of-box experience can be much weaker than the tables.
- Solo human maintainer (2,089 of 2,141 contributions), 104 releases in seven months, and a 20-topic keyword spread on the repository all say the bus factor and the focus are unproven.
Pricing #
Free and open source under Apache-2.0; there is no paid tier, so pricing does not apply. The costs are your own machine for the selection pass and the tokens you fail to save.
Compared to #
- Headroom: the closest sibling, also a local multi-channel compressor with a retrieve path; Headroom ships more surfaces and bigger claimed savings, Entroly ships receipts, byte-exact recovery, and the verification commands.
- LLMLingua: the peer-reviewed ancestor whose deletions are permanent; Entroly’s selection is the reversible counter-design, with almost none of its evidence base.
- rtk: compresses the shell-output channel per command; Entroly sits at the request boundary across all channels and adds the audit layer.
Bottom line #
Recommended for teams on metered provider bills who want compression they can audit, starting with entroly simulate on their own repo and treating every published percentage as a hypothesis at n=20.
Not for anyone who needs an independently validated tool, a supported product, or the largest claimed savings, because none of those exist here yet.
My disagreeable claim: this category’s arms race measures the wrong thing, and a smaller saving a buyer can prove beats a bigger saving nobody can check, which would make receipts, not ratios, the feature the next generation of compressors copies.
Changes #
- 2026-10-12 - Created from the 2026-10-12 Meirtz/Awesome-Context-Engineering entrant scan (the list’s Entroly entry under Context Optimization Engines), with the zero-community-footprint finding and the small-n self-run-benchmark caveat recorded as the critical angle.
- 2026-10-18 - Recorded the October 2026 additions around the 1.0.87 release (session journal returned on resume, source-bound cross-agent review in the work CLI, opt-in paired Decisions choice trials, a rustls advisory fix) and refreshed the adoption figures.
- 2026-10-26 - Full rotation re-verification: every cited URL re-fetched (repo and README, BENCHMARKS.md, PyPI, npm registry and downloads, PyPIstats, the HN search, and the VS Code marketplace listing all intact); recorded main’s post-1.0.87 PAC-KV cache-aligned compression and receipt-backed MemoryGraph work with three new FastMCP tools, unreleased as of 2026-10-26, and refreshed the npm figure (681 in the month to 2026-10-22, was 724 to 2026-10-16).
- 2026-11-01 - Full rotation re-verification: every cited URL re-fetched and intact (the README and BENCHMARKS.md claims hold, the VS Code listing, the HN search, PyPIstats unchanged); recorded release 1.0.88 (2026-11-01, PyPI and npm synchronized) shipping the PAC-KV compression, the receipt-backed graph memory, and frontier codecs that main had carried unreleased, plus 62 dogfood fixes and an action-gate scaffold; recorded the README’s new Gemini CLI and OpenClaw hook surfaces; refreshed the npm figure (652 for 2026-10-02 to 2026-10-31, was 681 to 2026-10-22).
See also #
- Headroom - the bigger, better-known compression sibling Entroly adds the audit layer to
- LLMLingua - the destructive-pruning ancestor whose failure mode the receipts answer
- rtk - the output-channel filter in the same token-bill fight
- Context Engines Feature Matrix - the category comparison this note joins as the nineteenth column
References #
https://api.github.com/repos/juyterman1000/entroly - stars, forks, created and pushed dates, Apache-2.0 license, and topics as of 2026-11-01
https://raw.githubusercontent.com/juyterman1000/entroly/main/README.md - mechanism, install surfaces, receipt and recovery model, the README benchmark table with the disclosed SQuAD regression, and the activation-status honesty notes (re-fetched 200, 2026-11-01)
https://raw.githubusercontent.com/juyterman1000/entroly/main/docs/BENCHMARKS.md - full benchmark protocols, sample sizes, the 24/24 versus 18/24 model-recovery holdout, and the WITNESS hallucination-detection numbers (re-fetched 200, 2026-11-01)
https://pypi.org/pypi/entroly/json - version 1.0.88 and the 106-release train (re-fetched 2026-11-01)
https://registry.npmjs.org/entroly - the npm distribution at 1.0.88 (re-fetched 2026-11-01)
https://api.npmjs.org/downloads/range/2026-10-02:2026-10-31/entroly - 652 downloads summed for 2026-10-02 to 2026-10-31, nine zero days in the window (fetched 2026-11-01)
https://pypistats.org/api/packages/entroly/recent - 1,455 downloads in the trailing month, unchanged when re-fetched 2026-11-01
https://hn.algolia.com/api/v1/search?query=entroly&hitsPerPage=5 - the footprint check: no story about the product, all hits unrelated (re-fetched 2026-11-01)
https://marketplace.visualstudio.com/items?itemName=entroly.entroly-vscode - the VS Code extension surface (re-fetched 200, 2026-11-01)
https://github.com/Meirtz/Awesome-Context-Engineering - the entrant source: Entroly listed under Context Optimization Engines (repository and README fetched via the GitHub API, 2026-10-12; source re-scanned 2026-11-01, no commits since 2026-10-31, so the scan carried over)