Metadata-Version: 2.4
Name: celerp
Version: 1.2.4
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: fastapi>=0.115
Requires-Dist: uvicorn[standard]>=0.30
Requires-Dist: sqlalchemy[asyncio]>=2.0
Requires-Dist: asyncpg>=0.29
Requires-Dist: alembic>=1.13
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: python-jose[cryptography]>=3.3
Requires-Dist: cryptography>=42
Requires-Dist: passlib[bcrypt]>=1.7
Requires-Dist: numpy>=1.26
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: aiofiles>=23.0
Requires-Dist: httpx>=0.27
Requires-Dist: slowapi>=0.1.9
Requires-Dist: reportlab>=4.0
Requires-Dist: python-fasthtml>=0.12
Requires-Dist: psutil>=5.9
Requires-Dist: websockets>=12.0
Requires-Dist: aiosmtplib>=3.0
Requires-Dist: click>=8.0
Requires-Dist: python-barcode>=0.15
Requires-Dist: qrcode>=7.0
Requires-Dist: Pillow>=10.0
Requires-Dist: pypdf>=4.0
Requires-Dist: psycopg2-binary>=2.9
Requires-Dist: tzdata>=2024.1
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: faker>=24.0; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"
Requires-Dist: playwright>=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>=22.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)

![Celerp manufacturing cost worksheet](docs/press-kit/screenshots/manufacturing-worksheet.png)

## Screenshots

Real double-entry accounting, multi-location inventory, manufacturing, and a built-in REST API - one self-hosted app.

| | |
|---|---|
| ![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 |
| ![General ledger with account drill-down](docs/press-kit/screenshots/general-ledger.png)<br>**General ledger** - full drill-down | ![Multi-location inventory with barcode scanning and valuation](docs/press-kit/screenshots/inventory.png)<br>**Inventory** - multi-location, barcode, valuation |
| ![Production planning by status, priority, and due date](docs/press-kit/screenshots/production-planning.png)<br>**Production planning** - work orders, priorities, due dates | ![Built-in REST API for integrations](docs/press-kit/screenshots/rest-api.png)<br>**REST API** - integrate anything |
| ![Dashboard with revenue trend, receivables aging, and inventory mix](docs/press-kit/screenshots/dashboard.png)<br>**Dashboard** - revenue trend, AR aging, inventory mix | |

More in the [press kit](docs/press-kit/).

---

## Install

| Platform | Link |
|----------|------|
| Windows (.exe) | [Latest release](https://github.com/celerp/celerp/releases/latest) |
| Linux (.AppImage) | [Latest release](https://github.com/celerp/celerp/releases/latest) |
| macOS (.dmg) | [Latest release](https://github.com/celerp/celerp/releases/latest) |

**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
celerp start
```

Open **http://localhost:8080**. Done.
Your office can securely access the system at your IP address :8080.

---

## 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 with automatic invoicing
- 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 entirely on your machine. Your data never leaves your computer.

- **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, auto-invoice generation |
| `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 onboarding wizard lets you pick your industry. Modules can be toggled any time at **Settings > Modules**.

---

## 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]"
sudo celerp init   # creates DB, runs migrations, starts servers
```

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 proprietary application + cloud layer** (official UI, document/PDF output, and the cloud/AI
  services) that powers the hosted experience.

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.
