Skip to main content

EgoVault

Your personal data, on your machine, under your control.

CI License: MIT Python 3.11+

Every message you sent, every article you saved, every decision you made - scattered across platforms that own your data, monetise your attention, and can delete your history without warning.

EgoVault puts it all back in your hands.


Why this exists

Big Tech has had a good run storing your life for you. In return, they read your emails, sell your patterns, and hand your data to whoever asks politely enough. You get a "free" service and a privacy policy nobody reads.

We think that deal is broken.

Your memories do not belong to a corporation. Your conversations are not a product. The decisions, ideas, and relationships you've built over years are yours - and you should be able to search them, learn from them, and take them with you, without asking anyone's permission.

EgoVault is a local-first personal data vault. It runs on your hardware, uses a local LLM that never phones home, stores everything in a single SQLite file you can copy to a USB drive, and answers your questions without sending a single byte to a third party.

No subscriptions. No telemetry. No cloud lock-in.
Cloud sync is a future opt-in - never the default.


Hardware requirements

The default model (Gemma 4 E2B, ~3.2 GB) runs on CPU but is significantly faster on a CUDA-capable GPU.


Get started in one line

Windows - PowerShell (Windows 10/11, PowerShell 5+)

irm https://raw.githubusercontent.com/milika/EgoVault/main/scripts/install-win.ps1 | iex

Windows - Command Prompt (runs the same PowerShell script)

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/milika/EgoVault/main/scripts/install-win.ps1 | iex"

Linux / WSL - bash or sh

curl -fsSL https://raw.githubusercontent.com/milika/EgoVault/main/scripts/install.sh | sh

macOS - zsh (default) or bash

curl -fsSL https://raw.githubusercontent.com/milika/EgoVault/main/scripts/install.sh | sh

Any platform - pipx (Python 3.11+ required)

pipx install egovault

Then:

egovault chat          # terminal REPL
egovault web           # browser UI - prints a public URL automatically
egovault mcp           # MCP server for AnythingLLM / Claude Desktop

Full installation, configuration, and llama-server setup: docs/installation.md
Can't see the file? View it on GitHub.


What you can do

  • Reclaim your history - import emails, documents, chats, and notes from any platform
  • Ask questions across everything - "What did I decide about X last year?" - one answer, all sources
  • Own the inference - a local LLM reads and enriches your data; nothing leaves your machine
  • Access from anywhere - egovault web punches a secure tunnel so you can reach your vault from any device
  • Take it with you - the entire vault is one file; copy it, back it up, move it freely

Data sources

Source Status
Local files (PDF, DOCX, HTML, Markdown, EPUB, spreadsheets, plain text) :white_check_mark:
Gmail - Takeout / live API (OAuth2) / IMAP :white_check_mark:
Telegram export :white_check_mark:
WhatsApp, Facebook Messenger :hourglass_flowing_sand: planned
Instagram, LinkedIn, Twitter/X, TikTok :hourglass_flowing_sand: planned
Obsidian vault, Calendar (ICS) :hourglass_flowing_sand: planned

Interfaces

Interface How to start
Terminal REPL egovault chat
Browser UI egovault web
Telegram bot egovault telegram

How it works under the hood -> docs/how-it-works.md


Screenshots

Terminal REPL — llama-server auto-starts and chat is ready immediately
Terminal REPL

Browser UI — chat with your vault, tool calls shown inline
Browser UI chat

Remote access login — password-protected page served over a secure WAN tunnel
Remote access login

Telegram bot — full command set accessible from any device
Telegram bot


Roadmap

Adapters coming next

  • WhatsApp, Facebook Messenger, Instagram, LinkedIn, Twitter/X
  • Obsidian vault reader, Calendar ICS

Features coming next

  • Reminders - /remind <text> at <datetime> with due alerts in chat
  • Notes - /note <text> stored and searchable like any vault record
  • Multi-level access control (owner -> guest, passphrase auth)
  • egovault doctor - health-check command

Your data, your rules. Contributions and ideas are welcome - see CONTRIBUTING.md.


Changelog

See CHANGELOG.md for a full history of releases.


License

MIT (c) 2026 Milika Delic

Metadata

Release files for egovault 0.1.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for egovault 0.1.9
File Size Uploaded
egovault-0.1.9.tar.gz 682.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for egovault 0.1.9
File Interpreter ABI Platform
egovault-0.1.9-py3-none-any.whl Python 3 none any Details

Total release size: 912.4 kB

Release files / egovault-0.1.9.tar.gz

Download URL egovault-0.1.9.tar.gz
Size 682.5 kB
Tags Source
SHA-256 checksum
How to use checksums
71d224ad6d820ffc9f132958877832e3c2abb7c4318f4a664045d50636f26adc
BLAKE2b-256 checksum
How to use checksums
fd17845cf57779d71de6957cb02095de593687f521ff89dcbbe1c413a88feec5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / egovault-0.1.9-py3-none-any.whl

Download URL egovault-0.1.9-py3-none-any.whl
Size 229.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
90a0b38931b046bbf88df0f5740e30dc6931b99af4797966e8080a15ae582c62
BLAKE2b-256 checksum
How to use checksums
a3dea3272997c0510f6658cdaef5476e3f4001a74d69d62d487e13c726a62a11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

0.1.9 This release

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page