This repo contains the source code of the front-end for www.GovTrack.us. The data-gathering scripts are elsewhere.

GovTrack.us runs on Ubuntu 12.10.

• Install dependencies via OS package manager:

  apt-get install git python-virtualenv python-lxml python-openid python-oauth2 \
      python-iso8601 python-numpy python-scipy yui-compressor
  

• Clone the source code. Besides this project, you'll also need @unitedstates/congress-legislators which is where legislator and committee information come from.

  git clone https://github.com/unitedstates/congress-legislators   
  git clone --recursive https://github.com/govtrack/govtrack.us-web.git
  

• Change directory to the source code root:

  cd ./govtrack.us-web/
  

• Create a local settings file based on the example file:

  cp settings_local.example.py settings_local.py
  

• Edit settings_local.py to set up your database. The default configuration uses SQLite as the database and no database configuration is required. Fill in SECRET_KEY though. Here's how you can generate a SECRET_KEY:

  python -c 'import random; print "".join([random.choice("abcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*(-_=+)") for i in range(50)])'
  

• Run the build script to install additional dependencies into a virtual environment:

  ./build/buildenv.sh
  

• To enable search:

  • Install Solr:

    apt-get install openjdk-7-jre jetty
    

  • Follow the instructions at:

    http://django-haystack.readthedocs.org/en/latest/installing_search_engines.html#solr

  • Symlink ./bill/solr_schema.xml to ./solr/conf/schema.xml.

• Initialize the database and minify some files:

  ./manage.py syncdb
  ./minify
  

• Load some data:

  wget http://www.govtrack.us/data/db/django-fixture-people.json
  ./manage.py loaddata django-fixture-people.json
  
  ./parse.py committee
  
  ./build/rsync.sh
  ./parse.py bill --congress=113
  

• Check the site works by running the development server and visiting the URL specified by the runserver process.

  ./manage.py runserver
  

• To update the data in the future, first git-pull congress-legislators to get the latest legislator information. Then:

  build/rsync.sh
  ./parse.py person
  ./parse.py committee --congress=113
  ./parse.py bill --congress=113
  ./parse.py vote --congress=113
  

• TODO: We haven't set up any search indexing, so all of the search pages will come up empty.