Govcode is an application that lists government open source projects. The purpose is to track what is being worked on and build analytics on top of it.

1. Clone this repo or a fork of it

   git clone https://github.com/cfpb/collab.git
   cd collab

2. Make sure you have pip and virtualenv installed:

   • http://pip.readthedocs.org/en/latest/installing.html

   • http://www.virtualenv.org/en/latest/virtualenv.html#installation

3. Edit the config settings locally to match your environment. You can find them at /config/init.py

4. Create the database tables:

   python ./manage.py shell
   >>> from extensions import db
   >>> db.create_all()

5. Run the Flask server:

   python ./manage.py runserver

6. Go to http://localhost:5000 in your browser.

At this point your database should be empty. To actually import the packages you need to run the import script.

1. First you need to get a Github:

   Go to https://github.com/settings/tokens/new, create a token with public_repo access and copy the token.

2. Store the token in an environment variable:

   export GH_TOKEN=xxxxxxxxxxxx

3. Run the import script:

   python gh_import.py