paperless

Paperless to umiejętność do integracji z systemem zarządzania dokumentami Paperless-NGX. Pozwala wyszukiwać dokumenty po nazwie, dacie, tagach i korespondentach, pobierać je w oryginale lub przetworzonym formacie, a także przesyłać nowe pliki do archiwum. Wszystko odbywa się przez interfejs wiersza poleceń ppls, bez konieczności otwierania przeglądarki. Idealna dla użytkowników, którzy chcą zautomatyzować pracę z dokumentami w swoich agentach AI lub skryptach.

1. Zainstaluj narzędzie ppls za pomocą npm lub bun, uruchamiając polecenie npm install -g @nickchristensen/ppls. Upewnij się, że masz zainstalowany Node.js.

2. Skonfiguruj połączenie z serwerem Paperless-NGX, ustawiając nazwę hosta i token API. Uruchom ppls config set hostname http://twoj-serwer-paperless oraz ppls config set token twoj-token-api. Token znajdziesz w ustawieniach użytkownika w Paperless.

3. Wyszukaj dokumenty za pomocą filtrów — możesz szukać po nazwie (ppls documents list --name-contains "faktura" --json), dacie utworzenia (--created-after 2024-01-01), tagach (--tag 5) lub korespondentach (--correspondent 7). Połącz wiele filtrów w jedno polecenie, aby zawęzić wyniki.

4. Pobierz znalezione dokumenty, podając ich identyfikator — ppls documents download 1234 --output ~/Pobrane/dokument.pdf pobiera pojedynczy plik, a ppls documents download 1234 5678 --output-dir ~/Pobrane pobiera wiele plików naraz. Użyj flagi --original, aby pobrać wersję przed przetworzeniem.

5. Przesyłaj nowe dokumenty do archiwum poleceniem ppls documents add plik.pdf — Paperless automatycznie je przetworzy, wyodrębni tekst i przypisze metadane.