Skip to main content
Documentation
Features

Compression

Laghav strips filler words, preambles, duplicate lines, and verbose code comments using 8 specialized rules — reducing token usage by an average of 61% without sacrificing response quality.

The 8 compression rules

Rule nameWhat it stripsAvg saving
fillerPoliteness hedges ('Hey I wanted to ask you...', 'Could you possibly...')10–20%
preambleVerbose intro sentences before the actual question8–15%
dedupRepeated identical or near-identical sentences5–30%
intentRedundant explanation of what the user wants5–12%
whitespaceExtra blank lines, trailing spaces, redundant newlines2–8%
log_slicerINFO/DEBUG log spam — keeps only ERROR, WARN + 2-line context70–98%
code_commentJSDoc, Python docstrings, inline comments (preserves signatures & logic)15–40%
json_slimRedundant JSON keys, default null values, empty arrays20–50%

Aggressiveness control

The max_aggressiveness parameter (0.0–1.0) controls how aggressively rules apply. Higher values save more tokens but may reduce quality score. The quality scorer always checks the result before sending.

aggressiveness.py
# Light — only strip obvious filler and whitespace (preserves more context)
response = client.complete(
messages=messages,
model="auto",
laghav_options={"max_aggressiveness": 0.2}
)
# Default — balanced compression
response = client.complete(
messages=messages,
model="auto",
laghav_options={"max_aggressiveness": 0.5}
)
# Aggressive — maximum token reduction (good for log analysis, JSON payloads)
response = client.complete(
messages=messages,
model="auto",
laghav_options={"max_aggressiveness": 0.9}
)

Content type hints

Laghav auto-detects content type. You can override with the playground API or via content_type in the playground endpoint:

Content typePreferred rulesUse case
autoAll rules, ranked by signalDefault — Laghav detects type
codecode_comment, whitespace, dedupSource code, function context
loglog_slicer, whitespace, dedupLog files, agent traces
jsonjson_slim, whitespace, dedupAPI payloads, config files
textfiller, preamble, intent, whitespaceNatural language prompts

Skipping specific rules

skip_rules.py
# Skip intent stripping — useful if intent IS the important part
response = client.complete(
messages=messages,
model="auto",
laghav_options={
"skip_rules": ["intent", "preamble"]
}
)

Real example

Before (63 tokens)

Hey I just wanted to ask you if you could possibly help me understand the main causes of the revenue drop that happened last quarter. I think it would be really helpful if you could explain it clearly.

After (24 tokens)

Explain main causes of last quarter's revenue drop.
62% compression94/100 quality
Open source compression core
The 8 compression rules are open source at github.com/laghav-ai/compress (MIT license). Install standalone with pip install laghav-compress for local compression without a Laghav account.