Presentation and assembly system
What is OpenSlides?
OpenSlides is a free, web based presentation and assembly system for managing and projecting agenda, motions and elections of an assembly. See https://openslides.org/ for more information.
OpenSlides runs everywhere where Python is running (for example on GNU/Linux, Mac or Windows (XP or newer)). On each client you need only a current version of a webbrowser.
1. Installation on GNU/Linux or Mac OS X
a. Check requirements
Make sure that you have installed Python (>= 3.4) on your system. You also need build-essential packages (build-essential) and header files and a static library for Python (python3-dev).
b. Setup a virtual Python environment (optional)
You can setup a virtual Python environment using the virtual environment (venv) package for Python to install OpenSlides as non-root user.
Note: For Ubuntu 14.04 you have to install the pyvenv binary package python3.4-venv before.
Note: For Ubuntu 16.04 you have to install the pyvenv binary package python3-venv before.
Create your OpenSlides directory and change to it:
$ mkdir OpenSlides $ cd OpenSlides
Setup and activate the virtual environment:
$ python3 -m venv .virtualenv $ source .virtualenv/bin/activate $ pip install --upgrade setuptools pip
c. Install OpenSlides
To install OpenSlides just run:
$ pip install openslides
You can also use the package from the OpenSlides website. Download latest OpenSlides release as compressed tar archive and run:
$ pip install openslides-x.x.tar.gz
This will install all required Python packages (see requirements_production.txt).
d. Start OpenSlides
To start OpenSlides simply run:
If you run this command the first time, a new database and the admin account (Username: admin, Password: admin) will be created. Please change the password after first login!
OpenSlides will start a webserver. It will also try to open the webinterface in your default webbrowser. The server will try to listen on the local ip address on port 8000. That means that the server will be available to everyone on your local network (at least for commonly used network configurations).
If you use a virtual environment (see step b.), do not forget to activate the environment before restart after you closed the terminal:
$ source .virtualenv/bin/activate
To get help on the command line options run:
$ openslides --help
You can store settings, database and other personal files in a local subdirectory and use these files e. g. if you want to run multiple instances of OpenSlides:
$ openslides start --local-installation
2. Installation on Windows
Download the latest portable version of OpenSlides for Windows from OpenSlides website which does not require any install steps. Simply unzip the downloaded file and run openslides.exe.
In OpenSlides repository you find a Dockerfile but this is not for production use. See our Multi instance backend for OpenSlides for more information.
Installation for big assemblies
The installation steps described above install OpenSlides in a way that does NOT support hundreds of concurrent clients. To install OpenSlides for big assemblies some variables have to be changed in the OpenSlides settings file (usually called settings.py).
The configuration values that have to be altered are:
You should use a webserver like Apache HTTP Server or nginx to serve the static and media files as proxy server in front of your OpenSlides interface server. You also should use a database like PostgreSQL and Redis as channels backend, cache backend and session engine. Finally you should start some WSGI workers and one or more interface servers (Daphne or Geiss).
Please see the respective section in the DEVELOPMENT.rst and:
OpenSlides uses the following projects or parts of them:
- Several Python packages (see requirements_production.txt).
- angular, License: MIT
- angular-animate, License: MIT
- angular-bootstrap, License: MIT
- angular-bootstrap-colorpicker, License: MIT
- angular-chosen-localytics, License: MIT
- angular-ckeditor, License: MIT
- angular-formly, License: MIT
- angular-formly-templates-bootstrap, License: MIT
- angular-gettext, License: MIT
- angular-messages, License: MIT
- pdfmake, License: MIT
- angular-pdf, License: MIT
- angular-sanitize, License: MIT
- angular-scroll-glue, License: MIT
- angular-ui-router, License: MIT
- angular-ui-tree, License: MIT
- angular-xeditable, License: MIT
- api-check, License: MIT
- bootstrap, License: MIT
- bootstrap-ui-datetime-picker, License: MIT
- chosen, License: MIT
- ckeditor, License: GPL 2+, LGPL 2.1+ or MPL 1.1.
- font-awesome-bower, License: MIT
- jquery, License: MIT
- jquery.cookie, License: MIT
- js-data, License: MIT
- js-data-angular, License: MIT
- js-data-http, License: MIT
- lodash, License: MIT
- ng-dialog, License: MIT
- ng-file-upload, License: MIT
- ngStorage, License: MIT
- ngbootbox, License: MIT
- open-sans-fontface, License: Apache License version 2.0
- Papa Parse, License: MIT
- pdfjs-dist, License: Apache-2.0
- roboto-condensed, License: Apache 2.0
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|openslides-2.1.1-py3-none-any.whl (3.6 MB) Copy SHA256 Checksum SHA256||3.5||Wheel||Apr 5, 2017|
|openslides-2.1.1.tar.gz (3.3 MB) Copy SHA256 Checksum SHA256||–||Source||Apr 5, 2017|