https://github.com/engram-app/engram

Engram: Personal knowledge RAG system — Obsidian vault indexer, vector search, MCP server
https://github.com/engram-app/engram

elixir knowledge-base mcp obsidian phoenix rag vector-search

Last synced: 6 days ago
JSON representation

Engram: Personal knowledge RAG system — Obsidian vault indexer, vector search, MCP server

• Host: GitHub
• URL: https://github.com/engram-app/engram
• Owner: engram-app
• License: other
• Created: 2026-02-27T05:27:03.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-06-14T07:09:31.000Z (8 days ago)
• Last Synced: 2026-06-14T08:21:23.924Z (8 days ago)
• Topics: elixir, knowledge-base, mcp, obsidian, phoenix, rag, vector-search
• Language: Elixir
• Homepage:
• Size: 6.77 MB
• Stars: 4
• Watchers: 0
• Forks: 1
• Open Issues: 74
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md
  • Agents: AGENTS.md
  • Cla: .github/CLA.md

Awesome Lists containing this project

README

          
# Engram

![Engram — your notes are your AI's memory, synced everywhere and read by your AI](assets/vault-banner.gif)

[![Verify](https://github.com/engram-app/Engram/actions/workflows/verify.yml/badge.svg)](https://github.com/engram-app/Engram/actions/workflows/verify.yml)

[![Last commit](https://img.shields.io/github/last-commit/engram-app/Engram)](https://github.com/engram-app/Engram/commits/main)

[![Stars](https://img.shields.io/github/stars/engram-app/Engram?style=flat)](https://github.com/engram-app/Engram/stargazers)

[![License](https://img.shields.io/badge/license-PolyForm_SB_1.0-blue)](LICENSE)

[![Sponsor](https://img.shields.io/github/sponsors/engram-app?label=Sponsor&logo=GitHub&color=ea4aaa)](https://github.com/sponsors/engram-app)

[![Ko-fi](https://img.shields.io/badge/Ko--fi-Buy_a_coffee-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/engrams_sync)

Your notes are your AI's memory.

The AI memory layer where your notes are the storage — markdown you and your AI

assistants both read and write to via [MCP](https://modelcontextprotocol.io).

Built with Elixir/Phoenix. Pairs with the

[Engram Obsidian Sync](https://github.com/engram-app/Engram-obsidian) plugin

for real-time bidirectional sync.

## Self-Host (Docker Compose)

**Don't want to run the commands yourself?** Open the

[Quickstart docs](https://engram.page/docs/self-host/quickstart/), select

the whole page, and paste it into your AI assistant — it's written

top-to-bottom as imperatives the AI can execute in order.

Otherwise:

```bash

git clone https://github.com/engram-app/Engram.git

cd Engram

cp .env.example .env       # then fill in the three secrets at the top

docker compose up -d

```

App at . Migrations run on boot. Only port 4000 is

host-exposed; everything else stays on the private Docker network.

**Large vaults?** Enable MinIO for S3-style attachments:

`docker compose --profile s3 up -d` — see

[storage docs](https://engram.page/docs/self-host/environment-variables/#storage).

**Better embeddings?** Switch to Voyage AI in `.env` — see

[embeddings docs](https://engram.page/docs/self-host/environment-variables/#embeddings).

### Full self-host documentation

| Topic | Link |

|---|---|

| Quickstart           |  |

| Environment vars     |  |

| Encryption & keys    |  |

| Backup & restore     |  |

| Upgrades             |  |

| Troubleshooting      |  |

| Architecture         |  |

| MCP setup            |  |

| HTTP API             |  |

## Contributing

Local dev setup, tests, and PR rules: see [CONTRIBUTING.md](./CONTRIBUTING.md).

## License

Dual-licensed:

- **[PolyForm Small Business 1.0.0](./LICENSE)** — free for organizations

  under $1M USD prior-year revenue and < 100 employees + contractors.

- **Commercial License** — required for larger orgs. See

  [LICENSE-COMMERCIAL.md](./LICENSE-COMMERCIAL.md) or email

  `support@engram.page`.

External contributions sign the [Engram CLA](./.github/CLA.md). See

[CONTRIBUTING.md](./CONTRIBUTING.md).

## Security

See [SECURITY.md](./SECURITY.md) for vulnerability disclosure. Self-host LAN

deployments are out of scope of our published SLA — security depends on the

operator's network and infra.

Copyright (c) 2026 Rasbandit Software Solutions LLC d/b/a Engram.