Adhocracy4
The core library for the e-participation projects by Liquid Democracy
Install / Use
/learn @liqd/Adhocracy4README
Adhocracy4
A library for building online participation software. It is maintained and developed by Liquid Democracy e.V. and heavily relies on the Django web framework.
Examples of using adhocracy4 are a+, meinBerlin and Civic Europe. The first two being online participation platforms implementing different processes like idea collections or debates, and the latter using adhocracy4 as the basis for a transparent idea challenge.
To try it out yourself, best start with [a+][https://github.com/liqd/adhocracy-plus/blob/main/docs/installation_prod.md].
Local Development
Adhocracy4 Installation
git clone https://github.com/liqd/adhocracy4.git
cd adhocracy4
make install
Global setup: make install uses pipx to install uv system-wide
Project isolation: It then uses uv to create a local .venv and installs dependencies into it.
Use Make
make test
make help
Development
To add a new Library use uv
uv add module
this automaticly updates pyproject.toml and uv.lock
Virtual Enviroment
if you want to do something inside the venv manually use
uv run python manage.py ...
(which invokes .venev/bin/python manage.py ... )
