Metadata-Version: 2.4
Name: byro
Version: 2026.4.0
Summary: Membership and fees management for associations, clubs and groups
Home-page: https://byro.cloud
Author: Tobias Kunze
Author-email: r@rixx.de
License: AGPL-3.0-only
Keywords: members membership fees club group clubs associations association
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 5.2
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.12
Description-Content-Type: text/x-rst
Requires-Dist: canonicaljson==2.0.0
Requires-Dist: celery<6.0,>=5.4
Requires-Dist: chardet<7.7,>=5.2
Requires-Dist: csscompressor~=0.9.5
Requires-Dist: dateparser<1.5,>=1.1
Requires-Dist: django-annoying~=0.10.0
Requires-Dist: django-bootstrap4<26.3,>=23.1
Requires-Dist: django-compressor<5.0,>=2.4
Requires-Dist: django-extensions<4.2,>=3.1
Requires-Dist: django-i18nfield<1.12,>=1.9
Requires-Dist: django-formset-js-improved==0.5.0.5
Requires-Dist: django-libsass<0.10,>=0.8
Requires-Dist: django-localflavor<5.2,>=3.0
Requires-Dist: django-otp<1.8,>=1.6
Requires-Dist: django-select2<8.5,>=7.7
Requires-Dist: django-solo<2.6,>=2.1
Requires-Dist: Django<5.3,>=5.2
Requires-Dist: inlinestyler~=0.2
Requires-Dist: jinja2>=2.10.1
Requires-Dist: more-itertools<11.2,>=8.10
Requires-Dist: psycopg2-binary
Requires-Dist: PyJWT[crypto]<3,>=2.8
Requires-Dist: pynacl<1.7,>=1.4
Requires-Dist: python-dateutil
Requires-Dist: python-magic~=0.4.0
Requires-Dist: qrcode[pil]<8.3,>=7.3
Requires-Dist: schwifty==2026.7.3
Requires-Dist: unicodecsv~=0.14.0
Requires-Dist: whitenoise<6.13,>=6.4
Requires-Dist: djangorestframework<4.0,>=3.14
Requires-Dist: django-filter<27,>=23
Requires-Dist: drf-spectacular<1.0,>=0.27
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: check-manifest; extra == "dev"
Requires-Dist: djhtml; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: freezegun; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: ipython; extra == "dev"
Requires-Dist: pytest<10; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-django; extra == "dev"
Requires-Dist: pytest-rerunfailures; extra == "dev"
Requires-Dist: pytest-sugar; extra == "dev"
Requires-Dist: pytest-xdist; extra == "dev"
Provides-Extra: mysql
Requires-Dist: mysqlclient; extra == "mysql"
Provides-Extra: postgres
Requires-Dist: psycopg2-binary; extra == "postgres"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

byro
====

byro_ is a simple, self-hosted membership administration tool for small and
medium-sized clubs, NGOs and associations, with a focus on the DACH region. It
is stable, in active use in several communities and actively developed.

byro is plugin-based so that organizations can adapt it to their own processes
and local requirements. It is not a complete bookkeeping, event or ticketing
system, and it does not offer a hosted default instance.

Getting started
---------------

* **Run byro for an organization:** The `installation guide`_ covers byroctl
  (recommended), Docker Compose and bare-metal installations.
* **Use an existing installation:** The `user guide`_ covers members, fees,
  finances, documents and communication.
* **Extend or improve byro:** Start with the `API and plugin documentation`_ or
  `contributing`_.

Features
--------

* Manage members, memberships and recurring fees.
* Record and match payments; the official bank-file importer supports CAMT.053
  and MT940.
* Create documents, review and send mail, and keep member balances transparent.
* Let members manage selected data and interact through the member area.
* Protect Office accounts with multi-factor authentication.
* Adapt byro through plugins and use its REST API for integrations.

Plugins
-------

Plugins are Python packages that extend byro with importers, member data,
documents or whole features. Administrators can install the compatible official
plugins listed in the `plugin catalog`_; see `plugin management`_ for their
installation and maintenance. The `plugin development documentation`_ explains
how to build one.

The GitHub `byro-plugin topic`_ is a place to discover community plugins, not
an endorsement; byroctl never installs entries from it automatically.

Contributing
------------

Contributions to byro, its documentation and its plugins are welcome. See the
`contributor documentation`_ for the development setup and contribution
workflow.

License
-------

byro is licensed under the GNU Affero General Public License, version 3.0 only
(``AGPL-3.0-only``). Older versions of byro were released under the Apache
License 2.0. The documentation in ``docs/`` is licensed under the Creative
Commons Attribution-ShareAlike 4.0 International License (``CC-BY-SA-4.0``).
See the `LICENSE`_ file for details, including the licensing history and the
licenses of bundled third-party components.

.. _byro: https://byro.cloud
.. _installation guide: https://byro.readthedocs.io/en/latest/installation/overview/
.. _user guide: https://byro.readthedocs.io/en/latest/usage/overview/
.. _API and plugin documentation: https://byro.readthedocs.io/en/latest/administration/plugins/
.. _contributing: https://byro.readthedocs.io/en/latest/development/overview/
.. _plugin catalog: https://github.com/byro/byro/blob/main/deploy/plugin-catalog.conf
.. _plugin management: https://byro.readthedocs.io/en/latest/administration/plugin-management/
.. _plugin development documentation: https://byro.readthedocs.io/en/latest/development/plugins/overview/
.. _byro-plugin topic: https://github.com/topics/byro-plugin
.. _contributor documentation: https://byro.readthedocs.io/en/latest/development/contributing/
.. _LICENSE: https://github.com/byro/byro/blob/main/LICENSE
