untell-ai 0.1.0

untell.ai — reads your unspoken thoughts from digital footprints

untell.ai

Understands you better than Google does.

untell.ai analyzes your digital footprints to reveal patterns you didn't know you had. Not just what you search — why you search it, what you avoid, and what your behavior says when you're not paying attention.

---

What You Need

untell.ai uses two data sources to build your profile:

1. Chrome History (automatic)

Your Chrome browser stores every page visit, search term, and download in a local SQLite database. untell.ai reads it directly — no export needed.

What it captures:

• Every URL you visited + how long you stayed
• Every search term you typed in the address bar
• Pages you keep revisiting (obsession signals)
• Downloads (what you wanted to keep)

Note: Incognito/private browsing is not recorded by Chrome and cannot be analyzed.

2. YouTube Takeout (manual download, 5 min)

Google Takeout lets you export your full YouTube watch history as a JSON file.

How to get it:

1. Go to takeout.google.com
2. Click "Deselect all"
3. Scroll down and select only "YouTube and YouTube Music"
4. Click the YouTube section → change format from HTML to JSON
5. Click "Next step" → "Create export"
6. Wait for email → download the zip → unzip

Your Takeout folder will look like:

Takeout/
└── YouTube and YouTube Music/
    └── history/
        ├── watch-history.json    ← this is the key file
        └── search-history.json

What it captures:

• Every video you've ever watched (title, channel, timestamp)
• Your YouTube search history
• Subscriptions and playlists

---

How It Works

untell.ai does not call any LLM API. It collects and structures your data. The analysis is done by whatever AI agent you're already using (Claude Code, Cursor, ChatGPT, etc.).

Step 1: untell collects Chrome + YouTube data
Step 2: Your AI agent reads the structured data
Step 3: AI generates a behavioral profile (facts, patterns, unconscious insights)
Step 4: untell serves the results as a web dashboard on localhost

---

Quick Start

Install

pip install untell-ai

Collect Chrome History

untell collect --source chrome --output events.json

This reads all Chrome profiles on your machine. No setup needed.

Add YouTube Takeout

untell collect --source youtube \
  --input ~/Downloads/Takeout/YouTube\ and\ YouTube\ Music/history/ \
  --merge events.json

Point --input to the history/ folder inside your Takeout download.

View Results

untell serve profile.json

Opens an interactive 4-tab dashboard on http://localhost:8765.

---

The Dashboard

Tab	What's Inside
Summary	Identity layers, interest network graph, timeline, unconscious patterns
Facts	Who you are, active vs passive gap, hidden contradictions, predictions
Mood	Portrait, taste, passion, mission, drive
Google vs Me	How Google/YouTube see you vs who you actually are

Analysis Techniques

Technique	What It Reveals
Sequence Analysis	What you do after watching certain content — unconscious emotional patterns
Absence Analysis	What's missing from your data — things you avoid without realizing
Temporal Patterns	Time-of-day behavior shifts — different versions of yourself at different hours
Dwell Time	How long you spend on each page — true interest vs casual browsing
Cross-Source Gaps	What you search vs what you watch — conscious intent vs unconscious consumption

---

Data Sources

Source	How to Get It	What It Adds
Chrome History	Automatic (local SQLite)	Browsing, searches, downloads, dwell time, revisit patterns
YouTube Takeout	takeout.google.com → JSON format	Full watch history, channels, timestamps
Google Search Takeout	Same Takeout export	Raw search queries with timestamps

---

Privacy

• 100% local. All data stays on your machine. Nothing is sent anywhere.
• No LLM API calls. untell.ai does not call OpenAI, Anthropic, or any external AI service. Your AI agent (Claude Code, Cursor, etc.) does the analysis locally in your session.
• No external data transmission. Chrome History is read locally. YouTube Takeout is parsed locally. The dashboard runs on localhost — your browser talks to your own machine.
• Chrome History is read with immutable=1 flag — doesn't lock the database.
• No telemetry, no analytics, no tracking, no cloud uploads. Zero network calls.

---

License

Business Source License 1.1 — Free for personal use.
Commercial use requires a license. Contact: [e-mail]