Shion Runtime

A local-first companion agent runtime with a PWA frontend, structured replies, persistent state, background context, and observable traces.

Project Brief

For a presentation-ready technical overview, open the full project brief. It explains the idea, research hypotheses, academic context, engineering implementation, test results, and roadmap.

What It Does

Unified RuntimeFrontends normalize input into events, then share one core state and response path.
Structured RepliesResponses become Message DSL, expression state, actions, and traceable metadata.
Local-First BoundaryPrivate memories, logs, credentials, and deployment state stay out of the public repo.

Start

cd shion-runtime, npm install, copy .env.example to .env.local, then run npm run dev.

Read the README, architecture notes, and privacy boundary.