{"id":29050793,"url":"https://github.com/contractor-x/speedpass","last_synced_at":"2026-04-22T23:35:14.199Z","repository":{"id":301059687,"uuid":"1008020032","full_name":"Contractor-x/SpeedPass","owner":"Contractor-x","description":"A Regulatory Software for Discovering and Confronting Bad Drivers ","archived":false,"fork":false,"pushed_at":"2025-09-02T14:52:24.000Z","size":160,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-02T16:29:20.540Z","etag":null,"topics":["email","python","reporting","road","roadrunner","smtp","streamlit","student","student-project"],"latest_commit_sha":null,"homepage":"https://speedpass.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Contractor-x.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-24T22:42:50.000Z","updated_at":"2025-09-02T14:52:27.000Z","dependencies_parsed_at":"2025-09-02T16:18:32.207Z","dependency_job_id":"2d61de3a-7b6d-46ad-8746-194aada8a5c5","html_url":"https://github.com/Contractor-x/SpeedPass","commit_stats":null,"previous_names":["contractor-x/speedpass"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Contractor-x/SpeedPass","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contractor-x%2FSpeedPass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contractor-x%2FSpeedPass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contractor-x%2FSpeedPass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contractor-x%2FSpeedPass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Contractor-x","download_url":"https://codeload.github.com/Contractor-x/SpeedPass/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contractor-x%2FSpeedPass/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32159959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["email","python","reporting","road","roadrunner","smtp","streamlit","student","student-project"],"created_at":"2025-06-26T21:36:46.189Z","updated_at":"2026-04-22T23:35:14.192Z","avatar_url":"https://github.com/Contractor-x.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"#  SpeedPass Traffic System — A Beginner Python Project\n\n**License Plate Detection \u0026 Automated Speed Violation Alerts (Dummy Version)**\n\n---\n\n## Basic Project Description\n\nThis is a beginner-friendly Python project simulating an intelligent traffic speed monitoring system. It reads license plates (dummy data), checks for speed violations, and sends automated alerts to the HQ and law enforcement (via dummy Gmail SMTP).\n\nThe system also simulates issuing fines to offenders and allows a basic web portal to display violation records and payment status (for demo purposes only).\n\n** Top Features:**\n\n* Reads dummy car plate numbers.\n* Simulates over-speed detection.\n* Sends automated email to \"cops\" if speed limit broken.\n* Sends fine notification to offender via email.\n* Stores vehicle \u0026 violation data in Supabase (dummy records).\n* Simple website (Streamlit) to view offenses and pay fines (dummy payment logic).\n\n---\n\n##  Project Structure\n\n```\nspeedpass-traffic-system/\n├── app/\n│   ├── main.py             # Main script to simulate traffic monitoring\n│   ├── plate_reader.py     # Simulates license plate detection\n│   ├── speed_checker.py    # Speed checking logic\n│   ├── alert_system.py     # Email alert system (Gmail SMTP)\n│   ├── database.py         # Supabase integration (dummy records)\n│   └── payment.py          # Simulate fine payment logic\n├── web/\n│   ├── app.py              # Streamlit web portal\n#├── .env                    # For storing API keys, credentials (excluded in .gitignore)\n├── requirements.txt\n├── README.md\n└── LICENSE\n```\n\n---\n\n##  Streamlit\n\n* View list of recent violations (pulled from Supabase dummy DB).\n* Search for your plate number to check fines.\n* Dummy \"Pay Fine\" button that updates status in Supabase.\n\n---\n\n## Tech Stack\n\n* **Python 3.11+**\n* **Streamlit** for web interface.\n* **dotenv** for secure environment variables.\n\n---\n\n##  Dummy Email Alert Example\n\n```\nSubject: SPEEDING VIOLATION ALERT — Vehicle Plate: ABC-1234\n\nDear Officer,\n\nThe vehicle with plate number ABC-1234 has been detected exceeding the speed limit.\n\nOffense Details:\n- Speed: 140 km/h\n- Allowed Limit: 100 km/h\n- Location: Dummy Expressway 1\n- Time: 2025-06-24 14:35\n\nPlease take necessary action. A fine notice has been sent to the registered owner.\n\nRegards,  \nSpeedPass HQ Monitoring System\n```\n\n**Owner receives:**\n\n```\nSubject: Notice of Speed Violation — Plate: ABC-1234\n\nDear Vehicle Owner,\n\nOur system detected your vehicle exceeding the speed limit.\n\n- Speed: 140 km/h\n- Allowed Limit: 100 km/h\n- Fine: $100\n\nPlease visit the SpeedPass portal to view details and complete payment.\n\n[Dummy Link to Pay Fine]\n\nFailure to pay within 7 days may result in further action.\n\nRegards,  \nSpeedPass HQ\n```\n\n---\n\n##  Dev Setup\n\n```bash\ngit clone https://github.com/Contractor-x/speedpass-traffic-system.git\ncd speedpass-traffic-system\npip install -r requirements.txt\n```\n\n1. Set up your `.env` with dummy Supabase keys and Gmail credentials.\n2. Run `python app/main.py` to simulate system monitoring.\n3. Run `streamlit run web/app.py` to open the portal.\n\n---\n\n##  Future improvements\n\n* Upgrade to real-time license plate reading (OpenCV, later).\n* Integrate real payment systems.\n* Add authentication to portal.\n* Connect real hardware (if desired).\n\n---\n\n##  Disclaimer\n\n**This is a beginner demo project. Not intended for real law enforcement use. Emails, databases, and payment logic are simulated.**\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontractor-x%2Fspeedpass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontractor-x%2Fspeedpass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontractor-x%2Fspeedpass/lists"}