About

PyAppointment is a Django-based web application that allows people to book appointments in your schedule, based on gaps in your calendar and defined regions of availability. When people book an appointment, an event will be created in your calendar and both attendee and organizer will receive an email to notify that the booking has been made.

It relies on a (free) developer account with the calendar service Cronofy. This means that it can use any of the calendar services it supports, including Google Calendar, iCloud Calendar and Outlook Exchange.

This webapp functions somewhat similarly to commerical services such as Calendly and YouCanBookMe, but for a single user only and without quite a bit of the functionality and support that these services offer.

Requirements

• Python 3
• A method of deployment (e.g. uwsgi)
• A Cronofy account

Installation

PyAppointment works best using virtualenv. To install required dependencies, clone the repository, cd into the root source directory and run the commands:

$ virtualenv -p python3 env
$ source env/bin/activate
$ pip install -r requirements.txt

For the frontend components (right now, just Bootstrap), you also need yarn which can be installed through the node package manager npm.

$ npm install -g yarn   # If you don't have yarn.
$ yarn install          # Install front-end requirements.

Copy the config.ini.sample file to config.ini and modify the settings to align with your desired meeting types and email configuration. Finally, perform initial setup with:

$ python manage.py migrate
$ python manage.py collectstatic

Deployment can be done as usual for Django webapps using uwsgi. A sample INI file for deployment can be found in the doc directory. Note that due to a presently unresolved bug, you need to set the max-worker-lifetime parameter to a reasonably short interval -- I suggest 1 hour (3600 seconds), otherwise the Cronofy service becomes unavailable.

Configuration options

PyAppointment requires a config.ini file to be provided in the main directory, which sets up the types of bookings you want to provide and their configuration -- how long they should be, where they are held, and so on.

You can find a sample config.ini file in the sources, and more detailed documentation in the doc directory.

FAQs

• This doesn't work at all/for my workflow.
  This is thoroughly beta-level software and has not been tested extensively! I welcome bug reports and, better, bug fixes through pull requests.

• Will you implement feature xyz?
  Probably not, unless it aligns with my own feature requirements. However I certainly welcome requests and pull requests to make this better.