PIL

Bài viết đã lưu trên Instagram của bạn — được AI đọc sâu, tìm kiếm vĩnh viễn, trên chính máy của bạn.

Bắt đầu · Cách hoạt động · Công cụ AI khác · Bên trong có gì

mcp-name: io.github.pjpoulose/pil

Nhận PIL trong 3 bước

1. Sao chép-dán đoạn này vào Muse:

    Clone https://github.com/pjpoulose/PIL vào workspace của bạn và làm theo
    SKILL.md của nó để thiết lập Thư viện Instagram Cá nhân của tôi. Làm từng bước một
    — cài đặt, xây dựng thư viện từ các bài viết đã lưu của tôi, và gửi cho tôi
    ứng dụng có thể cài đặt.

2. Khi được yêu cầu, liên kết Instagram của bạn (một lần chạm trong trình duyệt).

3. Tải xuống tệp ứng dụng nó gửi cho bạn → giải nén → nhấp đúp Start PIL → nhấp Install.

Chỉ vậy thôi. Muse của bạn lo việc thiết lập, đọc, và xây dựng. Muốn dùng trên điện thoại nữa? Chỉ cần hỏi Muse của bạn — nó xử lý luôn.

Muốn tự làm? Một lệnh duy nhất thiết lập mọi thứ.

• 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

Sau đó xây dựng thư viện của bạn với các lệnh trong Thiết lập thủ công.

Mỗi ngày bạn lưu những bài viết mà bạn sẽ không bao giờ tìm lại được. PIL (Personal Instagram Library) biến bộ sưu tập đã lưu trên Instagram của bạn thành một cơ sở tri thức riêng tư trên chính máy của bạn: mỗi bài viết được AI thị giác đọc sâu — tóm tắt tường thuật, điểm chính, các bước hướng dẫn, các liên kết nó đề cập, thẻ tự động — tìm kiếm trong vài giây và truy vấn trực tiếp từ các công cụ AI mã hóa của bạn.

Mã nguồn được chia sẻ, dữ liệu ở lại nhà. Kho này chỉ chứa mã nguồn, lược đồ cơ sở dữ liệu, ví dụ cấu hình, và tài liệu. Các bài viết đã lưu, chú thích, và chi tiết tài khoản của bạn không bao giờ rời khỏi máy tính của bạn — nhập liệu, trích xuất, tìm kiếm, và máy chủ MCP đều chạy cục bộ. Một .gitignore chặn cơ sở dữ liệu, cấu hình, và xuất dữ liệu khỏi việc bị commit.

Mô hình khái niệm với dữ liệu mẫu — thư viện của bạn trông như thế này, với các bài viết của bạn.

Muốn Claude, Codex, hoặc Cursor của bạn truy cập vào đây?

Kết nối máy chủ MCP chỉ đọc và các công cụ AI khác của bạn có thể truy vấn thư viện của bạn trực tiếp — luôn cập nhật, không cần tải lên lại. Muse của bạn có thể kết nối cho bạn. Cách kết nối →

Cách hoạt động

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

Thiết lập thủ công (tự làm)

# 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

Tại sao không chỉ cuộn tab đã lưu của bạn?

Hỏi thư viện của bạn từ các công cụ AI khác

Trực tiếp (khuyến nghị): MCP. Trỏ bất kỳ trợ lý tương thích MCP nào vào máy chủ chỉ đọc và mỗi câu hỏi đọc cơ sở dữ liệu hiện tại của bạn — luôn cập nhật, không xuất, không tải lên lại:

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

Kết nối cho Claude Code, Claude Desktop, và Cursor: references/mcp_clients.md. Bất kỳ máy khách tương thích MCP nào đều hoạt động — và Muse của bạn có thể kết nối cho bạn nếu bạn không muốn đụng vào cấu hình. Các công cụ có sẵn:

Máy chủ mở cơ sở dữ liệu với SQLite mode=ro và hiển thị các công cụ chỉ SELECT — nó không thể sửa đổi thư viện của bạn. (Đã kiểm tra tấn công: SQL injection, các nỗ lực ghi, và lạm dụng giới hạn đều được xác minh chặn.)

Ảnh chụp nhanh: tải tệp lên. Yêu cầu Muse của bạn gửi cho bạn tệp web_data.json (được xây dựng với export_web.py): mỗi bài viết với kiến thức đọc sâu của nó trong một tệp. Đính kèm nó vào bất kỳ cuộc trò chuyện AI nào (Claude, ChatGPT, …) và đặt câu hỏi như bất kỳ tài liệu nào. Nó bị đóng băng tại thời điểm xuất — một ảnh chụp nhanh, không phải kết nối trực tiếp — vì vậy hãy yêu cầu Muse của bạn một bản sao mới sau khi bạn lưu bài viết mới.

