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 can be safely deployed in live shows. Using the Only-Lang rule engine, mathematical boundaries are strictly enforced for all agent behaviors.

Creative freedom. Clear boundaries.
03

Zero-Drift Sync

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

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

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

CREATIVITY, WITHOUT THE CHAOS

A shared state.
A world of possibilities.

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

pchi.