ntrp 1.0.0rc1

Personal AI assistant with persistent memory and multi-source knowledge integration

ntrp

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

I built this for myself. ADHD and scattered attention meant I kept losing track of things (e.g. what I said, what I planned, what I was supposed to follow up on). So I made an assistant that hooks into my stuff and actually remembers.

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: Obsidian vault, Gmail, Google Calendar, web search (so far)
• Shell access: runs commands, manages files, sends emails
• Any LLM: Claude, GPT, Gemini built-in; OpenRouter, Ollama, vLLM, or any OpenAI-compatible endpoint via custom models

Memory

Schedules

Connections

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.

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