macOS
Apple Silicon and Intel. Vector search needs the Homebrew SQLite.
- Install GNO
bun install -g @gmickel/gno - Install SQLite (for vector search)
brew install sqlite3 - Verify
gno doctor
Install
Get GNO on your machine in under a minute.
One command. macOS, Linux, and Windows. MIT-licensed, zero telemetry, runs 100% on your own machine. No account required.
$
bun install -g @gmickel/gnoDon’t have Bun yet? Install it with bun.sh, then come back and run the command above.
Per-platform
Pick your operating system.
The install command is the same everywhere — these are the extras specific to each platform.
Linux
x86_64 and arm64. Bun handles the binary.
- Install GNO
bun install -g @gmickel/gno - Verify
gno doctor
Windows
windows-x64 supported. arm64 not yet.
- Install GNO
bun install -g @gmickel/gno - Verify
gno doctor
Verify
Confirm GNO is ready to go.
gno doctor runs a full environment check: CLI path, SQLite version, model cache, and disk space.
gno --version
gno doctor
gno status- gno --version — prints the installed release.
- gno doctor — runs diagnostics and flags missing dependencies.
- gno status — shows the active config and collection summary.
Desktop beta
Prefer a packaged app?
The desktop build wraps gno serve in a native window with the workspace UI pre-wired. No terminal needed after the first launch.
Next
After install, point GNO at your notes.
Quickstart
Initialize your first workspace, run a hybrid search, and open the Web UI.
Configuration
Tune collections, presets, and model choices via index.yml and the CLI.
MCP integration
Wire GNO into AI tools like Claude Desktop, Cursor, Zed, and Windsurf via MCP.
CLI reference
Every command GNO ships, from init to serve to doctor, with examples.
Source
GNO is MIT-licensed and open.
The whole workspace — CLI, SDK, Web UI, MCP server, agent skills — lives in a single repository. Read the source, file issues, send a PR, or fork it for your own experiments.