{"id":26795932,"url":"https://github.com/iamfarrokhnejad/access-sysstem","last_synced_at":"2025-03-29T18:16:32.719Z","repository":{"id":284982123,"uuid":"956700805","full_name":"IAmFarrokhnejad/Access-Sysstem","owner":"IAmFarrokhnejad","description":"2FA  with Arduino Keypad and Python Face Recognition","archived":false,"fork":false,"pushed_at":"2025-03-28T17:56:50.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T18:48:42.356Z","etag":null,"topics":["2fa","2factor","arduino","edge","edge-ai","embedded","embedded-systems","face-recognition","industrial","iot","opencv","pyserial","python","python3","security"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IAmFarrokhnejad.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":"2025-03-28T17:51:31.000Z","updated_at":"2025-03-28T18:37:04.000Z","dependencies_parsed_at":"2025-03-28T18:48:44.025Z","dependency_job_id":"cbd6486a-df1c-408b-a480-5b10fcb17bc4","html_url":"https://github.com/IAmFarrokhnejad/Access-Sysstem","commit_stats":null,"previous_names":["iamfarrokhnejad/access-sysstem"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IAmFarrokhnejad%2FAccess-Sysstem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IAmFarrokhnejad%2FAccess-Sysstem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IAmFarrokhnejad%2FAccess-Sysstem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IAmFarrokhnejad%2FAccess-Sysstem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IAmFarrokhnejad","download_url":"https://codeload.github.com/IAmFarrokhnejad/Access-Sysstem/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246223325,"owners_count":20743168,"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":["2fa","2factor","arduino","edge","edge-ai","embedded","embedded-systems","face-recognition","industrial","iot","opencv","pyserial","python","python3","security"],"created_at":"2025-03-29T18:16:32.083Z","updated_at":"2025-03-29T18:16:32.714Z","avatar_url":"https://github.com/IAmFarrokhnejad.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Access Sysstem 🔒\n\n**Two-Factor Authentication System combining Arduino Keypad and Python Face Recognition**\n\n\nA robust security system that combines password authentication via physical keypad with facial recognition for secure access control. Built with Arduino and Python.\n\n## Features ✨\n- **Dual Authentication**: Requires both password AND face recognition\n- **Physical Keypad Interface**: 4x4 matrix keypad for secure password entry\n- **Real-Time Face Recognition**: Live camera face matching with tolerance control\n- **Security Measures**:\n  - Password attempt limits\n  - System lockout after multiple failures\n  - Encrypted face data storage\n- **Visual Feedback**: Three-color LED status indicators\n- **Comprehensive Logging**: Detailed access attempts and system events\n- **Remote Management**: Serial communication between Arduino and Python\n\n## Hardware Requirements 🛠️\n- Arduino Uno/Nano\n- 4x4 Matrix Membrane Keypad\n- USB Webcam\n- 3x LEDs (Green, Red, Blue)\n- Resistors (220Ω)\n- Breadboard and jumper wires\n\n**Connection Guide**:\n| Arduino Pin | Component  |\n|-------------|------------|\n| 2-6         | Keypad Columns |\n| 7-9         | Keypad Rows |\n| 10          | Green LED  |\n| 11          | Red LED    |\n| 12          | Blue LED   |\n\n## Software Requirements 💻\n- Python 3.8+\n- Arduino IDE 2.x\n- Required Python Packages:\n  ```bash\n  face_recognition, opencv-python, pyserial, numpy\n\n\n## Installation 📦\n1. Clone repository:\n\n  ```bash\ngit clone https://github.com/IAmFarrokhnejad/access-system.git\ncd access-system\n```\n\n2. Upload Arduino sketch:\n\n- Open ===sketch.ino=== in Arduino IDE\n\n- Install Keypad library (Tools \u003e Manage Libraries)\n\n- Upload to Arduino board\n\n3. Install Python dependencies:\n\n  ```bash\n  face_recognition, opencv-python, pyserial, numpy\n  ```\n4. Set up known faces:\n\n  ```bash\nmkdir known_faces\n```\n\n5. Configure settings in app.py\n\n\n## Usage 🚀\n1. Start the system:\n\n  ```bash\npython app.py\n\n```\n2. Keypad commands:\n\n- Digits 0-9: Password entry\n\n- A: Backspace\n\n- B: Submit password\n\n- C: Start face scan\n\n- D: System reset\n\n3. LED Status Indicators:\n\n**sGreen**: Access granted\n\n**Red**: Access denied/system locked\n\n**Blue**: Face scan in progress\n\n4. Typical workflow:\n\n- Enter password using keypad\n\n- Press B to submit\n\n- If password correct, face scan automatically initiates\n\n- Look at camera for face verification\n\n- Receive access grant/denial via LEDs\n\n## Troubleshooting 🐞\n**Common Issues:**\n\n- **Camera not detected**: Ensure no other applications are using the webcam\n\n- **Serial connection errors:**\n\n- Verify correct COM port in configuration\n\n- Check Arduino drivers are installed\n\n- **Face recognition failures:**\n\n- Ensure good lighting conditions\n\n- Add multiple face angles to known_faces\n\n- Adjust FACE_MATCH_THRESHOLD in config\n\n## Safety \u0026 Privacy 🔐\n- All face data stored locally in known_faces directory\n\n- System logs contain no biometric data\n\n- Recommended for secure environments only\n\n- Rotate passwords regularly for enhanced security\n\nLicense 📄\nMIT License - See LICENSE for details","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamfarrokhnejad%2Faccess-sysstem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamfarrokhnejad%2Faccess-sysstem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamfarrokhnejad%2Faccess-sysstem/lists"}