Contribute to Engram
Help build a local-first AI operating system that keeps your data on your machine — no cloud, no telemetry, no vendor lock-in. We welcome engineers, designers, and thinkers who share the goal of zero 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
Local Development Setup
Clone & Configure
Get the repository and copy the example environment file. Drop any API keys you want to activate into .env.
git clone https://github.com/engram-os/engram-os.git cd engram-os cp .env.example .env
Setup OAuth (optional)
Only needed if you want to test the Google Calendar or Gmail agents. Obtain credentials.json from Google Cloud Console (Calendar + Gmail scopes) and place it in credentials/.
pip install -r config/requirements.txt python3 scripts/generate_token.py
Boot the OS
Start Qdrant, the FastAPI brain (with APScheduler), and the Streamlit dashboard using the lifecycle script.
./scripts/setup.sh ./scripts/start.sh
Marketing Site (Optional)
If you are contributing to this website specifically.
cd frontend 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