Skip to content

Latest commit

 

History

348 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PyVELM

CI codecov PyPI version Python Downloads Documentation Changelog License: LGPL v3 GitHub Sponsors

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 SQLAlchemy-backed databases (PostgreSQL, SQLite, MySQL/MariaDB, SQL Server, Oracle, and other supported dialects): 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.

Backend matrix and DSN examples: docs/multi-database.md.

Latest: v1.4.6 — Filament-style schema field reactivity on forms. See the docs (version picker for older releases).

Full documentation: coolsam726.github.io/pyvelm

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

Install

pip install pyvelm==1.4.6

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).

About

PyVELM is a declarative Python ERP Framework on PostgreSQL: 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.

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages