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-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: Metropolis - A new Polis frontend and collective-response tool, funded for Filecoin governance and integrated with GitHub. Source
• 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
• 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 an funded project to create a social participation app based on Polis. 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
• 2019-03: audreyt/polis-tally - Polis export data and perl scripts for g0v.tw conversations, including Talkto.tw
• 2020-06: ballPointPenguin/polis-playbook - Ansible playbook for deployment of Polis instances.
• 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
• 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 - Democracy Chamber is an open platform for meaningful, democratic political discussion. The goal is to provide citizens with more tools to influence decision-making.
• 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.
• 2023-04: DigiFinland Polis tools v1 - Set of deploy scripts, settings files, custom patches, translations and utilities for running Polis experiment deployments for DigiFinland. Source
• 2024-09: DigiFinland Polis tools v2 - Set of deploy scripts, settings files, custom patches, translations and utilities for running Polis experiment deployments for DigiFinland. Source
• 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-09: Generative Policy - A research project to help create simulated preliminary policy recommendations, by simulating a Polis engagement with LLMs.
• 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
• 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.
• 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."
• Twitter List: Polis-curious - A Twitter list of folks who've built, used or just gotten really stoked about Polis or vTaiwan.
• 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.