thesysdev/open-intelligent-ui

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/thesysdev/open-intelligent-ui.svg?style=card)](https://bestofgithub.dev/repo/thesysdev/open-intelligent-ui)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/thesysdev/open-intelligent-ui.svg)](https://bestofgithub.dev/repo/thesysdev/open-intelligent-ui)

Loading README…

Variable	Required	Purpose
`THESYS_API_KEY`	Yes, unless using a direct API	OpenUI Cloud (Gateway) key, used only on the server.
`THESYS_MODEL`	No	A `{provider}/{model}` id. Defaults to `openai/gpt-6.1-sol`.
`THESYS_BASE_URL`	No	The Gateway's Responses endpoint. Defaults to `https://api.thesys.dev/v1/embed`.
`LLM_BASE_URL`	No	Use any OpenAI-compatible Chat Completions API directly instead of Cloud, e.g. `https://openrouter.ai/api/v1`; see Use any OpenAI-compatible API.
`LLM_API_KEY`	With `LLM_BASE_URL`	That API's key.
`LLM_MODEL`	With `LLM_BASE_URL`	The model id it serves, e.g. `openai/gpt-6.1-sol` on OpenRouter.
`LLM_REASONING_EFFORT`	No	Reasoning effort for both paths. Defaults to `low` (about five times faster to the first line of UI on gpt-6.1-sol, same quality); `default` sends none.
`MODEL_PROVIDER`	No	Set to `ollama` to run a local model instead of Gateway; see Run with a local model.
`OLLAMA_MODEL`	No	The Ollama model to use. Defaults to `qwen3.8:27b`.
`OLLAMA_BASE_URL`	No	Ollama's OpenAI-compatible endpoint. Defaults to `http://localhost:11434/v1`.

File	Purpose
`src/app/layout.tsx`	Root layout: page metadata, the Inter font and `globals.css`.
`src/app/page.tsx`	The chat page. Renders `AgentInterface` with the component library, theme, welcome screen and starter prompts, and connects it to `/api/chat`.
`src/app/globals.css`	Global CSS reset.
`src/app/shell.css`	Restyles the `AgentInterface` shell (sidebar, composer, starters, message bubbles), using theme tokens where they exist.
`src/app/api/chat/route.ts`	Chat endpoint. Validates the request, forwards the conversation to OpenUI Cloud (or, with `LLM_BASE_URL` or the Ollama variables, to any OpenAI-compatible API with the prompt built here), and streams the response back.
`src/app/api/street-route/route.ts`	Street geometry between stops from OSRM, cached on the server.
`src/app/api/wiki/route.ts`	Wikipedia lookup: the lead photos (and coordinates) of an article, cached on the server.
`src/app/api/image-search/route.ts`	Photo search for `SearchImage`: matching Wikipedia lead images, then Wikimedia Commons, cached on the server.
`src/app/gallery/`	The dev-only `/gallery` page and its OpenUI Lang programs; `tool-programs.ts` holds the 16 examples and the dashboards.
`src/app/preview/`	A dev-only page that renders one program handed in by a script, for the benchmark's screenshots.
`src/lib/library.ts`	The OpenUI component library: the primitives, their groups and prompt notes.
`src/lib/functions/`	The library's `@functions` (`defineFunction`), with tests that run them through the 1.0 parser and evaluator.
`src/lib/actions.ts`	The `@CopyToClipboard` action and its handler.
`src/lib/demo-data.ts`	Demo data tools (`get_orders`, `get_tickets`, `get_traffic`) for Query-backed dashboards: their specs for the prompt and a function-map tool provider.
`src/lib/prompt-options.ts`	The prompt options: the working-tool rules and examples, and a dashboard variant with the demo data tools.
`src/lib/response-theme.ts`	Theme tokens for the `AgentInterface` shell (colors, fonts, radii, chat bubbles), built with `createTheme()`.
`src/lib/components/`	The components (`defineComponent` + Zod schema each), their styles and tokens, and the map in `map/`.
`src/generated/spec.json`	Library spec sent to Gateway in the system prompt. Regenerate with `npm run generate` after changing a component schema.
`src/generated/system-prompt.txt`	The full system prompt for the library; `dashboard-system-prompt.txt` adds the demo data tools. Regenerate with `npm run prompt`.
`scripts/bench/`	The benchmark: 16 example prompts and 8 dashboard prompts, run against a model and checked; see Benchmark.
`docs/openui-chatgpt-comparison.mp4`	Side-by-side video of ChatGPT and this project; `docs/openui-chatgpt-comparison.jpg` is its README preview.
`.env.example`	The environment variables to copy into `.env`.

thesysdev/open-intelligent-ui

Open Intelligent UI

Demo video

What's in the demo

Setup

Use any OpenAI-compatible API

Run with a local model (Ollama)

How it works

Project structure

For designers

Checks

Benchmark

License

Clash Royale deck coach (`/clash`)

Chess coach (`/chess`)

Open Intelligent UI

Demo video

What's in the demo

Setup

Use any OpenAI-compatible API

Run with a local model (Ollama)

How it works

Project structure

For designers

Checks

Benchmark

License

Clash Royale deck coach (/clash)

Chess coach (/chess)

Clash Royale deck coach (`/clash`)

Chess coach (`/chess`)