celerp 2.5.6__tar.gz → 2.6.0__tar.gz

celerp-2.6.0/LICENSING.md

@@ -0,0 +1,43 @@
+# Licensing
+
+Celerp is free to download, self-host, and use to run your own business. Different
+components use different licenses, as mapped below.
+
+Celerp is multi-licensed. This file is the authoritative map of which license applies to which part of
+the repository. Where a source file carries an `SPDX-License-Identifier` header, that header is the
+operative statement for that file; this map governs by path otherwise.
+
+| Path | License | Text |
+|---|---|---|
+| `celerp/` (engine/kernel) | Business Source License 1.1 | `LICENSE` |
+| `celerp/gateway/`, `celerp/session_gate.py`, `celerp/ai/`, `celerp/cloud/` | Celerp Official Components License (LicenseRef-Proprietary) | `legal/OFFICIAL-COMPONENTS.md` |
+| `celerp/output/` (official document/PDF + public share renderers) | Celerp Official Components License (LicenseRef-Proprietary) | `legal/OFFICIAL-COMPONENTS.md` |
+| `celerp/output/fonts/` (DejaVu Sans, bundled for PDFs) | Bitstream Vera Fonts license; DejaVu changes public domain | `celerp/output/fonts/LICENSE` |
+| `ui/` (application UI layer) | Celerp Official Components License (LicenseRef-Proprietary) | `legal/OFFICIAL-COMPONENTS.md` |
+| `default_modules/celerp-admin/` | Business Source License 1.1 | `LICENSE` |
+| `default_modules/celerp-ai/`, `celerp-backup/`, `celerp-connectors/` | Celerp Official Components License (LicenseRef-Proprietary) | `legal/OFFICIAL-COMPONENTS.md` |
+| `default_modules/celerp-accounting/` | MIT | module `LICENSE` |
+| `default_modules/celerp-contacts/` | MIT | module `LICENSE` |
+| `default_modules/celerp-dashboard/` | MIT | module `LICENSE` |
+| `default_modules/celerp-docs/` | MIT | module `LICENSE` |
+| `default_modules/celerp-inventory/` | MIT | module `LICENSE` |
+| `default_modules/celerp-labels/` | MIT | module `LICENSE` |
+| `default_modules/celerp-manufacturing/` | MIT | module `LICENSE` |
+| `default_modules/celerp-reports/` | MIT | module `LICENSE` |
+| `default_modules/celerp-subscriptions/` | MIT | module `LICENSE` |
+| `default_modules/celerp-verticals/` | MIT | module `LICENSE` |
+
+Notes:
+- The BSL components use the SPDX identifier `BUSL-1.1` (the official short identifier for Business
+  Source License 1.1). They are source-available, not open source, until the Change Date, on which they
+  convert to the Change License stated in `LICENSE` (Apache-2.0), at the latest. BUSL also converts the
+  fourth anniversary of each version's first public distribution, whichever is earlier.
+- The MIT modules depend on the BUSL-1.1 engine at runtime; redistributing an MIT module does not change
+  the license of the engine it requires, and using the engine remains governed by `LICENSE`.
+- **Attribution:** the "Powered by Celerp" mark is produced and required by the proprietary components
+  (the official UI and document/PDF rendering layer) and the Cloud Services agreement. It is NOT imposed
+  by the MIT modules - MIT cannot carry that restriction. See `legal/OFFICIAL-COMPONENTS.md`.
+- Trademarks are not licensed by any of the above; see `legal/TRADEMARK.md`.
+- Third-party dependencies retain their own licenses.
+
+Copyright (c) 2026 Noah Severs.

celerp-2.6.0/PKG-INFO

