PaperPilot – WASM ve MCP Destekli, Bulutsuz ve Saf Rust Tabanlı PDF Motoru

PaperPilot Nedir?#

PaperPilot, hem yapay zeka ajanlarınız (AI agents) hem de sizin için tasarlanmış, tamamen Rust diliyle yazılmış yerel bir PDF ve belge araç setidir. Tamamen yerel olarak çalışır ve dosyalarınız asla bilgisayarınızdan dışarı çıkmaz. Chromium bağımlılığına, C++ çalışma zamanına (runtime) veya bulut çağrılarına ihtiyaç duymaz.

Yazılım geliştirme ve mimari açıdan PaperPilot, tek bir çekirdek motorun (core engine) farklı çalışma yüzeylerine nasıl taşınabileceğinin mükemmel bir örneğini sunar. Aynı Rust motoru şu 5 farklı yüzeyde çalışabilir:

MCP Sunucusu (MCP Server): Claude Desktop, Cursor veya herhangi bir MCP istemcisine PDF birleştirme, bölme, OCR ve sıkıştırma yetenekleri kazandırır. Edumints üzerindeki Hazır MCP Sunucuları ve Ekosistem ile MCP'nin Temel İlkeleri: Tools, Resources ve Prompts modüllerinde ele alındığı üzere, yerel araçları ajanlara bağlamak veri gizliliğini korurken ajan kabiliyetlerini doğrudan artırır.
CLI (Komut Satırı Arayüzü): Toplu işlemler (batch) ve betik tabanlı (scripted) otomasyon iş akışları için kullanılır.
Tarayıcı (WASM): Kurulum gerektirmeyen araçlar sunar; dosyalar doğrudan tarayıcı belleğinde işlenir ve sunucuya hiçbir veri yüklenmez.
Masaüstü Uygulaması (Desktop App): Görüntüleyici, işaretleme (markup) ve karşılaştırma (diff) özelliklerine sahip Tauri + Svelte tabanlı grafiksel kullanıcı arayüzü sunar.
Yerel REST API: Python, Node veya n8n üzerinden localhost:7823 adresinden çağrılabilir.

Hızlı Başlangıç (Quick Start)#

Geliştiriciler için farklı entegrasyon senaryolarına göre 4 temel başlangıç adımı bulunmaktadır:

1. Claude / Cursor ile Kullanım (MCP)#

Releases sayfasından paperpilot-mcp dosyasını indirin ve claude_desktop_config.json yapılandırma dosyanıza ekleyin:

{
  "mcpServers": {
    "paperpilot": {
      "command": "/path/to/paperpilot-mcp"
    }
  }
}

Claude'u yeniden başlatın ve şunu deneyin: "Bu iki PDF'i birleştir ve sonucu sıkıştır." Bu pratik entegrasyon, Tool Calling ve Multi-Step Agent'lar yaklaşımının yerel dosya sisteminde güvenli ve sıfır bulut maliyetiyle nasıl çalıştığını gösterir.

2. CLI Kullanımı#

Komut satırı üzerinden temel belge işlemlerini doğrudan betiklerinize dahil edebilirsiniz:

# Birleştirme (Merge)
paperpilot merge --inputs doc1.pdf doc2.pdf --output merged.pdf

# Sıkıştırma (Compress)
paperpilot compress --input in.pdf --quality 75 --output compressed.pdf

# 1 ve 3-5 arası sayfaları 90° döndürme (Rotate)
paperpilot rotate --input in.pdf --pages 1,3-5 --angle 90 --output out.pdf

3. Tarayıcıda Kullanım#

Doğrudan usepaperpilot.com adresine gidin. Çalışırken tarayıcınızın Network (Ağ) sekmesini açtığınızda hiçbir dosya yüklemesi (upload) yapılmadığını görebilirsiniz. WebAssembly (WASM) sayesinde ağır PDF işlemleri istemci tarafında (client-side) güvenle gerçekleştirilir.

4. Kaynak Koddan Derleme (Build from Source)#

Projeyi kendi ortamınızda derlemek ve modüler paket yapısını (paperpilot-cli, paperpilot-mcp, paperpilot-gateway) incelemek için şu komutları çalıştırabilirsiniz:

git clone https://github.com/KrushnaVardhanReddy/PaperPilot.git
cd PaperPilot
cargo build --release -p paperpilot-cli -p paperpilot-mcp -p paperpilot-gateway

Masaüstü uygulaması için ise cd apps/desktop && pnpm install adımlarını takip edebilirsiniz. Rust çalışma alanı (workspace) mimarisi, tek bir kod tabanından hem sistem seviyesinde ikili dosyalar (binaries) hem de modern arayüzler üretmek isteyen geliştiriciler için güçlü bir referans niteliğindedir.