Integrates Decidim with the liquidvoting.io API.
Note: In alpha. Not yet used in production. But it's ready for a pilot!
decidim_integration.mp4
The integration enables delegations of supports for proposals in participatory processes and assemblies, and redirects supports so they go through the API, in order to calculate results based on different voting weights of delegates.
Add this line to the Decidim instance's Gemfile:
gem "decidim-liquidvoting", git: "https://github.com/liquidvotingio/decidim-module-liquidvoting"And then execute:
bundleBy default the instance will connect with the live api hosted on https://api.liquidvoting.io/, and use a demo organization there.
For use with your own organization please contact us to request an authentication key.
If a private on-prem instance of the API is preferred, see the instructions on the API repo on how to use the docker image.
For development, when running a Decidim instance locally with this module bundled, if you want to also run an API instance locally, you'll need to export the following env vars before starting Decidim:
export LIQUID_VOTING_API_URL="http://localhost:4000"
export LIQUID_VOTING_API_ORG_ID="24e173f5-d99a-4470-b1cc-142b392df10a"
sudo -E bin/rails s --port=80Notes:
We use sudo so we can override port 80 - The API doesn't accept proposal urls with ports. The -E option so it'll remember the environment variables exported.
For instructions on how to setup the API locally, see the API repo's README
This engine is distributed under the GNU AFFERO GENERAL PUBLIC LICENSE.