콘텐츠로 이동
Search

TOON

lastmod 2026-11-16created 2025-11-192 edits

TOON(Token-Oriented Object Notation)은 Johann Schopplich가 시작한, JSON 데이터 모델을 더 적은 토큰으로 표현하는 직렬화 포맷이다. 중첩 객체는 YAML 처럼 들여쓰기로, 필드가 같은 객체 묶음은 CSV 처럼 헤더 한 줄과 행으로 적는다. 프로그램 안에서는 JSON 을 그대로 쓰고 LLM 프롬프트에 넣을 때만 TOON 으로 바꾸는 변환 계층으로 쓰라고 설명한다.

About

  • JSON 의 객체·배열·원시값을 그대로 담고, 인코딩·디코딩을 왕복해도 손실이 없음
  • 값의 모양에 따라 네 가지 형태 중 하나로 자동 출력. 원시값 배열은 한 줄(alerts[2]: frost,wind), 균일한 객체 배열은 표(items[3]{id,name}: 뒤에 행), ID 별 객체 맵은 키가 붙은 표([2:]), 나머지는 - 목록
  • [N] 으로 행 수, {fields} 로 열 구성을 밝혀 두어 잘리거나 행이 빠진 데이터를 모델이 알아챌 수 있음
  • 저장소 벤치마크(4개 모델, 질문 244개)에서 정확도 72.2%로 JSON(71.4%)과 비슷하면서 토큰은 42.6% 적음. 구조 검증 문제는 TOON 100%, JSON 50%
  • 깊게 중첩되거나 균일하지 않은 데이터는 압축 JSON 이 더 작을 수 있고, 완전한 표 데이터는 CSV 가 5~10% 더 작음. 로컬·양자화 모델에서는 JSON 이 더 빨리 처리되기도 하니 직접 재 보라고 적어 둠
  • CLI npx @toon-format/cli 로 JSON↔TOON 변환. 확장자로 방향을 정하고, 구분자(쉼표·탭·파이프) 선택과 --stats 토큰 절감 통계 지원
  • TypeScript 패키지 @toon-format/toon 의 encode()/decode() 가 기준 구현. 다른 언어 구현은 공통 스펙(v4.4)과 적합성 테스트를 따름
  • 확장자 .toon, 임시 미디어 타입 text/toon
  • MIT 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap