STATE — OhnePapier v0.1

Project Reference

Core value: Every document gets intelligently tagged and searchable, fully offline, on your own hardware — with cloud LLM as an opt-in escape hatch tracked by token cost.

Current milestone: v0.1 — Debian 13 GPU Stack

Philosophy constraint: Local-first, no surveillance, no cloud by default. CKL.md / HHL.md ethical licenses apply.

Current Position

Active phase: Phase 1 — Core Stack
Active plan: None (ready to execute)
Status: Ready to execute — 2 plans in 2 waves

Progress:

Phase 1: Core Stack          [P] Planned (2 plans, ready to execute)
Phase 2: AI Providers        [ ] Not started
Phase 3: Install & Verify    [ ] Not started

Overall: 0/3 phases complete
[                              ] 0%

Phase Summary

Phase Goal Requirements Status
1 — Core Stack Full stack on Debian 13, Ollama containerized, Gitea added STACK-01–05 Planned (2 plans)
2 — AI Providers Switchable provider via env var, token cost logging AI-01–04 Not started
3 — Install & Verify Scripts Bash scripts for install, config, and verification SCRIPT-01–03 Not started

Performance Metrics

Metric Value
Phases total 3
Plans total TBD
Requirements mapped 12/12
Requirements complete 0/12
Phase completion rate 0%

Accumulated Context

Key Decisions

Decision Rationale Status
Containerize Ollama GPU passthrough on Linux is stable; removes host dependency Pending
Add Gitea to stack Self-hosted Git co-located with document store Pending
Cloud LLM as opt-in Privacy-first default; cloud only when explicitly configured + token-budgeted Pending

Technical Notes

  • Current host: macOS with Ollama on host via ollama serve. Target: Debian 13 + NVIDIA GPU.
  • paperless-ai supports Ollama and OpenAI-compatible APIs natively. Anthropic/OpenRouter may require a proxy adapter or env-var shim.
  • Token tracking must log: model name, tokens in, tokens out, estimated USD cost — per document processed via cloud provider.
  • Gitea must be accessible within the Docker network and optionally exposed externally via mapped port.
  • docker-compose.env is NOT committed to git — must be generated from template.

Todos

  • [ ] Determine Anthropic/OpenRouter integration path (native paperless-ai support vs. OpenAI-compatible proxy)
  • [ ] Confirm Gitea port mapping and volume strategy
  • [ ] Draft docker-compose.env.template before writing SCRIPT-03

Blockers

None currently.

Session Continuity

Last updated: 2026-04-17
Last action: Phase 1 planned — 2 plans (01-01, 01-02) in 2 waves
Next action: Run /gsd-execute-phase 1 to execute Phase 1 plans

Environment

  • Working directory: /Users/bmt/Documents/OhnePapier-v.0.0
  • Git branch: main
  • Planning dir: .planning/
  • Config: .planning/config.json (mode: yolo, granularity: coarse)