Awesome Polis

A curated comprehensive list of resources and tools for using Polis and building things on top of it.

🚧 Until this line is removed, please consider this a work-in-progress.

Full spreadsheet of all known resources

---

Unlike some Awesome Lists, since the Polis development and practitioner community is rather nascent and disconnected, this list will start off as very COMPREHENSIVE, rather than CURATED. This means it will include code or projects even marginally related to Polis. This will include non-functional projects. At some point, once there is more maturity in the ecosystem, inactive or incomplete projects will likely migrated in a less prominent collaborative spreadsheet also listed amongst these resources.

Table of Contents

• Maintainers
• Contribute
• Collab-Cluster
• Forks & Deployments
• Official
• Uncategorized
• Discussions
• Want to hack on IPFS?
• License

Maintainers

🚧 This section is a work-in-progress.

Maintainers requested! This repo is not currently under active development nor maintenance and requires more support from the community.

Contribute to this list!

🚧 This section is a work-in-progress.

Everyone is welcome to submit their new awesome-ipfs item, but it will be accepted only if it meets our content policy.

Readme and the website are automatically generated. In order to add an element to this list, you need to modify the files in /data and then run make build before publishing your pull request. Read contributing guidelines to learn how to do so.

Forks & Deployments

• 2024-11: Agora Citizen Network - Agora is a Polis-inspired platform that enables citizens, organizations, and governments to engage in meaningful large-scale discussions on social and political issues. Source
• 2024-10: CodeWithAloha/HIERR - Hawaiʻi Economic Recovery & Resilience (HIERR) is a digital engagement platform wrapping around Polis and providing onboarding materials to solicit resident sentiments on vision and value statements for Hawaii's economic future. Source
• 2023-10: Demdis - A Slovakian fork seeking to build a community around better ways of engaging in divisive conversations. Source
• 2020-08: Demos UK - Polis fork run by the UK thinktank Demos. Source
• 2023-07: DFE-Digital/polis-whitelabel - A pared-down fork of Polis created by the Gov.UK Policy Lab Source
• 2024-11: InnoPolis - A decentralized version of Pol.is built on Ethereum, for community engagement and decision-making with ML-powered opinion analysis. Source
• 2024-11: Metropolis - A new Polis frontend and collective-response tool, funded for Filecoin governance and integrated with GitHub. Source
• 2017-06: Pentano - An early iteration of the Pushing Together reimplementation of Polis. (Brazil)
• 2021-03: Polis deployment: Crowd Wisdom Project - An unmodified deployment of the Polis codebase, hosted by the UK-based Crowd Wisdom Project. Source
• 2023-08: Polis deployment: Polis.tw - An slightly modified deployment of the Polis codebase, hosted by PDIS.tw, a division of the Taiwanese national government. Source
• 2023-04: Polis: DigiFinland v1 - An initial V1 set of deploy scripts, settings files, custom patches, translations and utilities for running Polis experiment deployments for DigiFinland. Source
• 2024-09: Polis: DigiFinland v2 - A current V2 set of deploy scripts, settings files, custom patches, translations and utilities for running Polis experiment deployments for DigiFinland. Source
• 2024-09: PolisOrbis - PolisOrbis is a Polis fork with extensive rewrites, aiming for GDPR compliance, OpenID Connect auth support, and improved docs, among other things. Source
• 2023-12: polispilot/polis-whitelabel - A modified deployment of the Polis codebase, called Partici.app. Built by affiliates of Code for NL, related to PolisPilot. Source
• 2023-05: Pushing Together (EJ Platform) - A comprehensive platform and funded project to create a social participation app, reimplementing Polis. (Brazil) Source
• 2022-11: sirodoht/suburb - Suburb is an experimental fork of Polis, with cleanup in code and infrastructure requirements.
• 2022-07: Tolerance Carousel - Code for deployed fork of Polis that paired with the Tolerance Carousel project.

Official

• 2024-10: compdemocracy/openData - Data exports from select "open data" Polis conversations
• 2023-01: compdemocracy/scripts - Scripts to streamline the running of the pol.is instance used in Policy Lab. Some of these will become features later on.
• Guide: Integrating Polis with Citizens Assemblies - A guide for those who are thinking about the interaction between techniques for listening at scale and in-person deliberation
• Official Guide to Polis Methods v1 - The table of contents for an incomplete stub of a currently unpublished Polis book.
• 2023-06-20: Opportunities and Risks of LLMs for Scalable Deliberation with Polis - An official collaborative paper with AnthropicAI, on applying LLMs to Polis outputs and processes.
• Pol.is - Open Source AI for large scale open ended feedback Source
• 2023-07: Polis Embed Examples - Examples illustrating how to embed a Polis conversation in another website.
• 2024: Polis Knowledge Base - The Computational Democracy Project maintains an extensive (and growing) knowledge base for Polis and related facilitation methods.
• 2021-04-29: Polis: Scaling Deliberation by Mapping HighDimensional Opinion Spaces - The authoritative paper on Polis internals and math.
• 2022-11-24: “Coherent Mode” for the World’s Public Square - An official paper proposing modification to Twitter's Community Notes UI to support deliberative process.

