Requirements — OhnePapier v0.1

v1 Requirements

Stack Composition

• [ ] STACK-01: Docker Compose file runs the full stack on Debian 13 with a single docker compose up -d
• [ ] STACK-02: Ollama runs inside a container with NVIDIA GPU passthrough via nvidia-container-toolkit
• [ ] STACK-03: Gitea runs as a container in the same Compose network
• [ ] STACK-04: Paperless-ngx, PostgreSQL, Redis, paperless-ai remain as current services
• [ ] STACK-05: All services communicate via Docker internal network (no host-side dependencies)

AI Provider

• [ ] AI-01: AI provider is switchable via environment variable (ollama / anthropic / openrouter)
• [ ] AI-02: Anthropic API works as drop-in alternative to Ollama for paperless-ai processing
• [ ] AI-03: OpenRouter API works as drop-in alternative to Ollama for paperless-ai processing
• [ ] AI-04: Token usage (model, tokens in/out, estimated cost) logged per document when using cloud providers

Install & Verify

• [ ] SCRIPT-01: Bash script (setup.sh) checks prerequisites (Docker, nvidia-container-toolkit, GPU visibility) and installs the stack
• [ ] SCRIPT-02: Bash script tests the running stack (all containers healthy, Ollama GPU accessible, Paperless API responding, Gitea reachable)
• [ ] SCRIPT-03: Bash script generates initial config (docker-compose.env from template) with prompts for required secrets

v2 Requirements (deferred)

• OZMBridge / FPGA integration (#ozm)
• Custom Fields in Paperless-ngx
• Vector-Bridge to Eule/Qdrant

Out of Scope

• AMD/ROCm GPU support — NVIDIA only for v0.1
• Cloud-hosted deployment — local-first only
• paperless-ai source modifications — config-layer only

Traceability