OpenFatture is a CLI-first, agentic invoicing workspace for Italian freelancers.
git clone https://github.com/gianlucamazza/openfatture.git
cd openfatture
# Full stack (recommended for development and AI). Core-only: uv sync
uv sync --all-extras
Feature extras (ai, rag, ml) are documented in
CONFIGURATION.md.
uv run openfatture init
The command creates the database, local directories, and optional company, PEC, notification, and AI configuration.
uv run openfatture status
uv run openfatture status --json
Use natural language for business operations:
uv run openfatture assistant "Create an invoice for 3 hours of consulting at 90 euros"
uv run openfatture assistant "List unpaid invoices"
uv run openfatture interactive start
The assistant is the public business interface. Deterministic commands are limited to setup, configuration, diagnostics, and output control.
uv run openfatture config show
uv run openfatture config set ai_provider ollama
uv run openfatture config reload
See CLI_REFERENCE.md for the complete public surface and CONFIGURATION.md for settings.