Engram logo Engram Β· Docs Home GitHub β†—

Engram documentation

Engram turns your handwritten notes β€” a OneNote export, or any PDF β€” into a local, Obsidian-native knowledge base. It's an organizer for what you've already learned: searchable summaries, connected into a concept graph, that show you the shape of what you know.

What Engram is

An index and connector, not a transcriber. For each note it writes a concise, searchable summary of the page's key ideas and all its formulas, keeps the original page right below as the source of truth, links related notes, and distils a multi-layer concept graph. Everything runs on your Mac (Claude Code or a local model), and edits are durable and incremental.

The toolbar β€” start here

Every action in the app lives in the top toolbar. Click an icon below to read how it works and why it's designed that way.

Install & requirements

Python 3.11+ and uv on macOS 14+ (Apple Silicon). The first local-model run downloads ~5 GB.

# set up (add --extra local for the on-device model)
uv sync --extra dev --extra local

# build & open the macOS app
cd macapp && ./build_app.sh && open Engram.app

Recommended start β˜…

πŸš€ Don't import everything at once β€” start with one course.

Try one section group first, check the summaries, pick your model and filters, then scale. See Add.

  1. Add one course PDF to a domain (see Using Engram β†’ Add).
  2. Link the domain, then build Concepts (see Connecting knowledge).
  3. Open the Graph and Chat with your notes.

Engram is an early v0.2 research prototype Β· source on GitHub Β· back to home