cendor-squeeze

Shrink verbose context — JSON, logs, code, prose — without throwing anything away. Compression returns a handle; the original is always restorable. Content-aware: each type gets a purpose-built, deterministic compressor — no LLM, no model download, byte-reproducible.

Up to ~99% smaller on repetition-heavy logs (~50% on structured data), 100% reversible — zero dependencies, deterministic output.

PyPI license · pip install cendor-squeeze

from cendor.squeeze import compress

small, handle = compress(huge_json, kind="auto")                 # detect + route
small, handle = compress(source_code, kind="code", fidelity="aggressive")
small, handle = compress(logs, kind="logs", target_tokens=400)   # compress to a budget
original = handle.expand()                                        # restore, byte-for-byte

Highlights

  • Four purpose-built compressors — JSON (minify + drop nulls; budget-shrink drops keys/elements structurally, staying valid JSON), logs (normalize timestamps/UUIDs/IPs/hex/integers + dedup repeats into (×N), chronological), code (strip comments — string-aware, so a // or # inside a literal stays put; keeps preprocessor & shebang), prose (extractive, abbreviation-aware sentence splitting). detect() auto-routes.
  • Compress to a budget — target_tokens is never exceeded; fidelity="lossless" | "balanced" | "aggressive". No LLM, no download, byte-reproducible.
  • 100% reversible — a content-addressed store (deduped by hash) keeps every original; handle.expand() restores it byte-for-byte no matter how hard you squeeze.
  • Survives restarts — handle.to_dict() / Handle.from_dict() next to a durable squeeze.store.SQLiteStore; or a bounded MemoryStore(max_items=…) via use_store(...).
  • The deterministic default, swappable — wired through core's Compressor protocol (not a hard import), so contextkit.use_compressor(...) can replace it globally with any backend (even a heavier ML compressor). squeeze stays the pick for reproducible, offline, audit-friendly output.

Inbound — usually contextkit calls it for you (Block(evict="compress")). Ratios are content-dependent (logs compress most, structured JSON least) — see the benchmarks.

See docs/squeeze.md · CHANGELOG. Part of the Cendor stack — github.com/cendorhq/cendor-libs. Powered by PowerAI Labs. Apache-2.0; provided "as is", without warranty — use at your own risk (LICENSE §7–8).

Project links

Data verified by PyPI on Jul 10, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for powerailabs from gravatar.com powerailabs

Credits

Author: Raghav Mishra (PowerAI Labs)

GitHub Statistics

Data verified by PyPI on Jul 10, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.11

Tags

agents ai compression context llm prompt tokens

Classifiers

Report project as malware

Download files

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

Source Distribution

cendor_squeeze-1.0.3.tar.gz (22.9 kB view details)

Uploaded Source

Built Distribution

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

cendor_squeeze-1.0.3-py3-none-any.whl (18.9 kB view details)

Uploaded Python 3

File details

Details for the file cendor_squeeze-1.0.3.tar.gz.

File metadata

  • Download URL: cendor_squeeze-1.0.3.tar.gz
  • Upload date:
  • Size: 22.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for cendor_squeeze-1.0.3.tar.gz
Algorithm Hash digest
SHA256 6b040e03cc3e89f6b0198017b5da375375b7e56bce17738d31a2962c15709205
MD5 a55ab301dffaddf770ed3b203cce4098
BLAKE2b-256 50d79584a8109cf7fb26b0ee1373bfd476fe59126593b70bfc90c84275101dfa

See more details on using hashes here.

Provenance

The following attestation bundles were made for cendor_squeeze-1.0.3.tar.gz:

Publisher: release.yml on cendorhq/cendor-libs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cendor_squeeze-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: cendor_squeeze-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 18.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for cendor_squeeze-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ebca34e679cc3de6320a262eae65c6d1565d325ddf4456525732733d93e7816e
MD5 c10fa098e7cfc4cf0303aef5256fcf20
BLAKE2b-256 e99503613e0b5bea9c96836a2fcb38ee00e4aced71d1192e6a2a86503a7e64cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for cendor_squeeze-1.0.3-py3-none-any.whl:

Publisher: release.yml on cendorhq/cendor-libs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

This release

1.0.3 This release

2 files

1.0.2

2 files

1.0.1

2 files

Supported by

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