Install GNO

Getting Started

Installation

Install GNO via Bun, verify with gno doctor, and configure vector search on macOS.

GNO ships as a Bun-compiled CLI that also exposes a web server, a TypeScript SDK, and an MCP server. One install gives you all of them.

macOS and Linux

bun install -g @gmickel/gno

On macOS, vector search requires the Homebrew build of SQLite so GNO can load the SQLite extension for vector similarity:

brew install sqlite3

After install, verify with gno doctor. It checks for the CLI, SQLite, models, and disk space.

gno doctor

Windows

Current support target is windows-x64. The CLI path works via Bun/global install, and the desktop beta ships as a packaged Windows zip on GitHub Releases. Windows arm64 is not supported yet.

bun install -g @gmickel/gno

Desktop beta

The packaged desktop shell wraps gno serve in a native window with the workspace UI pre-wired. Grab a build from GitHub Releases and run it like any other desktop app.

Verify your install

gno --version
gno doctor
gno status

gno doctor surfaces path resolution, SQLite version, model cache location, and disk space. gno status shows the currently active config file and collection summary.

Next steps