TOON Format for Python

Token-Oriented Object Notation is a compact, human-readable format designed for passing structured data to Large Language Models with significantly reduced token usage.

Status

🚧 This package is currently a namespace reservation. Full implementation coming soon!

Example

JSON (verbose):

{
  "users": [
    { "id": 1, "name": "Alice", "role": "admin" },
    { "id": 2, "name": "Bob", "role": "user" }
  ]
}

TOON (compact):

users[2]{id,name,role}:
  1,Alice,admin
  2,Bob,user

Resources

• TOON Specification
• Main Repository
• Benchmarks & Performance
• Other Language Implementations

Future Usage

Once implemented, the package will provide:

from toon_format import encode, decode

data = # your data structure
toon_string = encode(data)
decoded = decode(toon_string)

Contributing

Interested in implementing TOON for Python? Check out the specification and feel free to contribute!

License

MIT License © 2025-PRESENT Johann Schopplich