{"id":44290177,"url":"https://github.com/codefordenver/waterbeacon","last_synced_at":"2026-02-10T23:33:16.670Z","repository":{"id":37602933,"uuid":"69771797","full_name":"codefordenver/waterbeacon","owner":"codefordenver","description":"waterbeacon","archived":false,"fork":false,"pushed_at":"2023-03-06T20:46:39.000Z","size":62726,"stargazers_count":8,"open_issues_count":28,"forks_count":5,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-10-10T17:57:20.944Z","etag":null,"topics":["code-for-america","code-for-denver","health","water","waterquality"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codefordenver.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-10-02T00:51:53.000Z","updated_at":"2022-02-16T06:49:42.000Z","dependencies_parsed_at":"2023-09-25T00:58:28.751Z","dependency_job_id":null,"html_url":"https://github.com/codefordenver/waterbeacon","commit_stats":{"total_commits":408,"total_committers":16,"mean_commits":25.5,"dds":0.5931372549019608,"last_synced_commit":"9349458b3595c647e150ab3488f4c14259c04dc5"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codefordenver/waterbeacon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefordenver%2Fwaterbeacon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefordenver%2Fwaterbeacon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefordenver%2Fwaterbeacon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefordenver%2Fwaterbeacon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codefordenver","download_url":"https://codeload.github.com/codefordenver/waterbeacon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefordenver%2Fwaterbeacon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29321398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T20:44:44.282Z","status":"ssl_error","status_checked_at":"2026-02-10T20:44:43.393Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-for-america","code-for-denver","health","water","waterquality"],"created_at":"2026-02-10T23:33:16.599Z","updated_at":"2026-02-10T23:33:16.661Z","avatar_url":"https://github.com/codefordenver.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# waterbeacon\n\nwaterbeacon\n\n## Resources\n\n[Water quality data](https://www.waterqualitydata.us/)\n\n## NSF Water Quality Index\n\n[Water quality index calc](http://home.eng.iastate.edu/~dslutz/dmrwqn/water_quality_index_calc.htm)\n\n## API Installation Guide\n\nYou'll need to install `python3` along with `pip`.\n\nNext, you'll need to install [python virtual environment wrapper](https://virtualenvwrapper.readthedocs.io/en/latest/). You can do so by running `pip install virtualenvwrapper`.\n\nNow, activate a python virtual environment by running `mkvirtualenv ${ENV_NAME}`. The `ENV_NAME` is arbitrary. We'll use \"wb\" for simplicity.\n\nFinally, run `pip install -r requirements.txt` to install necessarry dependencies.\n\nBefore moving forward, make sure that you have postgresql installed and running. Run `brew install postgresql`\n\nMake sure you have the folling tools are installed:\n\n- [Postgres](https://postgresapp.com/downloads.html)\n- [pgAdmin](https://www.postgresql.org/ftp/pgadmin/pgadmin4)\n- [PSequel](http://www.psequel.com/)\n- You may need to manually install [GeoDjango](https://docs.djangoproject.com/en/1.11/ref/contrib/gis/install/#homebrew). If you have trouble with it, consider using brew.\n\nMay be required:\n\n- [libpq-dev](https://pypi.org/project/libpq-dev/)\n- [postgis](https://postgis.net/install/)\n- [gdal-bin](https://gdal.org/)\n\nCreate an empty .env file `touch .env`.\n\nCreate the waterbeacon database by running `createdb waterbeacon`\n\n(Optional - Linux Users) You may need to create a new Postgres User or update the default Postgres User to have access to the database. Do this by running the following:\n\n    sudo su - postgres\n\n    psql\n\n    CREATE USER myprojectuser WITH PASSWORD 'password';\n\n    GRANT ALL PRIVILEGES ON DATABASE waterbeacon TO myprojectuser;\n\nYou should then update the 'USER' and 'PASSWORD' to the dev.py file in the settings folder to your newly created postgres user.\n\nWhen that completes, run `./manage.py migrate --settings=settings.dev` to create a local postgres db instance for development.\n\n(Optional - never necessary if csvs exist) To get all the new facility location data from the EPA, you can run `./manage.py download_epa_facility_data --settings=settings.dev`\n\n(Optional - never necessary if csvs exist) To get all the new SDWA data from the EPA, you can run `./manage.py download_epa_water_data --settings=settings.dev`\n\n(Optional) Populate the rawdata app with EPA data by running the following:\n\n`./manage.py import_epa_facility_data --settings=settings.dev;./manage.py import_epa_water_data --settings=settings.dev;./manage.py insert_facility_fips --settings=settings.dev;./manage.py data_cruncher --settings=settings.dev`\n\nFinally, run `./manage.py runserver --settings=settings.dev` to kick off a dev server.\n\nThe dev server will run on `localhost:8000` by default. If you prefer another port, just pass the desired port number following the previous command. That is `./manage.py runserver --settings=settings.dev ${PORT}`\n\n_Note_: to deactive the virtual env wrapper, just run `deactivate`.\n\n## Frontend Installation Guide\n\nNavigate to the frontend directory where the react app is located and run install\n\n- `cd frontend`\n- `npm install`\n\nAfter installation you can run `npm start` which will run the react app on localhost:3000 with \"hot reload\" enabled.\n\n### Server Installation Notes\nIn primary folder create a .env file and place the following parameters:\n```\nDEBUG=\nDATABASE_URL=\nPG_USERNAME=\nPG_PASSWORD=\nENVIRONMENT=\nDJANGO_SETTINGS_MODULE=\nCELERY_BROKER_URL=\nFLOWER_PORT=\nTWITTER_ACCESS_TOKEN_SECRET=\nTWITTER_ACCESS_TOKEN=\nTWITTER_CONSUMER_SECRET=\nTWITTER_CONSUMER_KEY=\nVIRTUAL_PORT=\nSENTRY_DSN=\nEMAIL_FROM=\n```\n\nWithin ./frontend folder create a .env file and place the following parameters:\n```\nVIRTUAL_HOST=[domain]\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodefordenver%2Fwaterbeacon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodefordenver%2Fwaterbeacon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodefordenver%2Fwaterbeacon/lists"}