{"id":29793009,"url":"https://github.com/shaunmulligan/radr","last_synced_at":"2025-07-28T02:08:18.611Z","repository":{"id":178379606,"uuid":"661774970","full_name":"shaunmulligan/radr","owner":"shaunmulligan","description":"An AI powered rear facing radar for your bike. Instead of using mmWave radar tech, this project uses an inexpensive raspberry pi zero 2, a camera and Coral.ai TPU accelerator to detect objects behind you.","archived":false,"fork":false,"pushed_at":"2023-07-04T17:07:33.000Z","size":14383,"stargazers_count":4,"open_issues_count":16,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-17T09:53:52.800Z","etag":null,"topics":["ai","coral-tpu","cycling","machine-learning","python","raspberry-pi"],"latest_commit_sha":null,"homepage":"","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/shaunmulligan.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":"2023-07-03T16:04:33.000Z","updated_at":"2024-04-01T22:48:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"f59ddda6-5d1e-44a8-8366-50ef6855ae84","html_url":"https://github.com/shaunmulligan/radr","commit_stats":{"total_commits":11,"total_committers":1,"mean_commits":11.0,"dds":0.0,"last_synced_commit":"ed3e89f2b83d2bcd5a3e403a2a7bdc0ba1939dd7"},"previous_names":["shaunmulligan/radr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/shaunmulligan/radr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunmulligan%2Fradr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunmulligan%2Fradr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunmulligan%2Fradr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunmulligan%2Fradr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shaunmulligan","download_url":"https://codeload.github.com/shaunmulligan/radr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunmulligan%2Fradr/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267451489,"owners_count":24089312,"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","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","coral-tpu","cycling","machine-learning","python","raspberry-pi"],"created_at":"2025-07-28T02:08:17.705Z","updated_at":"2025-07-28T02:08:18.590Z","avatar_url":"https://github.com/shaunmulligan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Radr\n\n![radr](images/radr.png)\n\nAn smart rear facing radar for your bike. Instead of using mmWave radar tech, this project uses an inexpensive raspberry pi zero 2, a camera and Coral.ai TPU accelerator to detect objects behind you.\n\n## MVP features:\n- Detect cars, cyclist (person + bicycle) and people behind you.\n    - Use the Coral.ai TPU accelerator to run the model, hopefully at ~ 25 FPS.\n    - Track multiple objects at once.\n- Implement the radar BLE Gatt service to send alerts to a cycling computer.\n- 3D print a case for the pi zero 2, camera, TPU accelerator and battery that slips in under the saddle.\n\n## Future features:\n- Add neopixel LEDs controllable via BLE Gatt service.\n- brighten LEDs when an object is detected.\n- Add ability to record video of the ride.\n- periodically save images + detection while riding and upload to cloud\n- Use the cloud to train a custom model on the images. Using something like v7Labs, roboflow or ClearML.\n- Have Models be versioned and deployed to the device via wifi when device is charging.\n\n## Usage\n1. Build the container:\n```bash\ncd radr \u0026\u0026 sudo docker build -t radr-v1 .\n```\n2. Run the container:\n```bash\nsudo docker run --rm -it --privileged radr-v1\n```\nThe `--privileged` flag is required to access the camera and USB accelerator.\n3. You should now be able to see the video stream on `http://\u003cRPI_IP_ADDRESS\u003e:8080/video`\n\n## Testing with video file.\nIf a video file with `.mp4` extension is found in the root directory, the model will run on the video file instead of the camera. This offers a nice way to consistently test the model on a known input.\n\nExample of the current model output:\n\n![object detection on road image](images/predict.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaunmulligan%2Fradr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshaunmulligan%2Fradr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaunmulligan%2Fradr/lists"}