ntrp

ntrp is entropy - the measure of disorder in a system. Your calendar, emails, memory, half-remembered conversations - it all accumulates. This project exists to reduce it.

What it does

• Persistent memory: learns facts and patterns across conversations, consolidates them over time
• Scheduled tasks: morning briefings, daily reviews, health tracking – runs autonomously on a schedule
• Connected sources: Gmail, Google Calendar, Slack, web search, MCP tools
• Lean tool context: loads infrequent tools on demand so the model does not carry every schema in every turn
• Shell access: runs commands, manages files, sends emails
• Any LLM: Claude, GPT, Gemini built-in; OpenAI API keys or OpenAI account sign-in; OpenRouter, Ollama, vLLM, or any OpenAI-compatible endpoint via custom models

Install

uv tool install ntrp    # backend (or: pip install ntrp)
bun install -g ntrp-cli # terminal UI (or: npx ntrp-cli)

ntrp-server serve   # starts backend, prints a one-time API key
ntrp                # terminal UI (separate terminal) – paste the key on first launch

Full setup guide, integrations, and API reference at docs.ntrp.io.

Common Commands

This repo uses just as a thin task router:

just              # list recipes
just install      # install server, TUI, and desktop deps
just server       # run backend from apps/server
just tui          # run terminal UI
just desktop      # run desktop client
just check        # run backend + client checks

Repo Layout

• apps/server - self-contained uv project with backend package, tests, builtin skills, pyproject.toml, uv.lock, and Dockerfile.
• apps/tui - Bun/OpenTUI terminal client published as ntrp-cli.
• apps/desktop - Electron desktop client.
• docs - public docs and internal notes.

Releasing

./release patch    # 0.5.2 → 0.5.3
./release minor    # 0.5.2 → 0.6.0
./release major    # 0.5.2 → 1.0.0
./release rc minor # 0.5.2 → 0.6.0-rc.1
./release rc       # 0.6.0-rc.1 → 0.6.0-rc.2
./release final    # 0.6.0-rc.2 → 0.6.0

Bumps version, creates a PR, merges, tags, and publishes a GitHub release. PyPI and npm packages are published automatically via CI. Release candidates are marked as GitHub prereleases and published to npm under the rc dist-tag.

Inspired by

• opencode – terminal UI
• letta – persistent memory and personalized approach
• hindsight – graph memory structure

License

MIT