@@ -0,0 +1,402 @@
+Metadata-Version: 2.4
+Name: celerp
+Version: 2.6.0
+Summary: Free, self-hosted ERP for small businesses
+License: Business Source License 1.1
+        
+        License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+        "Business Source License" is a trademark of MariaDB Corporation Ab.
+        
+        -----------------------------------------------------------------------------
+        
+        Parameters
+        
+        Licensor:             Noah Severs
+        Licensed Work:        Celerp
+                              The Licensed Work is (c) 2026 Noah Severs
+        Additional Use Grant: You may use the Licensed Work in production to operate
+                              Celerp for your own internal business purposes, including
+                              self-hosted use by your company and its affiliates. This
+                              Additional Use Grant does not include offering the Licensed
+                              Work, modified versions of the Licensed Work, or a
+                              substantially similar competing product as a hosted service,
+                              SaaS service, managed service, OEM product, or white-label
+                              product to third parties without a commercial agreement with
+                              Licensor.
+        
+        Change Date:          2029-01-01
+        
+        Change License:       Apache License, Version 2.0
+        
+        For information about alternative licensing arrangements for the Licensed Work
+        (including commercial licensing, OEM agreements, and white-label inquiries),
+        please contact https://celerp.com.
+        
+        -----------------------------------------------------------------------------
+        
+        Notice
+        
+        The Business Source License (this document, or the "License") is not an Open
+        Source license. However, the Licensed Work will eventually be made available
+        under an Open Source License, as stated in this License.
+        
+        -----------------------------------------------------------------------------
+        
+        Terms
+        
+        The Licensor hereby grants you the right to copy, modify, create derivative
+        works, redistribute, and make non-production use of the Licensed Work. The
+        Licensor may make an Additional Use Grant, above, permitting limited production
+        use.
+        
+        Effective on the Change Date, or the fourth anniversary of the first publicly
+        available distribution of a specific version of the Licensed Work under this
+        License, whichever comes first, the Licensor hereby grants you rights under
+        the terms of the Change License, and the rights granted in the paragraph
+        above terminate.
+        
+        If your use of the Licensed Work does not comply with the requirements
+        currently in effect as described in this License, you must purchase a
+        commercial license from the Licensor, its affiliated entities, or authorized
+        resellers, or you must refrain from using the Licensed Work.
+        
+        All copies of the original and modified Licensed Work, and derivative works of
+        the Licensed Work, are subject to this License. This License applies
+        separately for each version of the Licensed Work and the Change Date may vary
+        for each version of the Licensed Work released by Licensor.
+        
+        You must conspicuously display this License on each original or modified copy
+        of the Licensed Work. If you receive the Licensed Work in original or modified
+        form from a third party, the terms and conditions set forth in this License
+        apply to your use of that work.
+        
+        Any use of the Licensed Work in violation of this License will automatically
+        terminate your rights under this License for the current and all other
+        versions of the Licensed Work.
+        
+        This License does not grant you any right in any trademark or logo of Licensor
+        or its affiliates (provided that you may use a trademark or logo of Licensor
+        as expressly required by this License).
+        
+        TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+        "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+        OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+        
+        MariaDB hereby grants you permission to use this License's text to license
+        your works, and to refer to it using the trademark "Business Source License",
+        as long as you comply with the Covenants of Licensor below.
+        
+        -----------------------------------------------------------------------------
+        
+        Covenants of Licensor
+        
+        In consideration of the right to use this License's text and the "Business
+        Source License" name and trademark, Licensor covenants to MariaDB, and to all
+        other recipients of the licensed work to be provided by Licensor:
+        
+        1. To specify as the Change License the GPL Version 2.0 or any later version,
+           or a license that is compatible with GPL Version 2.0 or a later version,
+           where "compatible" means that software provided under the Change License can
+           be included in a program with software provided under GPL Version 2.0 or a
+           later version. Licensor may specify additional Change Licenses without
+           limitation.
+        
+        2. To either: (a) specify an additional grant of rights to use that does not
+           impose any additional restriction on the right granted in this License, as
+           the Additional Use Grant; or (b) insert the text "None".
+        
+        3. To specify a Change Date.
+        
+        4. Not to modify this License in any other way.
+        
+Project-URL: Homepage, https://celerp.com
+Project-URL: Repository, https://github.com/celerp/celerp
+Project-URL: Documentation, https://celerp.com/docs
+Keywords: erp,inventory,accounting,self-hosted,fastapi
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: aiofiles==25.1.0
+Requires-Dist: aiosmtplib==5.1.3
+Requires-Dist: alembic==1.20.0
+Requires-Dist: annotated-doc==0.0.5
+Requires-Dist: annotated-types==0.8.0
+Requires-Dist: anyio==4.15.1
+Requires-Dist: async-timeout==5.0.1; python_full_version < "3.11"
+Requires-Dist: asyncpg==0.32.0
+Requires-Dist: bcrypt==5.0.0
+Requires-Dist: beautifulsoup4==4.15.0
+Requires-Dist: celerp-postgres==17.10.0; (platform_machine == "aarch64" and sys_platform == "linux") or (platform_machine == "x86_64" and sys_platform == "linux") or (platform_machine == "AMD64" and sys_platform == "win32")
+Requires-Dist: certifi==2026.7.22
+Requires-Dist: cffi==2.1.1; platform_python_implementation != "PyPy"
+Requires-Dist: charset-normalizer==3.5.2
+Requires-Dist: click==8.5.0
+Requires-Dist: colorama==0.4.6; sys_platform == "win32"
+Requires-Dist: cryptography==48.0.1; platform_machine == "x86_64" and sys_platform == "darwin"
+Requires-Dist: cryptography==50.0.2; platform_machine != "x86_64" or sys_platform != "darwin"
+Requires-Dist: deprecated==1.3.1; python_full_version < "3.12"
+Requires-Dist: deprecated==3.0.0; python_full_version >= "3.12"
+Requires-Dist: ecdsa==0.19.2
+Requires-Dist: et-xmlfile==2.0.0
+Requires-Dist: exceptiongroup==1.3.1; python_full_version < "3.11"
+Requires-Dist: fastapi==0.143.0
+Requires-Dist: fastcore==2.2.33
+Requires-Dist: greenlet==3.5.6
+Requires-Dist: h11==0.16.0
+Requires-Dist: httpcore==1.0.9
+Requires-Dist: httpcore2==2.13.1; sys_platform != "emscripten"
+Requires-Dist: httptools==0.9.0
+Requires-Dist: httpx==0.28.1
+Requires-Dist: httpx2==2.13.1
+Requires-Dist: httpx2-jsfetch==1.0; python_full_version >= "3.12" and sys_platform == "emscripten"
+Requires-Dist: idna==3.20
+Requires-Dist: itsdangerous==2.2.0
+Requires-Dist: limits==5.8.0
+Requires-Dist: mako==1.4.3
+Requires-Dist: markupsafe==3.0.4
+Requires-Dist: numpy==2.2.6; python_full_version < "3.11"
+Requires-Dist: numpy==2.4.6; python_full_version == "3.11.*"
+Requires-Dist: numpy==2.5.4; python_full_version >= "3.12"
+Requires-Dist: oauthlib==4.0.0
+Requires-Dist: openpyxl==3.1.5
+Requires-Dist: opentelemetry-api==1.45.1
+Requires-Dist: packaging==26.3
+Requires-Dist: passlib==1.7.4
+Requires-Dist: pillow==12.3.0
+Requires-Dist: psutil==7.2.2
+Requires-Dist: psycopg2-binary==2.9.13
+Requires-Dist: pyasn1==0.6.4
+Requires-Dist: pycparser==3.11; implementation_name != "PyPy" and platform_python_implementation != "PyPy"
+Requires-Dist: pydantic==2.14.1
+Requires-Dist: pydantic-core==2.50.1
+Requires-Dist: pydantic-settings==2.15.0
+Requires-Dist: pypdf==6.20.0
+Requires-Dist: python-barcode==0.16.1
+Requires-Dist: python-dateutil==2.9.0.post0
+Requires-Dist: python-dotenv==1.2.4
+Requires-Dist: python-fasthtml==0.14.13
+Requires-Dist: python-jose==3.5.0
+Requires-Dist: python-multipart==0.0.32
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: qrcode==8.2
+Requires-Dist: reportlab==5.0.1
+Requires-Dist: rsa==4.9.1
+Requires-Dist: six==1.17.0
+Requires-Dist: slowapi==0.1.10
+Requires-Dist: soupsieve==2.10; python_full_version < "3.11.5"
+Requires-Dist: soupsieve==3.0.2; python_full_version >= "3.11.5"
+Requires-Dist: sqlalchemy==2.0.54; python_full_version < "3.11"
+Requires-Dist: sqlalchemy==2.1.4; python_full_version >= "3.11"
+Requires-Dist: starlette==1.7.0
+Requires-Dist: tomli==2.5.0; python_full_version < "3.11"
+Requires-Dist: truststore==0.10.4; sys_platform != "emscripten"
+Requires-Dist: typing-extensions==4.16.0
+Requires-Dist: typing-inspection==0.4.4
+Requires-Dist: tzdata==2026.5
+Requires-Dist: uvicorn==0.54.0
+Requires-Dist: uvloop==0.23.0; platform_python_implementation != "PyPy" and sys_platform != "cygwin" and sys_platform != "win32"
+Requires-Dist: watchfiles==1.3.0
+Requires-Dist: websockets==16.1.1; python_full_version < "3.11"
+Requires-Dist: websockets==17.2; python_full_version >= "3.11"
+Requires-Dist: wrapt==2.5.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: aiosqlite>=0.20; extra == "dev"
+Requires-Dist: faker>=24.0; extra == "dev"
+Requires-Dist: respx>=0.21; extra == "dev"
+Requires-Dist: playwright<1.62,>=1.43; extra == "dev"
+Requires-Dist: pytest-playwright>=0.5; extra == "dev"
+Requires-Dist: pytest-timeout>=2.3; extra == "dev"
+Requires-Dist: pytest-xdist>=3.5; extra == "dev"
+Requires-Dist: testcontainers[postgres]>=4.0; extra == "dev"
+Provides-Extra: prod
+Requires-Dist: gunicorn==26.2.0; extra == "prod"
+Dynamic: license-file
+
+# Celerp
+
+**Free business management software for you and your office. Setup in minutes. Easy enough for solo entrepreneurs and powerful enough for large enterprises**
+
+Inventory, invoicing, purchasing, consignment, manufacturing, accounting, and CRM - in one app, on your computer. No subscription. No cloud required.
+
+Website: [www.celerp.com](https://www.celerp.com)
+
+Celerp is simple to use, flexible, customizable, and designed to transition your business into the AI age with no technical knowledge needed to setup your whole office. We want to put businesses back in charge of their data.
+
+[![Downloads](https://static.pepy.tech/badge/celerp)](https://pepy.tech/project/celerp)
+[![Tests](https://github.com/celerp/celerp/actions/workflows/ci.yml/badge.svg)](https://github.com/celerp/celerp/actions)
+[![License](https://img.shields.io/badge/license-BUSL--1.1-blue)](LICENSE)
+
+<!-- PRESS_KIT:root-hero start -->
+![Celerp manufacturing cost worksheet](docs/press-kit/screenshots/manufacturing-worksheet.png)
+<!-- PRESS_KIT:root-hero end -->
+
+## Screenshots
+
+Real double-entry accounting, multi-location inventory, manufacturing, and a built-in REST API - one self-hosted app.
+
+<!-- PRESS_KIT:root-grid start -->
+| | |
+|---|---|
+| ![Dashboard with revenue trend, receivables aging, and inventory mix](docs/press-kit/screenshots/dashboard.png)<br>**Dashboard** - revenue trend, AR aging, inventory mix | ![Multi-location inventory with barcode scanning and valuation](docs/press-kit/screenshots/inventory.png)<br>**Inventory** - multi-location, barcode, valuation |
+| ![Double-entry trial balance that ties out to zero](docs/press-kit/screenshots/trial-balance.png)<br>**Trial balance** - ties out to zero | ![Balance sheet generated from the event-sourced ledger](docs/press-kit/screenshots/balance-sheet.png)<br>**Balance sheet** - live from the ledger |
+| ![Production planning by status, priority, and due date](docs/press-kit/screenshots/production-planning.png)<br>**Production planning** - work orders, priorities, due dates | ![International shipping document with commercial invoice and customs detail](docs/press-kit/screenshots/international-shipping-document.png)<br>**Shipping documents** - commercial invoice and customs |
+| ![Built-in REST API for integrations](docs/press-kit/screenshots/rest-api.png)<br>**REST API** - integrate anything | ![Customer statement of account showing receivables](docs/press-kit/screenshots/statement-of-account.png)<br>**Statement of account** - customer AR at a glance |
+<!-- PRESS_KIT:root-grid end -->
+
+More in the [press kit](docs/press-kit/).
+
+---
+
+## Install
+
+| Platform | Link |
+|----------|------|
+| Windows (.exe) | [Download](https://celerp.com/download-thanks.html?dl=win) |
+| Linux (.deb) | [Download](https://celerp.com/download-thanks.html?dl=linux) |
+| macOS (.dmg) | [Download](https://celerp.com/download-thanks.html?dl=mac) |
+
+**Double-click. No account. No credit card. Your computer securely becomes the server for your office**
+
+Or install via pip:
+
+```bash
+pip install celerp
+celerp init        # sets up the database and launches Celerp
+```
+
+Open **http://localhost:8080** and enter the one-time setup code `celerp init` printed on the first sign-up page.
+Your office can securely access the system at your IP address :8080.
+
+No PostgreSQL to install: `celerp init` uses your existing PostgreSQL server if one is
+running, and otherwise starts a self-contained bundled database — no `sudo`, no system
+service. Point it at a specific server with `celerp init --db-url postgresql+asyncpg://…`.
+
+Running headless or under a process manager? Use `celerp init --no-start` to set up
+without launching, then have your service run `celerp start` — see
+[Run as a service (systemd)](CONTRIBUTING.md#run-as-a-service-systemd).
+Updates install automatically overnight; the owner can turn that off from the update
+card in the notifications panel.
+
+---
+
+## What's inside
+
+- Track inventory across locations, scan barcodes, print labels
+- Send invoices, purchase orders, quotations, credit notes
+- Double-entry accounting with chart of accounts, P&L, balance sheet
+- Connect Shopify, WooCommerce, QuickBooks, Xero
+- Manufacturing - BOMs, production orders, merge/split/transform
+- CRM - contacts, pipeline, memos, activity feed
+- Recurring subscriptions: generate each invoice or purchase order when it is due
+- CSV import/export everything - idempotent, audited, column-mapped
+- Multi-company from one install
+- Role-based permissions - five access levels (viewer, operator, manager, admin, owner) for controlled employee access
+- Works offline, no internet required
+
+---
+
+## How it works
+
+Celerp runs on your machine and keeps its primary database local. Optional Connect features can relay remote access or send selected data to Celerp cloud services.
+
+- **No setup** - the desktop app bundles Postgres, runs migrations on launch, opens in your browser
+- **No lock-in** - your data stays in a standard Postgres database you control
+- **Teams** - run as a local server, teammates connect over the LAN
+
+---
+
+## Modules
+
+Every business domain is a self-contained module. The full set ships with the download:
+
+| Module | What it does |
+|--------|-------------|
+| `celerp-inventory` | Items, stock levels, locations, barcode scanning, valuation |
+| `celerp-contacts` | Contacts, addresses, tags, notes, file attachments |
+| `celerp-docs` | Invoices, POs, quotations, credit notes, receipts |
+| `celerp-accounting` | Chart of accounts, journal entries, P&L, balance sheet |
+| `celerp-reports` | AR/AP aging, sales, purchases, inventory valuation |
+| `celerp-subscriptions` | Recurring billing templates; generate each document when it is due |
+| `celerp-manufacturing` | BOMs, production orders, merge/split/transform |
+| `celerp-labels` | Label printing, barcode generation |
+| `celerp-verticals` | Industry presets - configure for your business type on first run |
+
+The setup form asks for your business type. Modules can be toggled any time at **Settings > Modules**.
+
+### Build your own
+
+> "My vision for Celerp is that anyone with AI coding tools can describe what their business needs and get a module that imports right into the system."
+>
+> Noah Severs, Founder
+
+Every feature above is a module on one loader API, and you can build against the same API. A module is a Python package you drop into Celerp's `modules/` folder; it adds its own tables, API routes, and UI pages, no fork or build step.
+
+- [**celerp-module-template**](https://github.com/celerp/celerp-module-template) - a working example module you can run in about ten minutes, plus a lint script
+- [**Build a module**](https://celerp.com/build) - the guide
+- [**community-modules**](https://github.com/celerp/community-modules) - a directory of community-built modules, and how to list yours
+
+---
+
+## Architecture
+
+- **Event-sourced** - every change is an immutable ledger entry, projections materialize queryable state
+- **Modular** - each domain is a plugin with its own models, routes, and projections
+- **Python/FastAPI** backend, **FastHTML** UI, embedded **PostgreSQL**
+- SQLite in-memory for tests - no external dependencies to run the test suite
+
+---
+
+## Development
+
+```bash
+git clone git@github.com:celerp/celerp.git
+cd celerp
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+celerp init   # creates DB, runs migrations, starts servers
+```
+
+`celerp init` boots a bundled PostgreSQL when no server is running, so no `sudo` and no
+system Postgres are required. To develop against your own server instead, pass
+`--db-url postgresql+asyncpg://…`.
+
+Open **http://localhost:8080**. Run tests with `pytest tests/`.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for environment variables, troubleshooting, and coding guidelines.
+
+---
+
+## Contributing
+
+Issues and PRs welcome. The module system makes it straightforward to add new business domains without touching the kernel.
+
+---
+
+## License
+
+**Free to download. Free to self-host. Free to build on.**
+
+Celerp is open-core:
+
+- **Source-available core engine** under the [Business Source License 1.1](LICENSE) -
+  self-hosting permitted, contributions welcome.
+- **An MIT-licensed module ecosystem** - the default business modules are MIT, so you can
+  fork them, build your own modules, and ship them however you like. See [LICENSING.md](LICENSING.md).
+- **A source available application** (official UI, document/PDF output and AI & Connect services).
+
+See [LICENSING.md](LICENSING.md) for the full map and [TRADEMARK.md](legal/TRADEMARK.md) for use of the Celerp
+name. One restriction: don't resell Celerp itself as a competing product.

celerp-2.6.0/alembic.ini

@@ -0,0 +1,40 @@
+[alembic]
+# script_location points to the Alembic migrations package.
+# sqlalchemy.url is intentionally left as a placeholder: env.py reads DATABASE_URL from the environment.
+# Keep this file ASCII: Alembic reads it in the Windows code page, not UTF-8.
+script_location = celerp/migrations
+sqlalchemy.url = driver://user:pass@localhost/dbname
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S