T

fegger 522a6a9867 Move skills reference to mandatory first step in AGENTS.md

- Add 'Mandatory First Step for Agents' section at the top of AGENTS.md.
- Require agents to inspect .agents/skills/ and load all applicable skills before starting work.
- Clarify that skill instructions take precedence over general instructions and that ambiguous or conflicting tasks must stop for user consultation.
- Remove the old bottom 'Skills Reference' section.
- Add 'Any project rule, skill instruction, or requirement is unclear or ambiguous' to the 'When to Ask the User' list.

2026-08-21 14:12:59 +02:00

.agents/skills

Add review skill and make review stage mandatory in AGENTS.md

2026-08-21 14:06:48 +02:00

prompts

Initial scaffold: local invoice OCR pipeline with Ollama, classifier branches, structured extraction, review, and Odoo XML export

2026-08-21 14:04:42 +02:00

scripts

Initial scaffold: local invoice OCR pipeline with Ollama, classifier branches, structured extraction, review, and Odoo XML export

2026-08-21 14:04:42 +02:00

src/odoo_ocr

Initial scaffold: local invoice OCR pipeline with Ollama, classifier branches, structured extraction, review, and Odoo XML export

2026-08-21 14:04:42 +02:00

tests

Initial scaffold: local invoice OCR pipeline with Ollama, classifier branches, structured extraction, review, and Odoo XML export

2026-08-21 14:04:42 +02:00

.gitignore

Add review skill and make review stage mandatory in AGENTS.md

2026-08-21 14:06:48 +02:00

AGENTS.md

Move skills reference to mandatory first step in AGENTS.md

2026-08-21 14:12:59 +02:00

config.yaml

Initial scaffold: local invoice OCR pipeline with Ollama, classifier branches, structured extraction, review, and Odoo XML export

2026-08-21 14:04:42 +02:00

pyproject.toml

Initial scaffold: local invoice OCR pipeline with Ollama, classifier branches, structured extraction, review, and Odoo XML export

2026-08-21 14:04:42 +02:00

README.md

Initial scaffold: local invoice OCR pipeline with Ollama, classifier branches, structured extraction, review, and Odoo XML export

2026-08-21 14:04:42 +02:00

README.md

odoo_ocr

Local-first invoice OCR pipeline that reads scanned, printed, handwritten, and native-PDF invoices and produces Odoo Enterprise-ready XML.

Quick start

Install dependencies:

uv sync --all-extras
# or
pip install -e ".[dev]"

Configure config.yaml or set environment variables:

export OLLAMA_BASE_URL="http://100.103.83.12:11435"

Run the pipeline:

odoo-ocr process /path/to/invoices --output ./out/

Architecture

Input File
  → Classifier (heuristic + small VLM)
    → Branch: digital_pdf      → text/layout extraction
    → Branch: scanned_print    → preprocess → VLM OCR
    → Branch: handwritten      → preprocess → GLM-OCR
    → Branch: mixed_unknown    → preprocess → ensemble OCR
      → Structured Extraction VLM
      → Review VLM (image vs extracted JSON)
        → Confidence check
          → XML Builder
            → Odoo XML + sidecar JSON

Project-specific agent skills

Agent skills are in .agents/skills/:

odoo-ocr-pipeline — classifier, branches, extraction, review.
odoo-xml-import — generating and validating Odoo XML.
local-vlm-client — Ollama/llama.cpp VLM clients and prompts.