PIL

Ваши сохранённые посты Instagram — прочитаны ИИ, доступны для поиска навсегда, на вашем компьютере.

Начать · Как это работает · Другие AI-инструменты · Что внутри

mcp-name: io.github.pjpoulose/pil

Получите PIL за 3 шага

1. Скопируйте и вставьте это в Muse:

    Клонируйте https://github.com/pjpoulose/PIL в своё рабочее пространство и следуйте его
    SKILL.md, чтобы настроить мою Персональную библиотеку Instagram. Проработайте это шаг за
    шагом — установите, соберите библиотеку из моих сохранённых постов и передайте мне
    устанавливаемое приложение.

2. Когда попросит, свяжите свой Instagram (один тап в браузере).

3. Скачайте файл приложения, который он вам отправит → распакуйте → дважды щёлкните Start PIL → нажмите Install.

Это всё. Ваш Muse выполнит настройку, чтение и сборку. Хотите также на телефоне? Просто попросите своего Muse — он справится и с этим.

Предпочитаете сделать сами? Одна команда всё настроит.

• 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

Затем соберите свою библиотеку с помощью команд из Ручная настройка.

Каждый день вы сохраняете посты, которые больше никогда не найдёте. PIL (Personal Instagram Library) превращает вашу коллекцию сохранённых постов Instagram в частную базу знаний на вашем собственном компьютере: каждый пост глубоко прочитан vision-ИИ — повествовательные сводки, ключевые моменты, пошаговые инструкции, обсуждаемые ссылки, автоматические теги — поиск за секунды и живые запросы из ваших AI-инструментов для кодирования.

Код общий, данные остаются дома. Этот репозиторий содержит только код, схему базы данных, примеры конфигурации и документацию. Ваши сохранённые посты, подписи и данные аккаунта никогда не покидают ваш компьютер — загрузка, извлечение, поиск и MCP-сервер работают локально. .gitignore блокирует базы данных, конфигурации и экспорт от попадания в коммиты.

Концептуальный макет с примером данных — так выглядит ваша библиотека, с вашими постами.

Хотите, чтобы ваш Claude, Codex или Cursor имели к этому доступ?

Подключите read-only MCP-сервер, и ваши другие AI-инструменты смогут запрашивать вашу библиотеку вживую — всегда актуально, ничего не нужно загружать заново. Ваш Muse может подключить это за вас. Как подключить →

Как это работает

flowchart LR
    A["Instagram saved posts"] -->|"ingest"| B["Local SQLite on your machine"]
    B -->|"vision AI<br/>deep read"| C["Summaries, key points, how-tos, links, tags"]
    C --> D["Query two ways"]
    D --> E["MCP server — Cursor, Claude Code, Desktop"]
    D --> F["Static JSON export — any AI tool"]

Ручная настройка (сделайте сами)

# 1a. Install from PyPI (recommended — no clone needed)
pip install personal-instagram-library
# gives you: pil-mcp pil-ingest pil-extract pil-tag
#            pil-export-web pil-export-html pil-export-pwa pil-publish-pwa

# 1b. Or get the code
git clone https://github.com/pjpoulose/PIL.git pil && cd pil

# 2. Configure (your data lives in data_dir, default ~/.local/share/pil)
cp pil.config.example.json ~/.config/pil/pil.config.json
# edit it: set account_id to your user_fbid from `instagram-cli accounts`

# 3. MCP server dependency
pip install "mcp<2"

cd bin
python3 ingest_saved.py      # collections + saved posts
python3 extract_content.py   # vision-AI deep read (batches of 25)
python3 tag_all.py           # programmatic tags for untagged posts
python3 export_web.py        # static JSON export -> <data_dir>/web_data.json
python3 export_html.py       # searchable HTML dashboard -> <data_dir>/pil_library.html
python3 export_pwa.py        # installable PWA bundle -> <data_dir>/pwa/

python3 bin/mcp_server.py    # read-only, stdio — Ctrl-C to stop

Почему бы просто не прокручивать вкладку сохранённого?

Спрашивайте свою библиотеку из других AI-инструментов

Вживую (рекомендуется): MCP. Укажите любому MCP-совместимому ассистенту на read-only сервер, и каждый вопрос читает вашу текущую базу данных — всегда актуально, без экспортов, без повторных загрузок:

python3 /path/to/pil/bin/mcp_server.py    # stdio; Ctrl-C to stop

Настройка для Claude Code, Claude Desktop и Cursor: references/mcp_clients.md. Любой MCP-совместимый клиент подойдёт — и ваш Muse может подключить его за вас, если вы не хотите трогать конфиги. Доступные инструменты:

Сервер открывает базу данных с SQLite mode=ro и предоставляет только SELECT-инструменты — он не может изменить вашу библиотеку. (Проверено на атаки: SQL-инъекции, попытки записи и злоупотребление лимитами — всё подтверждённо заблокировано.)

Снимок: загрузка файла. Попросите своего Muse отправить вам файл web_data.json (созданный с помощью export_web.py): каждый пост с его глубоко прочитанными знаниями в одном файле. Прикрепите его к любому AI-чату (Claude, ChatGPT, …) и задавайте вопросы, как с любым документом. Он заморожен на момент экспорта — это снимок, а не живое соединение — поэтому попросите своего Muse о свежей копии после сохранения новых постов.

Напрямую (продвинутый уровень). База данных — это обычный SQLite по адресу <data_dir>/pil.sqlite (схема в schema.sql). Откройте её в режиме только для чтения любым SQLite-инструментом.

