Side-car for paperless-ngx

Tag a document.
Get it back filed.

It reads the documents you tag and writes back a clean title, tags, correspondent and date, using the OCR and language models you bring.

  • Bring your own keys
  • Self-hosted
  • One container
  • No telemetry
scanned · doc #1042
psf-process
filed · understood
Title
Electricity invoice, March 2026
Tags
utilitiesinvoice2026
Correspondent
Vattenfall
Date
2026-03-14

How it works

One tag in. A filed document out.

  1. Tag a document

    Add psf-process in paperless. That one tag is the whole trigger.

  2. OCR

    optional

    A vision model re-reads the scan, or skip it and reuse paperless’s own text.

  3. Extract

    One model call returns the title, tags, correspondent and date.

  4. Apply or review

    Written back to paperless automatically, or queued for your approval.

Re-tag to run a document again. Unchanged content is skipped, so re-runs are free.

Screenshots

A look at the app.

Dashboard in Paperless Starfruit
Dashboard: Queue depth, throughput and recent runs.
Review queue in Paperless Starfruit
Review queue: Suggestions side-by-side with the document.
Tags in Paperless Starfruit
Tags: Give each tag a hint the AI follows.
Prompts in Paperless Starfruit
Prompts: Edit and test the prompts each model receives.
API keys in Paperless Starfruit
API keys: Add, test and mask your provider keys.

Bring your own keys

Use your own API keys.

Connect the providers you already pay for, or a model running on your own hardware.

Anthropic logo
AnthropicClaude Opus 4.5 · Sonnet 4.6 · Haiku 4.5
OpenAI logo
OpenAIGPT-4.1 · GPT-4o · o4-mini
Google logo
GoogleGemini 2.5 Pro · 2.5 Flash
Mistral logo
MistralMistral Large · Pixtral · Mistral OCR
Anything OpenAI-compatibleOllama · LM Studio · vLLM · OpenRouter (local or remote)

Encrypted at rest, and sent straight to the provider, never through us.

Features

Everything it does.

  • Better OCR

    Re-read scans with a vision model when paperless’s own text falls short.

  • Automatic metadata

    A clean title, tags, correspondent and date for every document.

  • Review or auto-apply

    Approve, edit or reject each suggestion, or write it straight back.

  • Prompts you control

    Edit what each model is asked, and test it on a real document first.

  • Any provider

    Anthropic, OpenAI, Google, Mistral, or any local OpenAI-compatible model.

  • Full history

    See the exact prompt sent and the model’s reply behind every run.

Easy to set up. Easy to use.

Free, open source and self-hosted. Connect your keys, tag a document, and let it do the filing for you.