pjpoulose/PIL

**Get started · How it works · Other AI tools · What's inside**
mcp-name: io.github.pjpoulose/pil
---
> ### Get PIL in 3 steps
>
> **1.** Copy-paste this into Muse:
>
> Clone https://github.com/pjpoulose/PIL into your workspace and follow its
> SKILL.md to set up my Personal Instagram Library. Work through it step by
> step — install, build the library from my saved posts, and hand me the
> installable app.
>
> **2.** When it asks, link your Instagram (one tap in your browser).
>
> **3.** Download the app file it sends you → unzip → double-click **Start PIL** → click **Install**.
>
> That's the whole thing. Your Muse does the setup, the reading, and the building.
> Want it on your phone too? Just ask your Muse — it handles that as well.
>
>
> Prefer to do it yourself? One command sets everything up.
>
> - Mac / Linux: curl -fsSL https://raw.githubusercontent.com/pjpoulose/PIL/master/bootstrap.sh | bash
> - Windows (PowerShell): irm https://raw.githubusercontent.com/pjpoulose/PIL/master/bootstrap.ps1 | iex
>
> Then build your library with the commands in Manual setup.
>
---
Every day you save posts you'll never find again. **PIL (Personal Instagram Library)** turns your Instagram saved collection into a private knowledge base on your own machine: every post deep-read by vision AI — narrative summaries, key points, how-to steps, links it discusses, automatic tags — searchable in seconds and queryable live from your AI coding tools.
> **Code is shared, data stays home.** This repo contains only code, the database schema, config examples, and docs. Your saved posts, captions, and account details never leave your computer — ingestion, extraction, search, and the MCP server all run locally. A .gitignore blocks databases, configs, and exports from ever being committed.
*Concept mockup with sample data — your library looks like this, with your posts.*
Want your Claude, Codex, or Cursor to access this?
Connect the read-only MCP server and your other AI tools can query your library
live — always current, nothing to re-upload. Your Muse can wire it up for you.
How to connect →
How it works
Manual setup (do it yourself)
Expand — only needed if you're skipping the 3-step Muse flow at the top.
**Prerequisites:** python3 (3.11+) and instagram-cli with your Instagram
account linked (run instagram-cli accounts — it must list your account).
The one-line installer at the top of this page handles all of this for you.
**Ask it anything** — via the live MCP server *or* the static export:
That's it. Re-run ingest_saved.py whenever you save new posts; extract_content.py
only processes posts it hasn't seen yet.
**The app:** ask your Muse to build and send it — see Your library as an app.
Why not just scroll your saved tab?
| | Instagram saved tab | PIL |
|---|---|---|
| Find a post from 2 years ago | Scroll endlessly | Full-text search in seconds |
| Remember what a post actually said | Rewatch / reread it | AI summary, key points, how-to |
| Links a post mentioned | Gone unless you saved them | Extracted and clickable |
| Use it inside your AI tools | Screenshots and retyping | MCP server or JSON export |
| Where your data lives | Meta's servers | Your machine, SQLite |
Ask your library from other AI tools
**Live (recommended): MCP.** Point any MCP-compatible assistant at the
read-only server and every question reads your current database — always
up to date, no exports, no re-uploads:
Wiring for Claude Code, Claude Desktop, and Cursor:
references/mcp_clients.md. Any MCP-compatible
client works — and your Muse can connect it for you if you'd rather not touch