Skip to main content

​
Prerequisites

  • Python 3.13+ with uv
  • Bun for the desktop app when running from source
  • An LLM provider: Anthropic, OpenAI, Google, OpenRouter, custom OpenAI-compatible endpoint, or OpenAI account sign-in

​
Install

uv tool install ntrp installs the backend CLI. The Electron desktop app currently runs from a source checkout.
uv tool install ntrp    # or: pip install ntrp

​
Set up

1
Set your LLM provider
2
You can export a provider API key now, or configure a provider interactively in the desktop app after connecting.
3
# Pick one, or skip and configure from the desktop app:
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GEMINI_API_KEY=...
4
If you want to use an OpenAI subscription/account instead of an API key, skip the key export and choose OpenAI Codex in provider onboarding. ntrp opens a browser sign-in and stores refreshable OAuth tokens in ~/.ntrp/openai-codex-auth.json.
5
Start the server
6
Installed backend
ntrp-server serve
From source
just server
7
On first run, ntrp generates an API key and prints it:
8
Your API key: nBx7k2...
Enter this in a desktop client to connect. It won't be shown again.
9
Copy this key — it’s only shown once. Use ntrp-server serve --reset-key to generate a new one.
10
Start the desktop app
11
Desktop currently requires a source checkout. In a second terminal:
12
cd ntrp
just desktop
13
Or directly:
14
cd apps/desktop
bun run dev
15
Paste your API key in the connection screen. If no LLM provider is configured, provider onboarding appears so you can connect a provider and choose defaults.
16
Connect integrations
17
Open Settings → Integrations for Gmail/Google Calendar and Slack, or Settings → MCP for MCP servers. Use Run setup assistant for guided Google credentials, Slack token verification, and MCP JSON import.

​
What’s next?

Desktop Guide

Learn the app surfaces: chat, approvals, settings, memory, and traces.

Configuration

Customize models, integrations, and runtime settings.

Memory

Understand how ntrp remembers things.

Connect Gmail

Let ntrp read and send emails.