Skip to content

Releases: mishablank/Engram

Engram v0.1.0 — initial public release

Choose a tag to compare

@mishablank mishablank released this 11 May 12:04

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_IDS allowlist 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.bot

See the README for full configuration, command reference, security model, and deploy options.

Tested on

Python 3.11, 3.12, 3.13. 124 tests passing.