Navigation Menu

Skip to content


Repository files navigation


Web application can be found at

Team Members

  • Steven Bursztyn (Project Manager)
  • Rani Iyer (Technical Lead)
  • Abhinav Suri
  • Nishita Jain
  • Brandon Obas

Setting up

Clone the repo
$ git clone
$ cd oacce
Initialize a virtualenv
$ pip install virtualenv
$ virtualenv -p python3 venv
$ source venv/bin/activate
(If you're on a mac) Make sure xcode tools are installed
$ xcode-select --install

Install the dependencies

$ pip install -r requirements.txt
Add Environment Variables

Create a file called config.env that contains environment variables in the following syntax: ENVIRONMENT_VARIABLE=value. You may also wrap values in double quotes like ENVIRONMENT_VARIABLE="value with spaces". For example, the mailing environment variables can be set as the following. We recommend using Sendgrid for a mailing SMTP server, but anything else will work as well.


Other Key value pairs:

  • ADMIN_EMAIL: set to the default email for your first admin account (default is
  • ADMIN_PASSWORD: set to the default password for your first admin account (default is password)
  • DATABASE_URL: set to a postgresql database url (default is data-dev.sqlite)
  • REDISTOGO_URL: set to Redis To Go URL or any redis server url (default is http://localhost:6379)
  • RAYGUN_APIKEY: api key for raygun (default is None)
  • FLASK_CONFIG: can be development, production, default, heroku, unix, or testing. Most of the time you will use development or production.

Note: do not include the config.env file in any commits. This should remain private.

Install the dependencies
$ pip install -r requirements.txt
Other dependencies for running locally

You need Redis, and Sass. Chances are, these commands will work:


$ gem install sass


Mac (using homebrew):

$ brew install redis


$ sudo apt-get install redis-server

You will also need to install PostgresQL

Mac (using homebrew):

brew install postgresql

Linux (based on this issue):

sudo apt-get install libpq-dev
Create the database
$ python recreate_db
Other setup (e.g. creating roles in database)
$ python setup_dev

Note that this will create an admin user with email and password specified by the ADMIN_EMAIL and ADMIN_PASSWORD config variables. If not specified, they are both and password respectively.

[Optional] Add fake data to the database
$ python add_fake_data

Running the app

$ source venv/bin/activate
$ honcho start -f Local

Then navigate to http://localhost:5000 on your preferred browser to open the web app.

Formatting code

Before you submit changes, you may want to auto-format your code with python format.

Updating live site

The site can be found at -- any change made on this repo will be automatically deployed. Therefore, make sure that the changes made build and work before pushing to master!


Documentation available at


MIT License


ArtsLink is a free web tool to help Philadelphians find quality arts experiences in neighborhoods across the city.







No releases published


No packages published