Uncategorized

• 2024-05: aadityabhatia/polis-argmap - Polis Argument Mapping to Guide Policy Decisions. How can large language models enable us to ingest massive streams of unstructured information, incorporate diverse perspectives and distill them into actionable insights that demonstrably align with public opinion? Source
• 2023-10: AIObjectives/community-notes-experiment - Analyses Polis data with Vitalik's simplified version of Community Notes algorithm, evaluating for quality and polarization.
• 2024-06: AIObjectives/talk-to-the-city-reports - Sample reports generated by Talk to the City, an open-source LLM survey tool to improve collective discourse and decision-making by analyzing detailed qualitative responses to questions and generating an easy-to-navigate report based on the input data. Source
• 2024-10: AIObjectives/tttc-light-js - The codebase for generating reports. Talk to the City is an open-source LLM interface for improving collective deliberation and decision-making by analyzing detailed, qualitative data. It aggregates responses and arranges similar arguments into clusters. Source
• 2024-12: ALR DMC: Alert Democracy browser extension (Sitra) - A browser extension (and backend server) that helps users take action (Polis conversation, petitions, etc.) on the issues they are reading about. This was a Junction 2024 hackathon project, placing 1st within the SITRA's digital democracy challenge. (Finland) Source
• 2019-03: audreyt/polis-tally - Polis export data and perl scripts for g0v.tw conversations, including Talkto.tw
• 2024-11: Auth and Bot Detection (Sitra) - Junction 2024 hackathon project to allow Polis auth and bot detection via browser fingerprinting. Hackathon challenge partner was Sitra. (Finland)
• 2020-06: ballPointPenguin/polis-playbook - Ansible playbook for deployment of Polis instances.
• 2024-11: Bluesky List: Polis Practitioners - A more curated Bluesky user list, including people actively working on Polis & Polis-related projects. Best-suited as a pseudo-feed of user posts, via the "Pin to Home" feature. Source
• 2024-11: Bluesky List: Polis-curious - A more inclusive Bluesky user list, including people who've expressed interest and enthusiasm about Polis, particularly on social media. Best-suited as a pseudo-feed of user posts, via the "Pin to Home" feature.
• 2024-11: Bluesky Starter Pack: Polis Practitioners - A more curated Bluesky user list (as a starter pack), including people actively working on Polis & Polis-related projects. Best-suited for mass-following users. (Sync'd with Bluesky list as much as possible.) Source
• 2024-06: CivicTechTO/polis-moderator-hotkey - A Chrome extension allow polis moderator to accept/reject comments with hotkeys
• 2024-10: Code for NL Slack - PolisPilot - Join the active #polis channel in this Slack team to participate in projects PolisPilot / Partici.app
• 2021-02: codefornl/polis-splash - Wrapper for Polis discussion on Code for NL.
• 2014-09: colinmegill/conference - An app for conferences built around pol.is
• 2024-03: Common Ground - Conceptualised as a multi-player variant of Pol.is, this app aims to test whether intimate, small group discussions, enhanced by scalable intra-group communication protocols, can improve wider debate. Grantee in OpenAI "Democratic Inputs to AI" challenge. Source
• 2019-02: Conversa - An experimental Ruby on Rails app attempting to reimplement the Polis frontend.
• 2024-10-03: Creating new frontend(s) for Polis (Part 4/5) - Part of a 5-post blog series about adapting and improving Polis for evaluation by several Dutch provincial governments and central government ministries
• 2024-08: Decidim-EJ - A Decidim module to integrate Pushing Together (EJ) into Decidim. (EJ was started by previous Polis users.)
• 2024-06: DELiberation.io - A general-purpose deliberation platform to host online conversations, inspired by Polis. In talks with potential partners for field experiments. Source
• 2024-11: Democracy Chamber (Sitra) - Democracy Chamber is an open platform for meaningful, democratic political discussion. The goal is to provide citizens with more tools to influence decision-making. Created by University of Helsinki students for the Junction 2024 hackathon, with SITRA as partner. (Finland)
• 2020-08: Demos-thinktank/dynata-id - A small site built to receive incoming Dynata ids, show people an embedded Pol.is survey, and send them back off when done.
• 2017-07: Doc: Holopolis - Demo Next Democracy - Holopolis was an open project launched by PDIS and Pol.is with the help of Microsoft Hololens Team and Re:public Inc.
• 2024-11: eterps/polislite - A lightweight polis-like library, aspiring to reproduce the Polis math algorithms in Python.
• 2024-11: EyeDentity (Sitra) - A human identifying tool based on deep gazing detection, to ensure human participation on Polis. This was a Junction 2024 hackathon project, placing 2nd within the SITRA's digital democracy challenge. (Finland) Source
• 2024-09: Generative Policy - A research project to help create simulated preliminary policy recommendations, by simulating a Polis engagement with LLMs.
• 2024-12: Github List: Polis-like - A list of all GitHub repos (both source and forks) where Polis-related code exists.
• 2018-12: Holopolis Map - Web mobile app that through geolocalization and the use of stickers with QR codes promotes democractic deliberation processes everywhere in the world. Source
• 2021-10: jerojero/polis-tribu - Polis implementation for Tribu (a Chilean NGO), it includes a complete website with a database that leverages the xid method of the polis embedded conversation to identify users uniquely.
• 2020-05: joshsmith2/polis-loadtesting - A series of Locust test to meaningfully load-test Pol.is instances
• LegSim - A defunct virtual legislature platform founded in 2001 that integrated Polis. Source
• 2024-11: MaanasArora/polis-ctto - A simple and efficient polis-like system built as a learning exercise by a contributor from Civic Tech Toronto.
• 2016-12: MyDemocracy.ca - Mini-site wrapping Polis for a citizen-run online consultation experiment. Source
• 2024-05-09: NewJerseyStyle/LitePolis - LitePolis is a WIP aiming provide a developer- and data-scientist-friendly port of Polis written in Python.
• 2020-08: NewVote/newvote-rhok - NewVote was an online crowd-sourcing tool in Australia that integrates Polis, supports co-design, communication and decision-making. Source
• 2017-12: OpenSourcePolitics/decidim-efb - An example Decidim codebase with the Decidim::Polis module installed Source
• 2022-09: OpenSourcePolitics/decidim-polis - Decidim module for integrating Polis into that platform. Source
• 2014-09: ourcity/minneapolis - A platform for creating more transparency and engagement with local government processes in Minneapolis. Groups council agenda items into larger issues, and integrates Polis conversations to explore those issues.
• 2016-06: padagraph/vTaiwanAirBnbImporter - An experiment with Airbnb Pol.is data, importing it into graph database.
• 2024-06: Partici.app - An Alternative Polis frontend, used in the PolisPilot demo. (Kanban board) Source
• 2024-06: Partici.app Docker - Support infrastructure to host Partici.app and their Polis fork.
• 2024-06: ParticiAPI - A server providing an alternative API on top of the Polis database, supporting third-party frontends for the Polis project. Source
• 2024-11: Participa app - Alternative Polis administration app written in Python's Django framework. For self-hosted Polis conversations, aims to improve the interface, and add user management, without forking its Polis core. Source
• 2024-09: Participa infra - Deployment scripts for deploying Participa platform alongside a self-hosted Polis instance.
• 2024-04: patcon/astro-test-polis - A sample wrapper app for a Polis conversation, built on Astro framework. Source
• 2023-04: patcon/polis-api-proxy - A Pol.is API proxy for experimenting with different API design choices. Source
• 2024-10: patcon/polis-api-spec - An interactive Swagger API spec for documenting and exploring the Polis API Proxy endpoints. Source
• 2021-01: patcon/polis-examples - Minimal sample apps for demonstrating various sorts of integrations. Notably includes passing vote/submit messages out of iframe via postMessage, and using Auth0 accounts. Source
• 2024-08: patcon/polis-exporter - An unfinished, messy work-in-progress set of scripts attempting to generate a Polis zipped export archive from public API endpoints.
• 2022-02: patcon/polis-irl-simulator - A demo to show how Polis conversations might augment in-person meetings.
• 2017-01: patcon/trump-polis-twitter-bot - A Twitter bot to auto-create Pol.is conversations for each Donald Trump tweet. Source
• 2019-11: PDIS helper scripts - PDIS.tw scripts for performing various tasks directly on the Polis database of self-hosted instances.
• 2017-07: PDIS/aframe-polis - An exploration of visualizing Polis results in the A-Frame web VR framework
• 2017-11: PDIS/holopolis2017 - Polis-inspired Holopolis experiments in 3D, based on both Overte VR (née High Fidelity) and Unity VR platforms.
• 2017-06: PDIS/sandstorm-external-site - A sandstorm auth wrapper for Polis.
• 2023-05: PluralCC/pcc-consensus-polling - Plural Polis Discourse, is a forum plugin to integrating Polis into a Discourse fork. It is cited in the linked paper as a demo of a collusion-resistant communication channel. Source
• 2023-05: PluralCC/plural-discourse - A Discourse Forum fork intended to be used with the Polis-integrating pcc-consensus-polling Discourse plugin.
• 2023-12: Polis IRL: Mobile NFC voting app - A prototype React-Native mobile app for IRL voting in Polis conversations via scanning assigned NFC stickers.
• 2020-11: Polis Kubernetes Helm Chart - Configuration management code for setting up a Polis instance via Kubernetes.
• 2021-01: Polis link prediction - A data exploration in Jupyter notebook.
• 2021-03: Polis Math module walk-through - Notes from a walk-through of the Clojure math module of Polis, given by CompDem data scientist Chris Small during his technical office hours.
• 2024-11: Polis Resources Spreadsheet - The raw source material for this community-stewarded Awesome Polis directory.
• Polis User Group (PUG) - Landing page for a unofficial community for users and fans of the Polis software project, for anyone eager to explore the tool/processes, including prospective conversation moderators & participants, as well as self-hosted server administrators.
• Polis User Group (PUG) Discord - An unofficial Discord server for the Polis User Group (PUG). See PUG entry for details.
• 2024-09: PolisOrbis Deploy Blueprints - Scripts and code to deploy PolisOrbis in a provisioned Amazon AWS infrastructure.
• 2024-06: PolisPilot Demo - PolisPilot is a demo Partici.app frontend for Polis, accessed via the ParticiAPI server. Source
• 2023-12: PolisPilot.nl - A very polished fork of Polis being built by affiliates of Code for NL
• 2022-03: proyectourgente/cuestionario-luc - The website code (hosted archive) and collected data of the Polis experiment running in the months prior to the LUC referendum in Uruguay. Source
• 2024-10: Pushing Together (EJ) - A platform using gamification and machine learning to promote discussions and participation in a virtual democracy. (EJ was started by previous Polis users.) Source
• 2024-10: Pushing Together (EJ) bot - An opinion research chatbot for Telegram and WhatsApp. (EJ was started by previous Polis users.) Source
• 2022-03: RoboTeddy/polis-poh-embed-example - Example of a Proof-of-Humanity identity provider wrapper for any arbitary Polis conversation. Source
• 2022-06: RxC Conversations - A wrapper for Polis conversations held in the RadicalxChange community.
• 2022-06: RxC Voice - RadicalxChange Voice is an app for decentralized democratic governance. Source
• 2023-10: shuyanglin/vtaiwan-openai-2023 - A vTaiwan banner website for running a consultation (including Polis) within the Democracy Inputs to AI grant. Source
• 2024-11: Society Speaks - A fully-launched Polis-centred platform for improved hosting experience and discoverability of public Polis conversations, from local up to international. Source
• 2024-10: Storybook: Polis - A "storybook" instance to display frontend UI components from Polis and its forks, to allow more collaboration and experimentation on UX and accessibility improvements. Source
• 2016-03: Talk to Taiwan - Source for generating the Talkto.tw website codebase, which used Polis alongside livestreamed interviews of public figures. Source
• 2017-08: Talkto.NYC - Polis-integrated media platform for the people of NYC to bring their ideas to city politics Source
• 2022-11: Tolerance Carousel - An interactive exhibit that integrated a fork of Polis into a multimedia Virtual Agora in-person event. Source
• 2024-10-15: Toward building deliberative digital media: From subversion to consensus - This paper (Pentland & Tsai) analyzes Polis "to illustrate how social science might enable design of next-generation digital media suitable for democratic deliberation, and in which generative artificial intelligence might be useful."
• 2024-11: Tuebocracy - Simple wrapper app, intended to help citizens of Tübingen Germany provide input on city issues. Written in Racket language, using Pollen and UnoCSS, built with Nix. Created for a hackathon. Source
• Twitter List: Polis-curious - A Twitter list of folks who've built, used or just gotten really stoked about Polis or vTaiwan.
• 2024-11: Twitter/X List: Polis-curious - A more inclusive Twitter/X user list, including people who've expressed interest and enthusiasm about Polis, particularly on social media. Best-suited as a pseudo-feed of user posts, via "pinning" on your list listing page. (Sync'd with Bluesky list as much as possible.)
• 2024-09: Viewpoints.xyz - New UI experiment for a Polis-like platform. Source
• 2024-11: WePublish - Open Source Headless CMS for Publishers and News Rooms, integrating Polis. Created in Switzerland. Source
• 2022-08: Wikipedia: https://en.wikipedia.org/wiki/Wiki_survey - A Wikipedia entry originally created by Nicolas Perez, a member of the Polis User Group (PUG) community, giving Polis its first dedicated section on the platform. Source

Discussions

🚧 This section is a work-in-progress.

Want to hack on Polis?

🚧 This section is a work-in-progress.

License

This work is licensed under a Creative Commons Attribution 4.0 International License.