To install Pytanis simple run:
or to install all recommended additional dependencies:
pip install pytanis
Then create a configuration file and directory in your user's home directory. For Linux/MacOS/Unix use
pip install 'pytanis[all]'
~/.pytanis/config.tomland for Windows
C:\Users\yourusername\. Use your favourite editor to open
.pytanisdirectory and add the following content:
where you need to replace the dummy values in the sections
[Pretalx] api_token = "932ndsf9uk32nf9sdkn3454532nj32jn" [Google] client_secret_json = "client_secret.json" token_json = "token.json" [HelpDesk] account = "934jcjkdf-39df-9df-93kf-934jfhuuij39fd" entity_id = "firstname.lastname@example.org" token = "dal:Sx4id934C3Y-X934jldjdfjk"
You have to configure the credentials and tokens only for the sections you actually want to use. For instance,
[Google] are the most important sections for users that want to interact with Pretalx and also Google Sheets. If for instance no access to HelpDesk is necessary, e.g. no mails need to be sent, you can just leave out the key/value pairs in the
Retrieving the Credentials and Tokens¶
- Google: Follow the Python Quickstart for the Google API to generate and download the file
client_secret.json. Move it to the
client_secret.json. The file
token.jsonwill be automatically generated later. Note that
config.tomlreferences those two files relative to its own location.
- Pretalx: The API token for the Pretalx API can be found in your user settings.
- HelpDesk: Log into the LiveChat Developer Console then go to Tools » Personal Access Tokens. Hit Create new token +, enter a the name
Pytanis, select all scopes and confirm. In the following screen copy the
Tokenand paste them into
config.toml. In case there is any trouble with livechat, contact a helpdesk admin.