Files
freedak f7a720204a Update: 将子项目从 submodule 转为完整内容
- 移除 GovAI, nomifun-tauri, 算力盒子 的 submodule 引用
- 添加所有子项目的完整源代码
- 保留原始 .git 为 .git.bak 备份
2026-07-04 19:20:46 +08:00

2.3 KiB

Quick Start

A short walkthrough for the first useful NomiFun session. This assumes the repo is already installed; otherwise start with Installation.

1. Launch

Desktop development:

bun run dev

The desktop shell starts the backend on a private loopback port and injects a local trust token into its own webview. There is no desktop login screen.

Web server:

bun run serve:web
# open http://127.0.0.1:8787

The web host requires login by default. On a fresh data directory, the first visitor creates the initial admin unless you pre-seed NOMIFUN_ADMIN_PASSWORD.

First-run admin setup

2. Start From /guid

After auth, the app opens /guid. This is the default session start surface.

You can choose:

  • an agent/runtime,
  • a model/provider when the runtime supports it,
  • an assistant persona,
  • skills or MCP tools,
  • a workspace path,
  • and the first prompt.

The /guid landing page

3. Configure A Model

Open Models (/models) and configure at least one provider or detected CLI agent. The page owns provider credentials, agent availability, and global reliability settings such as IDMM and model failover.

Model settings

For the simplest first run, use the built-in Nomi engine with an API provider you have credentials for. External CLIs such as Claude Code, Codex, Gemini CLI, Qwen, and OpenCode must also be installed on the host before NomiFun can use them.

4. Send The First Message

Back on /guid:

  1. Choose an agent.
  2. Choose a model if required.
  3. Optionally choose an assistant.
  4. Type a prompt.
  5. Send with the button or Ctrl/Cmd+Enter.

NomiFun creates a conversation and navigates to /conversation/<id>.

5. Use The Workspace

Each conversation can use a working directory. Inside a conversation you can inspect messages, tool calls, file edits, previews, and terminal sessions.

Useful next pages: