pyvelm 1.0.0

PyVELM — declarative Python ERP: Odoo recordsets & modules, Laravel/Filament ergonomics, unique Tailwind admin shell.

PyVELM

Odoo's semantics. Laravel's ergonomics. Filament's craft — in a Tailwind-native ERP shell that exists only here.

PyVELM is a declarative Python ERP on PostgreSQL or SQLite (SQLAlchemy Core): recordsets and modules in the Odoo tradition, developer and admin patterns borrowed from Laravel and Filament, and a bespoke Tailwind v4 + HTMX interface—its own layout, widgets, and look & feel—not Odoo's web client or Filament's Blade stack.

v1.0 adds a portable database layer, Laravel-style seeders, and declarative Schema migrations. See the docs (version picker for 1.0 vs 0.26).

Full documentation: coolsam726.github.io/pyvelm

The framework is PyVELM; the PyPI package and CLI stay pyvelm (lowercase).

Install

pip install pyvelm

Greenfield app:

pipx install pyvelm
pyvelm init my_erp

Hack on the repo

git clone https://github.com/coolsam726/pyvelm.git
cd pyvelm
python3 -m venv .venv && .venv/bin/pip install -e .
cp .env.example .env   # set PYVELM_DSN
.venv/bin/python examples/basic.py

Contributing, tests (pip install -e ".[test]" && pytest), local docs (mkdocs serve), and releases: CONTRIBUTING.md. Maintainer notes: CHANGELOG.md · CONTEXT.md.

Sponsor

Open-source business-app tooling maintained by Sam Maosa. Sponsor on GitHub supports all of these projects—not just PyVELM.

	Project
This repo	PyVELM — declarative Python ERP
1	filament-modules — Filament + nWidart/laravel-modules
2	flatpickr — Flatpickr date picking for Filament
3	nested-comments — nested comments on Filament forms & pages
4	typeorm-pagination — pagination for Express + TypeORM
5	filament-signature-pad — signature field for Filament forms

Same craft across stacks: admin UX that feels intentional, released in the open with docs and tests. If any of this saves you a sprint, sponsorship keeps it sustainable.

License

LGPL-3.0-or-later — Copyright (c) 2026 Sam Maosa.
If you link against or modify PyVELM, see the license file for your obligations (shared library / combined work terms).