ucs-parser

Reference parser for the Universal Cognitive Schema (UCS) — the open standard for portable AI identity across platforms.

What is UCS?

UCS is an open standard for representing a person's accumulated AI interaction profile in a portable, platform-agnostic format. It lets you move your cognitive identity — preferences, expertise, interaction patterns, projects — between AI platforms without starting from zero every time.

Installation

pip install ucs-parser

For full JSON Schema validation:

pip install "ucs-parser[validate]"

Quickstart

Parse a ChatGPT export

from ucs_parser import Parser

parser = Parser(source="chatgpt")
profile = parser.from_file("chatgpt_export.zip")  # or conversations.json

# Write to file
profile.to_json("my_profile.ucs.json")

# Validate against the UCS schema
profile.validate()

# See per-dimension fidelity scores
print(profile.fidelity_report())

CLI

ucs parse chatgpt_export.zip --output my_profile.ucs.json
ucs validate my_profile.ucs.json
ucs fidelity my_profile.ucs.json

What gets inferred

From a ChatGPT conversations.json export, the parser automatically infers:

Fidelity report

Every parsed profile includes an honest fidelity report:

Fidelity Report (generated 2026-04-16 13:00 UTC)
  Overall:              0.72  Good overall fidelity with some gaps.
  Persona               ██████████  0.91  High confidence — inferred from 2,847 interactions.
  Expertise map         ████████░░  0.78  Good — 14 domains identified.
  Project graph         ██████░░░░  0.65  Moderate — some projects lacked structured context.
  Preference corpus     █████████░  0.88  High — strong signal from format corrections.
  Interaction patterns  ████████░░  0.83  Good — consistent correction patterns detected.
  Trust boundaries      █████░░░░░  0.52  Low — insufficient explicit delegation signal.
  Temporal context      ███████░░░  0.72  Good — life chapters inferred from topic shifts.

Security

All profiles are sanitised by default. The sanitiser strips prompt-injection patterns, role-override syntax, and executable instructions before any content is written to a profile. The provenance.sanitised field attests to this.

Roadmap

• v0.1.0 — ChatGPT parser ✅
• v0.2.0 — Claude + Gemini parsers
• v0.3.0 — Injection library (UCS → system prompt for major platforms)
• v0.4.0 — Standalone fidelity scoring engine
• v0.5.0 — Delta sync protocol
• v1.0.0 — Stable schema + IETF Internet-Draft

Links

• GitHub Repository
• Schema Specification
• Contributing

License

MIT — schema additionally released under CC0 1.0