OpenFatture

OpenFatture is an agentic, CLI-first workspace for Italian electronic invoicing. Describe the work you need; the assistant coordinates the domain tools and returns an auditable result.

Why

Italian freelancers must issue invoices as FatturaPA XML and deliver them through SDI. The usual answer is a SaaS subscription that owns your client list, your invoices, and your archive. OpenFatture keeps all of it local: your data stays in a database on your machine, the XML is generated and validated offline, and every action is recorded in an event audit trail you can inspect. AI assistance is optional — the domain tools work without it.

Built for one-person businesses and small studios comfortable in a terminal.

Start

# Full stack (AI + RAG + ML + …). Core-only: uv sync
uv sync --all-extras
uv run openfatture init
uv run openfatture status
uv run openfatture assistant "Help me prepare an invoice for a software project"

Optional feature extras: ai, rag, ml, all. See docs/CONFIGURATION.md.

AI tools default to a read-only allowlist (AI_ENABLED_TOOLS). SDI/PEC send stays off unless you add send_invoice_to_sdi there, and AI_TOOLS_REQUIRE_CONFIRMATION (default true) requires an explicit human yes before any transmit. The model cannot confirm itself. Interactive TTY sessions may prompt; source="human" with confirmed=True is an API for human-facing callers. No built-in UI uses that path yet (there is no TUI).

For a terminal conversation:

uv run openfatture interactive start

Public CLI

The supported surface is intentionally small:

• init creates local state and guides setup.
• assistant handles business requests in natural language.
• interactive start opens a conversational session.
• config reads or updates configuration.
• status reports local readiness without mutation.

See docs/CLI_REFERENCE.md.

What it covers

• FatturaPA XML generation and validation
• PEC/SDI delivery and notification processing
• Client, invoice, quote, payment, and batch workflows
• Event audit trail, reports, and hooks
• Optional AI assistance (assistant + domain tools), RAG, and forecasting extras

Status

Version 2.4.0, Python 3.12+ and uv. Credit notes (TD04), real XML generation, professional PDF templates, and natura/DatiCassaPrevidenziale support — see docs/STATUS.md, docs/releases/v2.4.0.md, and docs/ARCHITECTURE.md.

Explicit non-goal: there is no browser frontend or web application surface, and adding one would be a separate product decision.

Documentation

• Quick start
• Configuration
• Architecture
• AI architecture
• AI-era redesign
• Current status
• Contributing
• Changelog

Development

uv sync --all-extras
uv run python -m pytest -q
uv run ruff check .
uv run ruff format --check .
uv run mypy openfatture/

OpenFatture is released under the MIT License.