Quickstart: Build & Run From Source
Nuncio is pre-alpha — there is no installer, package, or download for end users yet. What is real: a Cargo workspace you can clone and build today, which gives you a working daemon (nunciod) and a reference CLI (nuncio-cli) that talks to it. Available now
1. Clone & Build the Workspace
Requires the Rust toolchain pinned in rust-toolchain.toml. Cargo will fetch it automatically via rustup.
git clone https://github.com/KofTwentyTwo/nuncio.git cd nuncio cargo build --workspace
2. Run the Daemon (`nunciod`)
The daemon owns all state and serves a versioned gRPC API on loopback 127.0.0.1:9420, behind a bearer token minted into your OS keyring on first run.
cargo run -p nunciod
3. Drive It With the Reference CLI
With the daemon running in one terminal, nuncio-cliis a full gRPC client and the project's own end-to-end test driver:
cargo run -p nuncio-cli -- system status
From source, you get real IMAP/SMTP sync, SQLite FTS5 full-text search, MBOX/EML/JSON/JSONL export, and a hash-chained WORM audit ledger — driven entirely through the CLI. There is no desktop GUI, terminal TUI, or MCP AI client yet; those are separate client projects planned on top of the same gRPC contract. See the repository for the current state of the workspace.