Personal AI assistant with persistent memory and multi-source knowledge integration
Project description
ntrp
ntrp is entropy – the measure of disorder in a system. Your calendar, emails, notes, browser tabs, 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, browser history, 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
Bumps version, creates a PR, merges, tags, and publishes a GitHub release. PyPI and npm packages are published automatically via CI.
Inspired by
- opencode – terminal UI
- letta – persistent memory and personalized approach
- hindsight – graph memory structure
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ntrp-0.15.0.tar.gz.
File metadata
- Download URL: ntrp-0.15.0.tar.gz
- Upload date:
- Size: 2.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7ac56d4c23b339ac4bc5e425e08513ae89fc2c0fdf920f9427ee3ad3cd5ad1e1
|
|
| MD5 |
66b65de25478ce8c190e34f3c86a73c4
|
|
| BLAKE2b-256 |
0c677a7afc8006b2180b3b203215cfa21d43b83216936cf455e7911777b32df7
|
Provenance
The following attestation bundles were made for ntrp-0.15.0.tar.gz:
Publisher:
publish-backend.yml on esceptico/ntrp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ntrp-0.15.0.tar.gz -
Subject digest:
7ac56d4c23b339ac4bc5e425e08513ae89fc2c0fdf920f9427ee3ad3cd5ad1e1 - Sigstore transparency entry: 1109218184
- Sigstore integration time:
-
Permalink:
esceptico/ntrp@7bf8ef59ec1cbdc3d718ee54e813dc1426ca8d4a -
Branch / Tag:
refs/tags/v0.15.0 - Owner: https://github.com/esceptico
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-backend.yml@7bf8ef59ec1cbdc3d718ee54e813dc1426ca8d4a -
Trigger Event:
push
-
Statement type:
File details
Details for the file ntrp-0.15.0-py3-none-any.whl.
File metadata
- Download URL: ntrp-0.15.0-py3-none-any.whl
- Upload date:
- Size: 235.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8402f378438e77b7944d053faebab2558bc5901d28bf770fe66b27f0dc9d4508
|
|
| MD5 |
078e4db0e3b0837d17c60aa70efbc0c8
|
|
| BLAKE2b-256 |
09b055e8c8d769bbb81fa374a473b23385351eb25f4b602a71793b4001d2e278
|
Provenance
The following attestation bundles were made for ntrp-0.15.0-py3-none-any.whl:
Publisher:
publish-backend.yml on esceptico/ntrp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ntrp-0.15.0-py3-none-any.whl -
Subject digest:
8402f378438e77b7944d053faebab2558bc5901d28bf770fe66b27f0dc9d4508 - Sigstore transparency entry: 1109218188
- Sigstore integration time:
-
Permalink:
esceptico/ntrp@7bf8ef59ec1cbdc3d718ee54e813dc1426ca8d4a -
Branch / Tag:
refs/tags/v0.15.0 - Owner: https://github.com/esceptico
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-backend.yml@7bf8ef59ec1cbdc3d718ee54e813dc1426ca8d4a -
Trigger Event:
push
-
Statement type: