https://github.com/jacobhenner/nhsabot
Python bot that tweets when North Hudson Sewerage Authority sewage is draining into the Hudson River, between New York and New Jersey.
https://github.com/jacobhenner/nhsabot
Last synced: about 1 year ago
JSON representation
Python bot that tweets when North Hudson Sewerage Authority sewage is draining into the Hudson River, between New York and New Jersey.
- Host: GitHub
- URL: https://github.com/jacobhenner/nhsabot
- Owner: JacobHenner
- License: gpl-3.0
- Created: 2018-03-11T23:17:40.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-11-23T16:30:56.000Z (over 6 years ago)
- Last Synced: 2025-06-12T11:04:38.146Z (about 1 year ago)
- Language: Python
- Homepage: https://socialcoders.org/JacobHenner/NHSABot/
- Size: 35.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# North Hudson Sewerage Authority Bot (NHSABot)
NHSABot is a Python bot that tweets when [North Hudson Sewerage Authority](http://www.nhudsonsa.com/) sewage is draining into the Hudson River, between New York and New Jersey. These events are referred to as [combined sewer overflows](https://en.wikipedia.org/wiki/Combined_sewer#Combined_sewer_overflows_\(CSOs\)) (CSOs).
As of April 19, 2018, the bot also tweets [National Weather Service](https://www.weather.gov/) alerts for Hudson County which are categorized as moderate or severe.
This project is primarily hosted on [SocialCoders](https://socialcoders.org/JacobHenner/NHSABot).
## Getting Started
### Prerequisites
Install required Python dependencies using pip.
`pip install -r requirements.txt`
### Running
To run all components: `python NHSABot.py`
To successfully run the Twitter component, the bot expects the following environment variables to be set.
1. CONSUMER_SECRET
2. CONSUMER_TOKEN
3. USER_KEY
4. USER_SECRET
## Authors
* **Jacob Henner** - [JacobHenner](https://github.com/JacobHenner)
## License
This project is licensed under the GNU GPLv3 - see the [LICENSE](LICENSE) file for details.
## Additional Notes
* This project is unaffiliated with the North Hudson Sewerage Authority, any other agency, or any municipality.
* The data collected by this bot depends upon a third-party SCADA system, and as such, its accuracy cannot be guaranteed.
* Please be respectful when running the status updater and ensure that you rate-limit your queries.