E
Engram
Open Source

Contribute to Engram

Help us build the first truly private AI Operating System. We welcome engineers, designers, and thinkers who share our vision of 0% Data Egress.

Core Philosophy

Local-First

All inference happens on metal. No API calls to OpenAI/Anthropic for core logic.

Privacy by Design

User data, files, and memories must never leave the Docker container.

Transparent Action

Agents never take high-stakes actions without user review and clear logs.

The Tech Stack

Core & Backend
Python 3.11
FastAPI, Celery, LangChain
OS Dashboard
Streamlit
Python-based UI for local control
Infrastructure
Docker Compose
Redis, Qdrant Vector DB, Ollama
Marketing Site
Next.js 14
TypeScript, Tailwind, Framer Motion

Local Development Setup

01

Clone & Configure

Get the repository and create the necessary inbox structure for document processing.

git clone https://github.com/VS251/engram-os.git
cd engram-os
mkdir -p AI_Inbox/processed
02

Setup Secrets

Obtain credentials.json from Google Cloud Console (Calendar + Gmail scopes) and place it in root.

pip install -r requirements.txt
python3 generate_token.py
03

Boot the OS

Run the full stack (API, Worker, Database, and Dashboard) using the lifecycle script.

chmod +x start_os.sh
./start_os.sh
04

Marketing Site (Optional)

If you are contributing to this website specifically.

cd web
npm install && npm run dev

Ready to Submit?

  • Fork repository & create a descriptive branch (feat/email-agent).
  • Ensure docker-compose up builds cleanly without errors.
  • Format code: PEP 8 for Python, Prettier for TypeScript.
  • Include screenshots for any UI-related changes.

Found a bug?

Please include your OS, Docker status, and relevant logs in the issue description.

Open an Issue