pchi. 2.0 GitHub
A little peach. A big protocol. v2.0

Mathematical
Governance
For Scene State.

PCHI (Peachy) protocol v2.0 introduces PIR mathematical invariants enabling verified scene state management across distributed creative systems. Say goodbye to state drift.

Read the Docs
Open source. Mathematically grounded. Creatively free.
A SHARED STATE OF MINDEverything, in harmony.
↓ A LITTLE FURTHER, A LOT CLEARER
LESS DRIFT. MORE POSSIBILITY.

One language.
Your whole creative stack.

+ beyond
01 / BUILT ON CERTAINTY

Why PCHI 2.0?

Moving from convention-based to
mathematics-based scene management.

01

Mathematical Integrity

Every message carries PIR invariants (Prouhet-Thue-Morse sequence) that mathematically prove the scene is in equilibrium. Disequilibrium is caught instantly before rendering.

Verified, not assumed.
02

Safe AI Integration

AI agents run inside Only-Lang boundaries the conductor enforces on every incoming message. Every rule that fires is signed and hash-chained — export the log and verify it independently, with no need to trust our dashboard or our word for what happened.

Not just enforced. Verifiable.
03

Zero-Drift Sync

The PCHI Conductor maintains a single source of truth for Resolume, TouchDesigner, Ableton, Unreal, TiXL, and cables.gl. All tools receive the same verified state via UDP, WebSocket, TCP, OSC, or HTTP.

Many tools. One truth.
02 / UNDER THE HOOD

How it works.

PCHI standardizes the message format for scene updates, control parameters, and musical contexts. Every message includes its mathematical signature.

  • Standardized Schema

    Common format for objects, parameters, artists, and music.

  • PIR Invariants

    Equilibrium checks, coherence gaps, curvature signatures.

  • Multiple Serializations

    JSON (human-readable) & FlatBuffers (high-performance binary).

  • Only-Lang Governance

    Rule definition DSL to keep generative AI output safe and harmonious.

Read full API Documentation
pchi-v2.0-schema.json
PAYLOAD EXAMPLEJSON
Equilibrium by designε = 10⁻¹²
03 / THE ECOSYSTEM

Projects & Downloads

Explore the tools built on top of
the PCHI 2.0 protocol ecosystem.

Rust

PrimeSwarm Engine (Conductor)

The central state management server. Validates every message with PIR invariants, enforces Only-Lang rules, and broadcasts coherent state to all receivers. Includes a built-in web dashboard.

$ cargo run -p primeswarm-pchi
View Source
JSONFlatBuffers

PCHI Schema Defs

The core protocol schemas, JSON validation configurations, and Rust implementation library with invariant math modules.

Browse JSON Schema Browse FlatBuffers
Python / OSC

Resolume PCHI Bridge

Connects Resolume Arena to the PCHI Conductor via OSC. Converts standard OSC to PCHI with calculated PIR invariants (equilibrium, coherence gap) and handles real-time visual streaming constraints.

python resolume_pchi_bridge.py
--resolume-port 7000 --pchi-port 8888
Browse Bridge Source
Max for Live

Ableton PCHI Max

A Max for Live device that monitors Ableton's musical state (BPM, beat, clips, kick/snare detection). Calculates equilibrium from the musical state and routes messages directly to the conductor.

Host: 127.0.0.1Port: 8888LOCAL CONNECTION
Browse Max Device Files
Python / TD

TouchDesigner CHOP

A custom Python CHOP that connects to the PCHI Conductor via UDP. Receives PCHI messages and outputs scene state, musical context, and PIR equilibrium status directly as CHOP channels.

import json
# Extracts objects & beats as channels
Browse CHOP Source
Python / OSC

TiXL PCHI Bridge

Connects TiXL's real-time motion graphics engine to the PCHI Conductor over OSC — a fixed /pchi/control address in, live governance verdicts back out as /pchi/governance/gate_state.

python tixl_pchi_bridge.py
--osc-in-port 9001 --pchi-port 8888
Browse Bridge Source
C# / .NET

TiXL Native Operators

Two real TiXL operators — one sends control parameters, one receives governance verdicts — compiled clean against TiXL's actual Core.dll, no bridge process required. Compiled; not yet run inside a live TiXL editor session.

$ dotnet build Pchi.csproj
Browse Operator Source
Python / HTTP + WS

cables.gl PCHI Relay

Bridges cables.gl's browser-sandboxed patches to the Conductor: a CORS-handled HTTP POST carries control updates in, a plain WebSocket — the same shape cables' own WebSocket op already speaks — carries governance verdicts out.

python cables_pchi_relay.py
--http-port 9100 --ws-port 9101
Browse Relay Source

ⓘ Schemas and integrations open in the PCHI repository. Select a file on GitHub to view or download its source.

04 / WHO THIS IS FOR

Three ways to use it.

Same protocol, same signed log —
different reason to care.

01

Production companies & venues

Run the conductor yourself, free, self-hosted. Write Only-Lang rules for your own safety limits — strobe intensity, animation speed, whatever your show needs — and get a signed record of every time one fired, without paying anyone for it.

Direct. Self-hosted. Free.
02

Show-control tool vendors

The Resolume, TouchDesigner, Ableton, TiXL, and cables.gl bridges are a small, self-contained surface — OSC/CHOP/Max/HTTP in, PCHI out. Ship one natively, the way TiXL's C# operators do against real compiled source, rather than making every customer run a separate bridge process.

Embed it. Low integration cost.
03

Insurers & safety auditors

An insurer underwriting an AI-driven show doesn't want the venue's word that safety limits held — they want to check it themselves. GET /governance/export plus the offline verifier script re-derives every signed decision independently, no trust in the venue's dashboard required.

Verify it yourself. We built the tool for it.
CREATIVITY, WITHOUT THE CHAOS

A shared state.
A world of possibilities.

Your tools. Your ideas. All on the same wavelength.

pchi.