{"id":21019088,"url":"https://github.com/tmobile/pi-alarm","last_synced_at":"2025-05-15T06:32:02.231Z","repository":{"id":81513308,"uuid":"152476706","full_name":"tmobile/pi-alarm","owner":"tmobile","description":"Raspberry Pi Alarm","archived":false,"fork":false,"pushed_at":"2018-12-07T19:25:32.000Z","size":1013,"stargazers_count":11,"open_issues_count":3,"forks_count":4,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-03T05:13:12.026Z","etag":null,"topics":["alarm","python3","raspberry-pi","tmobile"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmobile.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-10T19:16:18.000Z","updated_at":"2025-01-16T10:27:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"20dc22b2-6fb3-46be-963e-7c164541b4d3","html_url":"https://github.com/tmobile/pi-alarm","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmobile%2Fpi-alarm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmobile%2Fpi-alarm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmobile%2Fpi-alarm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmobile%2Fpi-alarm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmobile","download_url":"https://codeload.github.com/tmobile/pi-alarm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254288357,"owners_count":22045884,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["alarm","python3","raspberry-pi","tmobile"],"created_at":"2024-11-19T10:29:02.466Z","updated_at":"2025-05-15T06:32:02.226Z","avatar_url":"https://github.com/tmobile.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Raspberry Pi Alarm\n\n![Pi Alarm](docs/images/pi-alarm-medium.jpg)\n\n## Overview\n\nControl an alarm with a Raspberry Pi over the internet! Development teams at [T-Mobile](https://opensource.t-mobile.com/) use Pi-Alarm to provide a clear visual alert to developers whenever something goes wrong. Here are a few examples of triggers that turn on the alarm at T-Mobile:\n\n* Build failures\n* Automated test failures\n* Custom telemetry triggers\n* When the boss walks over and we want them to go away\n* When an application or web service becomes unresponsive in production\n* Lunch time!\n\n## User Documentation\n\nThis readme file is geared towards developers looking to contribute to this project. For instructions on building and using pi-alarm, check out the [end-user documentation](docs/).\n\n## Developer Guide\n\n**You don't need a Raspberry Pi to contribute!** However, it helps if you're already familiar with the [end-user documentation](docs/) which covers the [overall design](docs/), [software installation instructions](docs/software-instructions.md), and [hardware build instructions](docs/build-instructions.md).\n\nOnce you're familiar with and understand the hardware build, software installation, and usage instructoins, then you're ready to start contributing!\n\n### Clone the Repository\n\n```bash\ngit clone https://github.com/tmobile/pi-alarm.git\n```\n\n### Install Development Dependencies\n\nYou'll need the folowing software to build and run the Pi-Alarm project:\n\n### Getting Python 3\n\nCheck to see if you have Python 3 installed already. To check, in your terminal run the following command:\n\n```bash\n$ python -V\nPython 3.7.0\n```\n\nIf you get an error, [download and install](https://www.python.org/downloads/) the latest version of Python 3.\n\n\u003e *Note for Cygwin users: If you installed Python/Pip3 via Cygwin, you will need to install Python on Windows OS explicitly and add it to your `PATH` for the unit tests to run succesfully.\n\n#### Getting Python 3 on the Pi\n\nYour Raspberry Pi might be Python 2 by default. To use Python 3 on the Pi, change /usr/bin/python to point to /usr/bin/python3:\n\n```bash\nsudo su\nrm /usr/bin/python\nln -s /usr/bin/python3 /usr/bin/python\n```\n\n### Install Required Packages\n\n```bash\npip install Flask Flask-API flask-cors PyYAML\n```\n\n## Testing\n\nTo make sure everything is working and read-to-go, run the unit tests:\n\n```bash\npython -m unittest\n```\n\nMake sure all tests pass. If not, you'll have to troubleshoot.\n\n## Debugging\n\nYou can interactively debug the app while it is running.  \n\n```bash\nsudo su\nexport FLASK_APP=alarm.py\nexport FLASK_DEBUG=1\nflask run\n```\n\n## Contributions\n\nCode contributions are most likely to be accepted if they are useful, well documented, and covered by unit tests.\n\nWe'd love to hear how you are using Pi-alarm.  Post pictures of how you are using your setup [here](docs/user_contrib/README.md).\n\n## Forking\n\nWe welcome people experimenting with different platforms and different software versions.  Please note that we cannot provide support or modifications for platforms and software different than what we use.  However, you should feel free to fork the tree for new platforms and software.  As per best practices, have your Information Technology department review this source code or any forks prior to any production or consequential use.  Please note that any forms of the tree are to comply with any open source licenses including Apache 2.0.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmobile%2Fpi-alarm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmobile%2Fpi-alarm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmobile%2Fpi-alarm/lists"}