Polis

pol.is an AI powered sentiment gathering platform. More organic than surveys, less effort than focus groups.

🚧 Disclaimer

• The documentation and configuration in this code repository is for development ONLY, and emphatically NOT intended for production deployment.
• We do NOT make guarantees of easy setup or management, push-button deployment, security, firm development timelines, technical support, future migration paths, data integrity, existence of bugs, or completeness of existing features. All of the above is actively in flux on dev branch.
• Work in the issue queue and codebase is being done in part by passionate volunteer contributors. They will often be experimenting with unproven project infrastructure that is unsupported by the Polis organization, e.g. pre-built docker images.
• See also: Deployment: About SSL/HTTPS

Having said this, we are enthusiastic about your support in moving toward deployment-readiness. We aspire to see future third-party deployments of polis as we cultivate a growing community of diverse contributors! We look forward to working together 🎉

🙋🏾‍♀️ Get Involved

1. Say hi in one of our chat rooms 💬
   • 🦸🏼 General gitter.im/pol-is/polis-community
   • 👩🏿‍💻 Software Development gitter.com/pol-is/polisDeployment
2. Join one of our weekly open calls 🎤
   • Please please please... Newcomers welcome! Learn more...
3. Visit our issue tracker ✅ to offer your skills & energies
   • We also keep a project kanban board 🏁
   • 👂 Pssssst! Learn how... (labels, etc.)

💻 Development

Recommendations: Docker-Machine (on DigitalOcean with 2GB memory)

Running with docker-compose:

Before running docker-compose up for the first time, either do a pull (faster):

docker-compose pull

or do a build (to utilize recent or local changes):

docker-compose up --build --detach

subsequently you should only need to run:

docker-compose up --detach

To force a full re-build with no cache from previous builds: docker-compose build --parallel --no-cache

And to stop: docker-compose down

(or Ctrl+C if you did not run with --detach)

check your ip (only necessary on docker-machine):

docker-machine ip
>>> 123.45.67.89

Visit your instance at: http://123.45.67.89.xip.io/

Or visit a native docker instance at http://localhost:80/

Sign up at /createuser path. You'll be logged in right away; no email validation required!

What features still need work?

• Generated reports
• Data export polis-issues#137

Note: Due to past file re-organizations, you may find the following git configuration helpful for looking at history:

git config --local include.path ../.gitconfig

🔍 Testing

We use Cypress for automated, end-to-end browser testing! (See badge above.)

Please see e2e/README.md.

🚀 Deployment

Please see docs/deployment.md

©️ License

AGPLv3 with additional permission under section 7