ArtBudgeteer

Commission quoting tool for independent fine artists — built with Python and GTK 4 / libadwaita.

---

What it does

ArtBudgeteer helps fine artists produce accurate commission quotes that account for all hidden costs and production phases, protecting against undercharging and scope creep.

• Cost calculation engine — interdependent pricing across surface area, technique, character complexity, background, and materials
• Multi-piece commissions — quote diptychs, series, or any set of pieces in a single commission
• Material contingency — per-piece and commission-level material buffers automatically applied
• Rush fee and new-client buffer — optional surcharges built into the quote
• IVA support — configurable tax rate applied to the final total
• Reference images — attach a reference image per piece, embedded in exports
• Client proposals — export clean HTML proposals (self-contained, print-ready) or Markdown
• CSV and JSON export — full data backup and spreadsheet-friendly export
• Setup wizard — guided first-run configuration for hourly rate, currency, and payment templates

---

Screenshots

Coming soon.

---

Installation

Flatpak (recommended)

Download the latest .flatpak bundle from Releases and install:

flatpak install com.carlosm.ArtBudgeteer.flatpak
flatpak run com.carlosm.ArtBudgeteer

Requires the GNOME 49 runtime.

From source

Requirements: Python 3.11+, GTK 4, libadwaita 1.x

git clone https://github.com/reelmesh/ArtBudgeteer.git
cd ArtBudgeteer
pip install -e .
PYTHONPATH=src python -m artbudgeteer

---

Building the Flatpak

flatpak install flathub org.gnome.Platform//49 org.gnome.Sdk//49
flatpak-builder --force-clean --user --install build-dir com.carlosm.ArtBudgeteer.yaml

Export a distributable bundle:

flatpak build-bundle ~/.local/share/flatpak/repo com.carlosm.ArtBudgeteer.flatpak com.carlosm.ArtBudgeteer

---

Running tests

pip install pytest
PYTHONPATH=src pytest tests/

---

Project structure

src/artbudgeteer/
  models/         commission, quote, and settings data models
  quote/          pricing calculator engine
  ui/             GTK 4 / libadwaita interface
  database.py     SQLite schema and migrations
  export.py       CSV, JSON, Markdown, and HTML proposal exporters
  images.py       reference image storage helpers
data/             desktop entry, app icon, metainfo

---

License

GPL-3.0-or-later — see LICENSE.