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 позаботится обо всём.

Что внутри

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.