omochi-ui

English · Japanese

Attach interactive browser UIs to Python, TypeScript, and Rust programs. Define state, actions, and views in your application's language. Arrange views from multiple apps in one dashboard.

How it fits together

flowchart LR
  App["Your app<br/>Python / TypeScript / Rust SDK"]
  Utils["Utilities<br/>Commands, logs, health checks, MCP"]
  Gateway["Gateway<br/>Shares apps on a machine"]
  Hub["Hub<br/>Dashboards and sharing"]
  Browser["Browser dashboard<br/>Local or hosted"]

  subgraph NativeApp["Mobile / desktop app"]
    EmbeddedHub["Embedded Hub"]
    Flutter["Flutter / GenUI"]
  end

  App <--> Gateway
  Utils <--> Gateway
  Gateway <--> Hub
  Hub <--> Browser
  Gateway <--> EmbeddedHub
  EmbeddedHub <--> Flutter
  Hub <-->|"Owner / share"| Flutter

Loading

Connections carry view updates and user actions. omochi-ui hub starts a local Gateway automatically. The Flutter app can use its embedded Hub or connect to an external Hub.

Use it

On Linux, macOS or Windows 11 with Node.js 22+:

npx @omochi-ui/cli hub

Open http://127.0.0.1:5555/ and add views from running apps.

Getting started · Utilities

Add a UI to your program

Follow the SDK guide, or install the integration skill for your coding agent:

npx skills add omochi-ui/omochi --skill omochi-integrate

Develop from source

From a repository checkout, with Bun 1.4.3+ and stable Rust:

bun install --frozen-lockfile
bun run quickstart

Contributing · Architecture · Specifications

License

Apache-2.0