PIL

Instagram kaydettiklerin — yapay zeka ile derinlemesine okunur, sonsuza dek aranabilir, senin makinennde.

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

mcp-name: io.github.pjpoulose/pil

PIL'i 3 adımda edinin

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

    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. İstediğinde Instagram hesabını bağla (tarayıcında tek dokunuş).

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

Hepsi bu kadar. Kurulumu, okumayı ve oluşturmayı Muse'un yapar. Telefonunda da mı istiyorsun? Sadece Muse'una sor — o da halleder.

Kendin mi yapmak istiyorsun? 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 kütüphaneni Manuel kurulum bölümündeki komutlarla oluştur.

Her gün bir daha asla bulamayacağın gönderiler kaydediyorsun. PIL (Personal Instagram Library), Instagram kaydettiklerini kendi makinennde özel bir bilgi tabanına dönüştürür: her gönderi görüntü yapay zekasıyla 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ından 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. Kaydettiklerin, açıklamaların ve hesap ayrıntıların bilgisayarından 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 kaydedilmesini engeller.

Örnek verilerle konsept taslağı — kütüphanen böyle görünür, senin gönderilerinle.

Claude, Codex veya Cursor'unun buna erişmesini ister misin?

Salt-okunur MCP sunucusunu bağla ve diğer AI araçların kütüphaneni canlı olarak sorgulayabilsin — her zaman güncel, yeniden yüklemeye gerek yok. Muse'un bunu senin 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 (kendin yap)

# 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 sadece kaydettiklerin sekmesinde kaydırmıyorsun?

Kütüphaneni diğer AI araçlarından sor

Canlı (önerilen): MCP. Herhangi bir MCP uyumlu asistanı salt-okunur sunucuya yönlendir; her soru güncel veritabanını 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 her istemci çalışır — ve yapılandırmalara dokunmak istemiyorsan Muse'un senin için bağlayabilir. Kullanılabilir araçlar:

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

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

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

Bu dosyalar kişisel Instagram verilerini içerir — onları kendi makinennde tut ve yalnızca güvendiğin araçlarla paylaş.

Kütüphanen bir uygulama olarak

Muse'un uygulamayı senin için oluşturur ve gönderir — bilgisayarın ve telefonun için. Sadece sor:

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

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

Signal Deck — görsel panel (v1.2.0)

Sorgulamak yerine keşfetmeyi mi tercih edersin? Signal Deck (dashboard/), yerel PIL veritabanından kendi kendine yeten bir HTML paneli oluşturur: kaydettiklerin üzerinde konu halkası kahramanı, arama → sentez (The Brief), kaynaklar rafı, yapışkan dizin ve tam arşiv ızgarası. Tek dosya, çevrimdışı çalışır, verilerin makinennden asla çıkmaz.

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

Ayrıntılar, PWA notları ve QA paketi için dashboard/README.md bölümüne bak.

İçinde 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 bilmem gerekiyor mu? Hayır. Bu sayfanın üstündeki istemi Muse'a kopyala-yapıştır — her şeyi seninle birlikte yapar. Kendin yapacağın tek şeyler Instagram'ı bağlamak (tarayıcında tek dokunuş) ve gönderdiği uygulama dosyasını indirmek.

Instagram verilerim nereye gidiyor? Hiçbir yere. Kod paylaşılır, veri evde kalır: kaydettiklerin, açıklamaların ve hesap ayrıntıların bilgisayarından 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 derin okuma adımı, kendi Instagram/AI kurulumun ü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 dokun; iPhone'da Safari'nin Share → Add to Home Screen özelliğini kullan.

Yeni gönderiler kaydettim — nasıl eklerim? Sadece Muse'una "Yeni gönderiler kaydettim" de. Yalnızca yenilerini getirir ve derinlemesine okur, ardından uygulamanı ve dosyalarını günceller.

Kütüphanemi biriyle paylaşabilir miyim? Kütüphanen makinenndeki dosyalardır — onları başka birinin bilgisayarına kopyalayabilirsin, ancak kişisel Instagram verilerini içerirler. Özel şeyler gibi davran: herhangi bir yere yayınlama veya herkese açık bir yere yükleme.

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

Sorun giderme

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

Manuel kurulumu kendin mi yapıyorsun?

• PIL account_id is not configured → örnek yapılandırmayı kopyala ve account_id değerini instagram-cli accounts içindeki user_fbid değerine ayarla.
• Devasa kütüphanelerde çıkarma yavaştır — devam edilebilir; sadece yeniden çalıştır.
• 429 hız sınırları, komut dosyalarının içinde geri tepme ile ele alınır.
• 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. Çatalla, gönder, kendine ait yap. Seni 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.