Skip to content

coolsam726/pyvelm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

348 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

License

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors