Giter Club home page Giter Club logo

adhocracy-plus's Introduction

adhocracy+

adhocracy.plus is a free Open-Source participation platform maintained and primarily developed by Liquid Democracy e.V.. It is based on adhocracy 4 and Django.

Build Status Coverage Status

Getting started

adhocracy+ is designed to make online participation easy and accessible to everyone. It can be used on our SaaS-platform or installed on your own servers. How to get started on our platform is explained here.

Installation for development

Requirements

  • nodejs (+ npm)
  • python 3.x (+ venv + pip)
  • libpq (only if postgres should be used)
  • sqlite3 with JSON1 enabled
  • redis (in production, not needed for development)

Installation

git clone https://github.com/liqd/adhocracy-plus.git
cd adhocracy-plus
make install
make fixtures

Start virtual environment

source venv/bin/activate

Check if tests work

make test

Start a local server

make watch

Use postgresql database for testing

run the following command once:

make postgres-create

to start the test server with postgresql, run:

export DATABASE=postgresql
make postgres-start
make watch

Go to http://localhost:8004/ and login with [email protected] | password

Use Celery for task queues

For a celery worker to pick up tasks you need to make sure that:

  • the redis server is running
  • the celery config parameter "always eager" is disabled (add CELERY_TASK_ALWAYS_EAGER = False to your local.py)

To start a celery worker node in the foreground, call:

make celery-worker-start

To inspect all registered tasks, list the running worker nodes, call:

make celery-worker-status

To send a dummy task to the queue and report the result, call:

make celery-worker-dummy-task

Installation on a production system

You like adhocracy+ and want to run your own version? An installation guide for production systems can be found here.

Contributing or maintaining your own fork

If you found an issue, want to contribute, or would like to add your own features to your own version of adhocracy+, check out contributing.

Security

We care about security. So, if you find any issues concerning security, please send us an email at info [at] liqd [dot] net.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.