Trực tiếp (nâng cao). Cơ sở dữ liệu là SQLite thuần tại <data_dir>/pil.sqlite (lược đồ trong schema.sql). Mở nó ở chế độ chỉ đọc với bất kỳ công cụ SQLite nào.

Các tệp này chứa dữ liệu Instagram cá nhân của bạn — giữ chúng trên máy của riêng bạn và chỉ chia sẻ với các công cụ bạn tin tưởng.

Thư viện của bạn dưới dạng ứng dụng

Muse của bạn xây dựng ứng dụng cho bạn và gửi nó cho bạn — cho máy tính của bạn và điện thoại của bạn. Chỉ cần yêu cầu:

• "Gửi cho tôi ứng dụng PIL của tôi" — tải xuống tệp nó gửi cho bạn, giải nén, nhấp đúp Start PIL, nhấp Install. Nó sống trên máy tính của bạn như bất kỳ ứng dụng nào khác và hoạt động hoàn toàn ngoại tuyến.
• "Đặt PIL trên điện thoại của tôi" — nó xử lý việc xuất bản và đưa cho bạn mã QR để quét. Nhấp Install (Android) hoặc Share → Add to Home Screen (iPhone).

Không lệnh, không thiết lập lưu trữ, không terminal — Muse của bạn lo tất cả.

Bên trong có gì

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

Câu hỏi thường gặp

Tôi có cần biết lập trình không? Không. Sao chép-dán lời nhắc ở đầu trang này vào Muse — nó làm mọi thứ với bạn. Điều duy nhất bạn tự làm là liên kết Instagram (một lần chạm trong trình duyệt) và tải xuống tệp ứng dụng nó gửi cho bạn.

Dữ liệu Instagram của tôi đi đâu? Không đâu. Mã nguồn được chia sẻ, dữ liệu ở lại nhà: các bài viết đã lưu, chú thích, và chi tiết tài khoản của bạn không bao giờ rời khỏi máy tính của bạn. Không có gì được tải lên cho chúng tôi — không có "chúng tôi"; không có máy chủ, không tài khoản, không đám mây.

Có tốn phí không? PIL miễn phí và mã nguồn mở (MIT). Không có đăng ký và không cần tạo tài khoản. Bước đọc sâu AI chạy qua thiết lập Instagram/AI của riêng bạn.

Ứng dụng hoạt động ngoại tuyến không? Có. Sau khi cài đặt, ứng dụng máy tính để bàn và điện thoại chạy hoàn toàn ngoại tuyến — tìm kiếm, phòng, thẻ, và câu trả lời đều hoạt động mà không cần internet.

Những điện thoại và máy tính nào? Windows, Mac, và Linux cho ứng dụng máy tính để bàn; iPhone và Android cho ứng dụng điện thoại. Trên Android, nhấp Install app trong Chrome; trên iPhone, dùng Safari's Share → Add to Home Screen.

Tôi đã lưu bài viết mới — làm sao để thêm chúng? Chỉ cần nói với Muse của bạn "Tôi đã lưu bài viết mới." Nó tìm nạp và đọc sâu chỉ những bài mới, sau đó làm mới ứng dụng và tệp của bạn.

Tôi có thể chia sẻ thư viện của mình với người khác không? Thư viện của bạn là các tệp trên máy của bạn — bạn có thể sao chép chúng sang máy tính của người khác, nhưng chúng chứa dữ liệu Instagram cá nhân của bạn. Hãy đối xử với chúng như bất cứ thứ gì riêng tư: đừng công bố hoặc tải lên bất cứ nơi công cộng nào.

Có gì đó thất bại — giờ sao? Nói với Muse của bạn những gì bạn thấy — nó có thể chẩn đoán và sửa trực tiếp. (Đang chạy thiết lập thủ công bên dưới? Chạy lại trình cài đặt — an toàn để chạy bất kỳ số lần nào — và kiểm tra python3 --version là 3.11+.)

Xử lý sự cố

Có gì sai? Nói với Muse của bạn những gì đã xảy ra — nó có thể chẩn đoán và sửa hầu hết các vấn đề tự nó.

Tự chạy thiết lập thủ công?

• PIL account_id is not configured → sao chép cấu hình ví dụ và đặt account_id thành user_fbid của bạn từ instagram-cli accounts.
• Trích xuất chậm trên các thư viện lớn — nó an toàn để tiếp tục; chỉ cần chạy lại.
• 429 giới hạn tốc độ được xử lý với backoff bên trong các tập lệnh.
• Máy chủ MCP cần mcp<2 trong Python chạy nó (2.x đổi tên API).

Đóng góp

PR và issue được hoan nghênh — lời nhắc trích xuất tốt hơn, máy khách truy vấn mới, định dạng xuất mới. Fork nó, gửi nó, làm nó của bạn. Nếu nó cứu bạn khỏi cuộn không ngừng, một ngôi sao giúp người khác tìm thấy nó.

Giấy phép

MIT. Được xây dựng bởi Paul Poulose.