{"id":49975807,"url":"https://github.com/byte5ai/omadia-ui","last_synced_at":"2026-06-13T08:01:40.072Z","repository":{"id":358362249,"uuid":"1235846516","full_name":"byte5ai/omadia-ui","owner":"byte5ai","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-08T23:03:39.000Z","size":424,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-09T00:22:48.689Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/byte5ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T17:58:56.000Z","updated_at":"2026-06-08T23:03:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/byte5ai/omadia-ui","commit_stats":null,"previous_names":["byte5ai/omadia-ui"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/byte5ai/omadia-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte5ai%2Fomadia-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte5ai%2Fomadia-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte5ai%2Fomadia-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte5ai%2Fomadia-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/byte5ai","download_url":"https://codeload.github.com/byte5ai/omadia-ui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte5ai%2Fomadia-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34276504,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-18T10:42:42.187Z","updated_at":"2026-06-13T08:01:39.998Z","avatar_url":"https://github.com/byte5ai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# omadia-ui\n\n### The canvas where your agents build the interface — live, deterministic, yours.\n\nOmadia UI is the desktop surface for the [omadia](https://github.com/byte5ai/omadia)\nagentic OS: agents synthesise real UI — tables, forms, charts, wizards, editor\nregions — over a wire protocol, and the host renders it instantly in one\ncoherent material system. Persistent, multi-canvas, stateful. The interface is\nno longer a chat log; it is a workspace the agent composes for the task at hand.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-black.svg)](#license)\n[![Status: in development](https://img.shields.io/badge/status-in%20development-orange.svg)](#status)\n[![TypeScript](https://img.shields.io/badge/built%20with-TypeScript-3178C6.svg?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Electron](https://img.shields.io/badge/desktop-Electron-47848F.svg?logo=electron\u0026logoColor=white)](app/)\n\n[**Website**](https://omadia.ai) · [**Quickstart**](#-quickstart) · [**Concept**](CONCEPT.md) · [**Protocol**](docs/protocol/1.0.md) · [**Visual spec**](docs/visual-spec.md)\n\n\u003c/div\u003e\n\n---\n\n## Why a canvas instead of a chat?\n\nChat is the \"DOS era\" of LLM interaction: powerful but linear and text-only.\nOmadia UI is the next layer — a desktop application where the agent\n**materialises live UI** as it orchestrates a request across source systems\n(Jira, ERP, HR, …):\n\n- 🧱 **24 primitives, one protocol.** The wire format\n  (`omadia-canvas-protocol/1.0`) composes anything from a TUI-style list to a\n  Photoshop-class workspace — all rendered against a single validated,\n  CSP-safe whitelist.\n- ⚡ **Deterministic where it matters.** Known flows get known UI: plugins\n  publish fixed canvas trees, navigation and refresh run LLM-free, and the\n  static app menu survives error states — the user is never stranded.\n- 💡 **One material: Lume.** Light-as-material design system with hard rules\n  (surface-nesting ladder, chrome budget, three user-bindable palettes) —\n  enforced by the renderer for every tree, no per-plugin skinning.\n- 🗂️ **A real workspace.** Multiple live canvases with their own server\n  sessions, tiling split panes, named desktops, a canvas library — all synced\n  through the omadia registry and restored on restart.\n\n## ⚡ Quickstart\n\n**Download:** grab the installer for your OS from the\n[latest release](https://github.com/byte5ai/omadia-ui/releases) — macOS\n(dmg, arm64/x64), Windows (NSIS) and Linux (AppImage) are built and attached\nautomatically for every release.\n\n**Build from source:**\n\n```sh\ngit clone https://github.com/byte5ai/omadia-ui.git\ncd omadia-ui/app\nnpm ci\nnpm run dev          # electron-vite dev against your omadia server\nnpm run dist         # packaged installers into app/dist\n```\n\nOn first start, point the app at your running\n[omadia](https://github.com/byte5ai/omadia) server (WebSocket URL + login).\n\n## How it works\n\nThree tiers, split across client × server:\n\n| Tier | Latency | What lives there |\n|---|---|---|\n| **1 — deterministic** | instant | This host app + `omadia-ui-channel`: rendering, validation, local operations, deterministic actions |\n| **2 — small LLM** | sub-second | `omadia-ui-orchestrator`: composition, style inference, action routing |\n| **3 — heavy LLM + tools** | seconds+ | omadia plugins: data, AI services, long-running operations |\n\nSee [`docs/architecture-3tier.svg`](docs/architecture-3tier.svg) and\n[`CONCEPT.md`](CONCEPT.md) for the full architecture, security surface and\nforward-compatibility constraints (shared canvases land in v2 without a wire\nrefactor).\n\n## Documents\n\n| File | Purpose |\n|---|---|\n| [`CONCEPT.md`](CONCEPT.md) | Architecture, primitives, protocol, security, identity, SDK extension plan |\n| [`docs/visual-spec.md`](docs/visual-spec.md) | Lume material system — tokens, rules, composition idioms (v0.4) |\n| [`docs/protocol/1.0.md`](docs/protocol/1.0.md) | Protocol specification + machine-validatable JSON Schemas |\n| [`docs/walkthroughs.md`](docs/walkthroughs.md) | Use-case walkthroughs — multi-source comparison + editor micro-task |\n| [`docs/tech-stack.md`](docs/tech-stack.md) | Tech-stack decision for the host app (Electron), with reasoning |\n| [`app/`](app/) | The host application — Electron, strict TypeScript, vitest |\n\n## Relationship to omadia core\n\nOmadia UI rides on [`byte5ai/omadia`](https://github.com/byte5ai/omadia). The\nprotocol contract (`@omadia/canvas-core`: schemas + canonical fixtures) is\nsynced from the monorepo at build time — no vendored copy, no drift; a parity\ntest validates every canonical fixture against this renderer.\n\n## Status\n\nThe host app is **implemented and in active development**: full 24-primitive\nrenderer, Lume v0.4 as renderer law, multi-canvas workspace (tiling, desktops,\nlibrary), deterministic refresh/actions/navigation, native login, streaming\nplugin UI (X Studio as reference). Releases are cut automatically — every PR\nmerged to `main` produces a semantic version with generated notes and\ninstallers for macOS, Windows and Linux.\n\nmacOS signing/notarization is intentionally deferred to the GA pipeline.\n\n## License\n\nMIT — Copyright © 2026 byte5 GmbH.\n\nMaintained by [byte5 GmbH](https://byte5.de) under the GitHub organisation\n[`byte5ai`](https://github.com/byte5ai).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyte5ai%2Fomadia-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbyte5ai%2Fomadia-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyte5ai%2Fomadia-ui/lists"}