Show HN: TinyWebUI – A small, self-hosted AI chat UI with MCP, search and memory

TinySuite released TinyWebUI, a self-hosted, local-first AI chat interface that runs any OpenAI-compatible model and ships with two MCP servers, TinySearch and TinyContext, pre-connected. TinyWebUI stores chats, documents and tool output in a single local SQLite file, supports MCP over stdio, Streamable HTTP or SSE, and requires Node.js 22.13 or later, with installation via `npx tinywebui` on port 7777. The tool adds hybrid local search (BM25 plus an on-device embedding model) after a roughly 90 MB `npx tinywebui models pull fast` download, and keeps API keys and the owner password hash in a gitignored `tinywebui.config.json`.

A small, local-first chat workspace for any OpenAI-compatible model, with MCP tools. Part of TinySuite https://tinysuite.dev . Comes with TinySearch https://github.com/TinySuiteHQ/TinySearch and TinyContext https://github.com/TinySuiteHQ/TinyContext already connected. <sub From a fresh start, using DeepSeek V4.1 Flash through OpenRouter. The wait during the research turn is shown at 4× speed. Full-resolution video https://github.com/TinySuiteHQ/TinyWebUI/blob/main/docs/demo.mp4 .</sub TinyWebUI is the chat interface of TinySuite https://tinysuite.dev , a set of small, local-first tools for AI agents. Bring an endpoint OpenRouter, OpenAI, Groq, Ollama, vLLM, LM Studio, or anything else that speaks the OpenAI API , pick a model and a system prompt, and start working. Chats, documents and tool output stay in one SQLite file on your machine. There is no hosted backend, no account to create, no build step and no frontend framework. It comes pre-loaded with two TinySuite MCP servers, so a new install can already search the web and remember things: - TinySearch https://github.com/TinySuiteHQ/TinySearch searches, reads and reranks the web locally. It doesn't need a search API key. - TinyContext https://github.com/TinySuiteHQ/TinyContext is a local long-term memory that recalls only what fits the token budget. - Durable conversations. Edit, retry, rewind, folders and full-text search. A running turn belongs to the server, so you can reload and come back to it. - Steer a turn while it runs. Press Enter to reach the model at the next safe point, or Alt+Enter to hold a follow-up. - MCP over stdio, Streamable HTTP or SSE. Calls that can change something wait for your approval. - Attachments. Text and source files, PDFs, DOCX and images. - Hybrid local search BM25 plus a small on-device embedding model over documents and past chats. - Long chats that stay affordable. Cache-friendly prefixes, one-time compaction of large tool results, and per-round token statistics. - Automations. Cron-scheduled prompts that run in a chat of your choice. - Private by default. Interactive first runs ask for an owner password; a team can use an SSO gateway with roles and an admin panel. - Managed from files. Version-controlled config that hot-reloads, refuses typos and has a fingerprint you can check against a running instance. - Themes. Fall Fairy and Cyber Grid are included. See theme authoring https://github.com/TinySuiteHQ/TinyWebUI/blob/main/public/themes/README.md to write your own. Requires Node.js 22.13 or later. The bundled TinySearch and TinyContext servers also need uv https://docs.astral.sh/uv/ , which fetches them the first time they start. npx tinywebui The first run asks you to create an owner password of at least 15 characters. Open http://127.0.0.1:7777 http://127.0.0.1:7777 , sign in, then connect a model. Put an endpoint and key in tinywebui.config.json start from example.tinywebui.config.json or use the Settings panel: { "baseUrl": "https://openrouter.ai/api/v1", "apiKey": "sk-or-...", "model": "deepseek/deepseek-v4.1-flash" } tinywebui.config.json holds your password hash and API keys and is gitignored. Keep it that way. Use npx tinywebui set-password to change the password later. npx tinywebui uses keyword search until you run npx tinywebui models pull fast about 90 MB to enable hybrid search. From a clone, run npm install && npm start . With Docker, create the owner password in the persistent volume before starting the service: docker compose build docker compose run --rm -it tinywebui set-password docker compose up -d The Compose example publishes port 7777 on the host's loopback interface. The Docker image also accepts TINYWEBUI PASSWORD for a headless first start; use a password of at least 15 characters and keep the container's data volume. Without credentials, a headless start exits before opening a port. The runtime images contain Node.js but no npm/npx; connect MCP servers over HTTP or include their executables in a custom image. The Compose example now stores config in its named data volume. If you used the previous bind-mounted tinywebui.config.json , copy its settings into the volume before starting, then run set-password there. The full reference lives at tinysuite.dev/docs/tinywebui https://tinysuite.dev/docs/tinywebui/ : | Topic | Covers | |---|---| | Quick start https://tinysuite.dev/docs/tinywebui/ quick-start | npx, clone, Docker | | Configuration https://tinysuite.dev/docs/tinywebui/ configuration | Environment variables, every setting, the model catalog | | MCP tools https://tinysuite.dev/docs/tinywebui/ mcp-tools | Adding servers, tool approval, built-in tools | | Chats and attachments https://tinysuite.dev/docs/tinywebui/ chats-and-attachments | Documents, images, steering a turn | | Search https://tinysuite.dev/docs/tinywebui/ search | Hybrid retrieval, embedding models, tuning | | Automations https://tinysuite.dev/docs/tinywebui/ automations | Scheduled prompts | | Long chats https://tinysuite.dev/docs/tinywebui/ long-chats-caching-and-compaction | Caching and compaction | | Usage statistics https://tinysuite.dev/docs/tinywebui/ usage-statistics | Token use and attribution | | Access https://tinysuite.dev/docs/tinywebui/ access | Just you, a password, or a team behind SSO | | Deployment as code https://tinysuite.dev/docs/tinywebui/ deployment-as-code | JavaScript config, locked settings, roles and features | | CLI https://tinysuite.dev/docs/tinywebui/ cli | Every command | | Security and limits https://tinysuite.dev/docs/tinywebui/ security-and-limits | Exposure, MCP trust, what isn't included | In this repository: docs/deploy.md https://github.com/TinySuiteHQ/TinyWebUI/blob/main/docs/deploy.md is a scripted container deployment, and docs/config.schema.json https://github.com/TinySuiteHQ/TinyWebUI/blob/main/docs/config.schema.json is the config schema also tinywebui schema . npm test the whole suite, about 10 seconds npm run dev restart on changes in src/ and bin/ AGENTS.md https://github.com/TinySuiteHQ/TinyWebUI/blob/main/AGENTS.md maps the codebase and says where new code goes. npm run eval runs model-behaviour evals from evals/tasks/ and makes real API calls, so it costs money. GNU Affero General Public License v3.0 or later https://github.com/TinySuiteHQ/TinyWebUI/blob/main/LICENSE . If you run a modified version for users over a network, you must offer them the corresponding source code for that version.