Skip to content

Commit 2c8094d

Browse files
docs(readme): lead with the compounding lede and four-way wedge; refresh numbers
- replace the single-shot-first tagline with the agentic-loop value prop: multi-turn compounding (session dedup + delta -> 99% per response by call 5, 94.4% per 10-call session) that JSON and TOON cannot match, three proof bullets, and the four-way wedge (schema-free + lossless + token-compact + model-readable) - eval count 2,400+ -> 2,500+ (11 models, 4 providers) to match the site - session example: 92.7% -> 86% dedup-alone / 99% stacked with delta, reconciled to the sessions.md savings table
1 parent 2a4d99d commit 2c8094d

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,13 @@
1111

1212
Python implementation of [GCF](https://gcformat.com/) — the most token-efficient wire format for LLMs. A drop-in alternative to JSON and TOON for any structured data.
1313

14-
**100% comprehension on every frontier model tested. 29% fewer tokens than TOON, 56% fewer than JSON across 16 datasets. 91.2% on structurally complex code graphs (vs TOON 68.8%, JSON 54.1%). 2,400+ LLM evaluations. Zero training.**
14+
**Built for the agentic loop, where the same structured context crosses the model boundary turn after turn.** A single payload is 50-92% smaller than JSON, but GCF also deduplicates repeated structure across turns and sends only deltas when context changes, so by the 5th overlapping call each response costs 99% fewer tokens than JSON, and a 10-call session runs 94.4% cheaper than re-sending JSON every turn. Session dedup and delta both need local IDs and a multi-turn design that neither JSON nor TOON has.
15+
16+
- **100% comprehension on every frontier model**, zero training. 29% fewer tokens than TOON and 56% fewer than JSON across 16 datasets; 91.2% on structurally complex code graphs (vs TOON 68.8%, JSON 54.1%).
17+
- **Proven lossless** across 43,000,000,000+ round-trips in 5 formats and 6 languages. Zero runtime dependencies.
18+
- **One format, four properties no other single format holds at once:** schema-free, lossless, token-compact (50-92% vs JSON), and model-readable with zero training. JSON is verbose, Protobuf needs a schema, MessagePack is binary, and TOON isn't reliably lossless.
19+
20+
2,500+ LLM evaluations. [Full benchmarks](https://gcformat.com/guide/benchmarks.html).
1521

1622
Docs: [gcformat.com](https://gcformat.com/) · [Playground](https://gcformat.com/playground.html) · [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
1723

@@ -84,7 +90,7 @@ out1 = encode_with_session(payload1, sess) # full declarations
8490
out2 = encode_with_session(payload2, sess) # reused symbols as "@N # previously transmitted"
8591
```
8692

87-
By the 5th call in a session: 92.7% token savings vs JSON.
93+
By the 5th call in a session: 86% fewer tokens than JSON from dedup alone, 99% stacked with delta encoding.
8894

8995
## Streaming Encode
9096

@@ -229,7 +235,7 @@ for snapshot in stream: # each turn's current GenericSet
229235

230236
## Benchmarks
231237

232-
2,400+ LLM evaluations across 10 models, 3 providers, and 51 independent test runs.
238+
2,500+ LLM evaluations across 11 models, 4 providers, and 50+ independent test runs.
233239

234240
| | GCF | TOON | JSON |
235241
|---|---|---|---|

0 commit comments

Comments
 (0)