Skip to main content

​
Prerequisites

  • Python 3.13+ with uv
  • Bun runtime
  • At least one LLM provider API key (Anthropic, OpenAI, or Google)

​
Install

uv tool install ntrp    # Python backend (PyPI)
npm i -g ntrp-cli       # TUI client (npm)

​
Set up

1
Set your LLM provider key
2
Export at least one provider API key. ntrp auto-selects models based on the provider.
3
# Pick one:
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GEMINI_API_KEY=...
4
Start the server
5
From source
uv run ntrp-server serve
Installed
ntrp-server serve
6
On first run, ntrp generates an API key and prints it:
7
Your API key: nBx7k2...
Enter this in the TUI to connect. It won't be shown again.
8
Copy this key — it’s only shown once. Use ntrp-server serve --reset-key to generate a new one.
9
Start the TUI
10
In a separate terminal:
11
From source
cd ntrp-ui
bun run start
Installed
ntrp
12
Paste your API key in the connection dialog and you’re in.

​
What’s next?

Configuration

Customize models, enable integrations, and tune settings.

Memory

Understand how ntrp remembers things.

Connect Gmail

Let ntrp read and send emails.

TUI Guide

Keyboard shortcuts and slash commands.