Эти файлы содержат ваши личные данные Instagram — храните их на своём компьютере и делитесь только с инструментами, которым доверяете.

Ваша библиотека как приложение

Ваш Muse собирает приложение за вас и отправляет его вам — для вашего компьютера и вашего телефона. Просто спросите:

• "Отправь мне моё приложение PIL" — скачайте файл, который он вам отправит, распакуйте, дважды щёлкните Start PIL, нажмите Install. Оно живёт на вашем компьютере, как любое другое приложение, и работает полностью офлайн.
• "Установи PIL на мой телефон" — он справится с публикацией и даст вам QR-код для сканирования. Нажмите Install (Android) или Share → Add to Home Screen (iPhone).

Никаких команд, никакой настройки хостинга, никакого терминала — ваш Muse берёт на себя всё.

Signal Deck — визуальная панель (v1.2.0)

Предпочитаете исследовать, а не запрашивать? Signal Deck (dashboard/) создаёт самодостаточную HTML-панель из вашей локальной базы данных PIL: кольцо тем как главный элемент над всем, что вы сохранили, поиск → синтез (The Brief), боковая панель источников, липкий индекс и полная сетка архива. Один файл, работает офлайн, ваши данные никогда не покидают ваш компьютер.

cd dashboard
PIL_DB=~/.local/share/pil/pil.sqlite python3 build-signal.py
# open pil-signal-deck.html in Chrome/Safari

См. dashboard/README.md для деталей, заметок о PWA и набора QA.

Что внутри

pil/
├── assets/logo.svg          # the seal above
├── SKILL.md                 # skill definition (for Muse)
├── README.md                # this file
├── LICENSE                  # MIT
├── schema.sql               # the five tables: folders, posts, post_folders, knowledge, tags
├── pil.config.example.json  # copy to pil.config.json and set your account_id
├── bootstrap.sh             # one-line installer for Mac/Linux
├── bootstrap.ps1            # one-line installer for Windows
├── bin/
│   ├── pil_common.py        # config resolution + DB helpers
│   ├── ingest_saved.py      # step 1: ingest (resume-safe)
│   ├── extract_content.py   # step 2: vision-AI extraction (resume-safe)
│   ├── tag_all.py           # step 3: tagging
│   ├── export_web.py        # step 4: static export
│   ├── export_html.py       # step 5: self-contained HTML dashboard
│   ├── export_pwa.py        # step 6: installable PWA bundle (manifest + SW + icons)
│   ├── publish_pwa.py       # step 7: publish PWA to your own host for phone install
│   └── mcp_server.py        # read-only MCP server (stdio)
└── references/
    └── mcp_clients.md       # Cursor / Claude Code / Claude Desktop wiring

Часто задаваемые вопросы

Нужно ли мне уметь программировать? Нет. Скопируйте и вставьте подсказку вверху этой страницы в Muse — он сделает всё вместе с вами. Единственное, что вы сделаете сами, — это свяжете Instagram (один тап в браузере) и скачаете файл приложения, который он вам отправит.

Куда уходят мои данные Instagram? Никуда. Код общий, данные остаются дома: ваши сохранённые посты, подписи и данные аккаунта никогда не покидают ваш компьютер. Ничего не загружается к нам — нас не существует; нет сервера, нет аккаунта, нет облака.

Это стоит денег? PIL бесплатен и с открытым исходным кодом (MIT). Нет подписки и не нужно создавать аккаунт. Шаг глубокого чтения ИИ работает через вашу собственную настройку Instagram/AI.

Приложение работает офлайн? Да. После установки настольные и мобильные приложения работают полностью офлайн — поиск, комнаты, теги и ответы работают без интернета.

Какие телефоны и компьютеры поддерживаются? Windows, Mac и Linux для настольного приложения; iPhone и Android для мобильного приложения. На Android нажмите Install app в Chrome; на iPhone используйте Safari Share → Add to Home Screen.

Я сохранил новые посты — как их добавить? Просто скажите своему Muse "Я сохранил новые посты." Он загрузит и глубоко прочитает только новые, затем обновит ваше приложение и файлы.

Могу ли я поделиться своей библиотекой с кем-то? Ваша библиотека — это файлы на вашем компьютере — вы можете скопировать их на чужой компьютер, но они содержат ваши личные данные Instagram. Относитесь к ним как к чему-то приватному: не публикуйте и не загружайте их куда-либо публично.

Что-то не сработало — что теперь? Расскажите своему Muse, что вы видели — он может диагностировать и исправить это напрямую. (Запускаете ручную настройку ниже? Перезапустите установщик — его безопасно запускать любое количество раз — и проверьте, что python3 --version версии 3.11+.)

Устранение неполадок

Что-то не так? Расскажите своему Muse, что произошло — он может диагностировать и исправить большинство проблем сам.

Запускаете ручную настройку сами?

• PIL account_id is not configured → скопируйте пример конфигурации и установите account_id на ваш user_fbid из instagram-cli accounts.
• Извлечение медленное на огромных библиотеках — оно безопасно для повторного запуска; просто перезапустите его.
• Ограничения скорости 429 обрабатываются с помощью backoff внутри скриптов.
• MCP-серверу нужен mcp<2 в Python, который его запускает (2.x переименовал API).

Вклад в проект

PR и issues приветствуются — лучшие подсказки для извлечения, новые клиенты запросов, новые форматы экспорта. Форкните, отправьте, сделайте своим. Если это спасло вас от бесконечной прокрутки, звезда поможет другим найти это.

Лицензия

MIT. Создано Paul Poulose.