Get going with NomiFun
A curated set of operational, how-to guides for getting this local-first super AI workstation up and running. For deep technical internals and architecture, see the full docs on GitHub.
Getting Started
- Introduction What NomiFun is, who it's for, its two host modes and current version, plus a look at the main UI.
- Installation Three working paths to install NomiFun locally — desktop from source, web from source, and Docker self-hosting — with prerequisites, key commands, and verification.
- Your first conversation Configure a model, start your first session from the home screen, and use the workspace's messages, file tree, preview, and terminal.
Models & Decisioning
- Model routing & failover Connect the 4 native provider backends and orchestrate a failover queue of up to 4 switches so a session keeps going when a provider fails or is rate-limited.
- Intelligent decisioning (IDMM) A per-session supervisor — a rule layer handles mechanical stalls and a side-model layer resolves real decision checkpoints, so unattended work reaches a terminal state.
Sessions & Terminal
- The session workspace A session = its own working directory + message stream + file tree + multi-format preview + a terminal mounted to that directory, with knowledge bases, AutoWork, and decision watch in the header.
- Built-in terminal A native in-app PTY terminal with Shell / Claude Code / Codex / Gemini presets — attach it to a session's working directory and drive it by hand or hand it to AutoWork.
Companions & Channels
- Companions Raise a family of companions — shared memory hub, per-companion skill libraries, knowledge-base binding, skill evolution, and cross-machine migration.
- Channels Connect a companion to 11+ IM channels, authorize chat users with a QR scan or pairing code, and command your computer from a phone or group chat.
Knowledge & Open Capabilities
- Knowledge bases User-curated markdown directories, live URL snapshots, a safe staged write-back inbox, and session mounting so the agent retrieves before it answers.
- Assistants An assistant is a reusable persona (system prompt + default backend + skill selection) you create, edit, and tag under /assistants, then pick on demand in any session.
- MCP & skills Connect external MCP servers for more tools, manage skill knowledge packs, and tell external tools apart from a companion's own skill library.
- Open capabilities (MCP / REST / OpenAPI) Expose NomiFun's 151 capabilities to any agent through /mcp, /mcp-agent, and /v1 with a single companion-token, and delegate tasks as that companion.
Automation
- Requirements & AutoWork Register requirements, bind a tag to a session or terminal, and let the orchestrator run them unattended — with outbound completion notifications.
- Scheduled tasks Schedule companions with cron, run a job on demand, review run history, and keep the system awake.
Remote & Settings
- WebUI remote Expose the desktop backend over LAN behind a login; scan a QR with a 5-minute one-time token to work from your phone or tablet, with the same UI as desktop.
- Computer-use & browser Let the agent see and drive your desktop, and run a homegrown in-process browser engine for navigation and forms — the toggles, permissions, and approval boundaries for both system-level capabilities.
- Settings Review and adjust your local data directory, the dark/light theme, and the version and open-source attribution on the About page.