Releases: mishablank/Engram
Releases · mishablank/Engram
Release list
Engram v0.1.0 — initial public release
First public release of Engram — a single-tenant Telegram bot that forwards anything (text, photos, voice, PDFs, YouTube links, Word docs, web pages) into your Obsidian vault as tagged, linked, deduplicated Markdown notes.
What's in this release
- Capture pipeline: text, URLs, photos, voice notes, PDFs, Word docs, YouTube links, multi-photo media groups.
- Claude enrichment: title, summary, tags, folder routing, related-note suggestions, confidence-gated inbox queue.
- Vision OCR via Claude, Whisper voice transcription via OpenAI, PDF/DOCX text extraction, YouTube transcript fetch, web page fetch.
- Semantic dedupe — URL → title → cosine on OpenAI embeddings. Matching incoming notes append instead of duplicating.
- Vault-grounded
/ask— hybrid keyword + embedding retrieval, multi-turn via Telegram reply threads. - Manual override commands:
/redo,/edit,/undo,/relink,/search,/inbox,/review,/refresh. - Single-tenant security:
ALLOWED_USER_IDSallowlist gates every handler. - One-click Railway deploy + persistent-volume notes in the README.
Setup
git clone https://github.com/mishablank/Engram.git
cd Engram
uv sync
cp .env.example .env # fill in TELEGRAM_BOT_TOKEN, ANTHROPIC_API_KEY, ALLOWED_USER_IDS, BASE_DIR
uv run python -m engram.botSee the README for full configuration, command reference, security model, and deploy options.
Tested on
Python 3.11, 3.12, 3.13. 124 tests passing.