Setup guide
>NGENT_
Six steps from a fresh machine to a resident agent you can DM from anywhere. Takes about two minutes.
01
Install
One command builds a venv and installs the
ngent command.
Needs python3.10+, curl, and either uv or python3-venv.
$ curl -fsSL https://ngent.noid.gg/install.sh | bash
02
Configure
Run the setup wizard. It walks you through the rest.
$ ngent setup
03
Paste your OpenRouter key
The only credential you bring. NGENT routes every model through your OpenRouter API key — paste it when prompted.
04
Pick a model
Type any OpenRouter model id — swap it any time.
e.g.
deepseek/deepseek-v4-pro or anthropic/claude-opus-4.8
05
Scan the QR with NoidChat
A QR code prints in your terminal. Scan it with the NoidChat app to pair your bot, then approve it on your phone.
06
Auto-boots & stays running
NGENT registers a systemd service and starts itself — it stays up across reboots. DM it from anywhere over NoidChat.
Good to know
Run ngent on its own to open a local terminal agent — a Claude-Code-style session right in your shell.
Re-run ngent setup any time to change your key, switch models, or re-pair.