Skip to content

esceptico/ntrp

Repository files navigation

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.

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.

ntrp terminal UI

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.

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

About

personal entropy reduction system

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors