Inbox Archeology

Explore your exported message data like a personal time machine.

Preview

Dashboard

Relationship Graph

Analytics

What this is

Inbox Archeology transforms your Google Takeout data into a searchable, visual archive.

• Fully local
• Privacy-first
• Designed for exploration, not just storage

Quick Start

What you need

• Python 3.10+
• A Gmail Takeout export containing All Mail.mbox

1. Download the project

git clone https://github.com/monapdx/Inbox-Archeology.git
cd Inbox-Archeology

2. Install dependencies

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Start the app

streamlit run app.py

4. Add your Gmail export

When the app opens in your browser:

1. Find your Gmail Takeout file named All Mail.mbox
2. Copy it into the local input/ folder shown in the sidebar
3. Click Refresh list
4. Select the .mbox file
5. Click Run Inbox Archeology

Expected result

After the pipeline finishes, the app saves results in workspaces/<run-name>/output/ and can open the dashboard automatically.

Get Involved

👉 Check out the Issues tab and CONTRIBUTING.md to get started

Philosophy

This project is part of a broader movement toward:

• Data portability
• Digital sovereignty
• Personal archives

Your data should belong to you.