PIL

Instagram kayıtlarınız — yapay zeka ile derinlemesine okunur, sonsuza dek aranabilir, sizin makinenizde.

Başlayın · Nasıl çalışır · Diğer AI araçları · İçeride ne var

mcp-name: io.github.pjpoulose/pil

PIL'i 3 adımda edinin

1. Bunu Muse'a kopyala-yapıştır yapın:

    https://github.com/pjpoulose/PIL'i çalışma alanınıza klonlayın ve
    SKILL.md dosyasını takip ederek Kişisel Instagram Kitaplığımı kurun. Adım adım
    ilerleyin — kurun, kayıtlı gönderilerimden kitaplığı oluşturun ve bana
    kurulabilir uygulamayı verin.

2. İstediğinde Instagram'ınızı bağlayın (tarayıcınızda tek dokunuş).

3. Gönderdiği uygulama dosyasını indirin → zip'ten çıkarın → Start PIL'e çift tıklayın → Install'a tıklayın.

Hepsi bu kadar. Muse'unuz kurulumu, okumayı ve oluşturmayı sizin yerinize yapar. Telefonunuzda da mı istiyorsunuz? Muse'unuza sormanız yeterli — o da bunu halleder.

Kendiniz mi yapmak istiyorsunuz? Tek komut her şeyi kurar.

• 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

Ardından Manuel kurulum bölümündeki komutlarla kitaplığınızı oluşturun.

Her gün bir daha asla bulamayacağınız gönderiler kaydediyorsunuz. PIL (Personal Instagram Library), Instagram kayıtlı koleksiyonunuzu kendi makinenizde özel bir bilgi tabanına dönüştürür: her gönderi görüntü yapay zekası tarafından derinlemesine okunur — anlatı özetleri, ana noktalar, nasıl yapılır adımları, bahsettiği bağlantılar, otomatik etiketler — saniyeler içinde aranabilir ve AI kodlama araçlarınızdan canlı olarak sorgulanabilir.

Kod paylaşılır, veri evde kalır. Bu depo yalnızca kod, veritabanı şeması, yapılandırma örnekleri ve belgeler içerir. Kayıtlı gönderileriniz, başlıklarınız ve hesap ayrıntılarınız bilgisayarınızdan asla çıkmaz — içe aktarma, çıkarma, arama ve MCP sunucusu tamamen yerel olarak çalışır. Bir .gitignore, veritabanlarının, yapılandırmaların ve dışa aktarımların asla işlenmesini engeller.

Örnek verilerle konsept taslağı — kitaplığınız gönderilerinizle böyle görünür.

Claude, Codex veya Cursor'unuzun buna erişmesini ister misiniz?

Salt okunur MCP sunucusunu bağlayın; diğer AI araçlarınız kitaplığınızı canlı sorgulayabilir — her zaman güncel, yeniden yükleme yok. Muse'unuz sizin için bağlayabilir. Nasıl bağlanır →

Nasıl çalışır

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"]

Manuel kurulum (kendiniz yapın)

# 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

Neden kayıtlı sekmenizde gezinmiyorsunuz?

Kitaplığınıza diğer AI araçlarından sorun

Canlı (önerilen): MCP. Herhangi bir MCP uyumlu asistanı salt okunur sunucuya yönlendirin; her soru güncel veritabanınızı okur — her zaman güncel, dışa aktarım yok, yeniden yükleme yok:

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

Claude Code, Claude Desktop ve Cursor için bağlantı: references/mcp_clients.md. MCP uyumlu herhangi bir istemci çalışır — ve yapılandırmalara dokunmak istemiyorsanız Muse'unuz sizin için bağlayabilir. Mevcut araçlar:

Sunucu, veritabanını SQLite mode=ro ile açar ve yalnızca SELECT araçları sunar — kitaplığınızı değiştiremez. (Saldırı testi yapıldı: SQL enjeksiyonu, yazma denemeleri ve limit kötüye kullanımı tümü engellendiği doğrulandı.)

Anlık görüntü: dosya yükleme. Muse'unuzdan size web_data.json dosyasını göndermesini isteyin (export_web.py ile oluşturulur): her gönderi, derinlemesine okuma bilgisiyle tek dosyada. Herhangi bir AI sohbetine (Claude, ChatGPT, …) ekleyin ve herhangi bir belge gibi sorular sorun. Dışa aktarım anında dondurulur — canlı bir bağlantı değil, bir anlık görüntü — bu nedenle yeni gönderiler kaydettikten sonra Muse'unuzdan taze bir kopya isteyin.

Doğrudan (ileri düzey). Veritabanı, <data_dir>/pil.sqlite adresinde düz SQLite'tır (şema schema.sql içinde). Herhangi bir SQLite aracıyla salt okunur olarak açın.

Bu dosyalar kişisel Instagram verilerinizi içerir — bunları kendi makinenizde tutun ve yalnızca güvendiğiniz araçlarla paylaşın.

Kitaplığınız bir uygulama olarak

Muse'unuz uygulamayı sizin için oluşturur ve size gönderir — bilgisayarınız ve telefonunuz için. Sadece isteyin:

• "Bana PIL uygulamamı gönder" — gönderdiği dosyayı indirin, zip'ten çıkarın, Start PIL'e çift tıklayın, Install'a tıklayın. Bilgisayarınızda diğer uygulamalar gibi yaşar ve tamamen çevrimdışı çalışır.
• "PIL'ı telefonuma kur" — yayınlamayı halleder ve size tarayacağınız bir QR kod verir. Install'a dokunun (Android) veya Share → Add to Home Screen (iPhone).

Komut yok, barındırma kurulumu yok, terminal yok — Muse'unuz hepsini halleder.

İçeride ne var

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

SSS

Kod yazmayı bilmem gerekiyor mu? Hayır. Bu sayfanın üstündeki istemi Muse'a kopyala-yapıştır yapın — sizinle her şeyi yapar. Kendiniz yapacağınız tek şey Instagram'ı bağlamak (tarayıcınızda tek dokunuş) ve gönderdiği uygulama dosyasını indirmektir.

Instagram verilerim nereye gidiyor? Hiçbir yere. Kod paylaşılır, veri evde kalır: kayıtlı gönderileriniz, başlıklarınız ve hesap ayrıntılarınız bilgisayarınızdan asla çıkmaz. Bize hiçbir şey yüklenmez — "biz" yok; sunucu yok, hesap yok, bulut yok.

Bir maliyeti var mı? PIL ücretsiz ve açık kaynaktır (MIT). Abonelik yok ve oluşturulacak hesap yok. AI derinlemesine okuma adımı kendi Instagram/AI kurulumunuz üzerinden çalışır.

Uygulama çevrimdışı çalışıyor mu? Evet. Kurulduktan sonra masaüstü ve telefon uygulamaları tamamen çevrimdışı çalışır — arama, odalar, etiketler ve yanıtlar internet olmadan da çalışır.

Hangi telefonlar ve bilgisayarlar? Masaüstü uygulaması için Windows, Mac ve Linux; telefon uygulaması için iPhone ve Android. Android'de Chrome'da Install app'e dokunun; iPhone'da Safari'nin Share → Add to Home Screen özelliğini kullanın.

Yeni gönderiler kaydettim — nasıl eklerim? Muse'unuza "Yeni gönderiler kaydettim" deyin. Yalnızca yeni olanları getirir ve derinlemesine okur, ardından uygulamanızı ve dosyalarınızı yeniler.

Kitaplığımı biriyle paylaşabilir miyim? Kitaplığınız makinenizdeki dosyalardır — bunları başka birinin bilgisayarına kopyalayabilirsiniz, ancak kişisel Instagram verilerinizi içerirler. Özel şeyler gibi davranın: herkese açık hiçbir yerde yayınlamayın veya yüklemeyin.

Bir şey başarısız oldu — şimdi ne olacak? Muse'unuza ne gördüğünüzü söyleyin — teşhis edip doğrudan düzeltebilir. (Aşağıdaki manuel kurulumu mu çalıştırıyorsunuz? Yükleyiciyi yeniden çalıştırın — istediğiniz sayıda çalıştırmak güvenlidir — ve python3 --version sürümünün 3.11+ olduğunu kontrol edin.)

Sorun giderme

Bir sorun mu var? Muse'unuza ne olduğunu söyleyin — çoğu sorunu kendisi teşhis edip düzeltebilir.

Manuel kurulumu kendiniz mi yapıyorsunuz?

• PIL account_id is not configured → örnek yapılandırmayı kopyalayın ve account_id değerini instagram-cli accounts adresindeki user_fbid değerinize ayarlayın.
• Devasa kitaplıklarda çıkarma yavaştır — devam edilebilir; sadece yeniden çalıştırın.
• 429 hız sınırları, komut dosyalarının içinde geri tepme ile işlenir.
• MCP sunucusunun çalıştığı Python'da mcp<2 gerekir (2.x API'yi yeniden adlandırdı).

Katkıda bulunma

PR'ler ve sorunlar memnuniyetle karşılanır — daha iyi çıkarma istemleri, yeni sorgu istemcileri, yeni dışa aktarım biçimleri. Çatallayın, gönderin, kendinize ait yapın. Sizi sonsuz kaydırmadan kurtardıysa, bir yıldız başkalarının bulmasına yardımcı olur.

Lisans

MIT. Paul Poulose tarafından oluşturuldu.