{"id":24618320,"url":"https://github.com/ryanlinjui/darkchess-robot","last_synced_at":"2025-05-07T06:24:06.570Z","repository":{"id":189680043,"uuid":"515452402","full_name":"ryanlinjui/darkchess-robot","owner":"ryanlinjui","description":"A self-learning robotic arm plays Darkchess with you in Real-World.","archived":false,"fork":false,"pushed_at":"2025-04-21T06:47:25.000Z","size":43795,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-21T07:43:53.402Z","etag":null,"topics":["aiot","computer-vision","game-theory","human-computer-interaction","robotic-arm"],"latest_commit_sha":null,"homepage":"https://www.mxeduc.org.tw/scienceaward/history/projectDoc/19th/doc/SA19-120_final.pdf","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/ryanlinjui.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}},"created_at":"2022-07-19T05:51:47.000Z","updated_at":"2025-04-21T06:47:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"4a6901b4-905e-4201-b629-803b649102c0","html_url":"https://github.com/ryanlinjui/darkchess-robot","commit_stats":null,"previous_names":["ryanlinjui/darkchess-robot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanlinjui%2Fdarkchess-robot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanlinjui%2Fdarkchess-robot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanlinjui%2Fdarkchess-robot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanlinjui%2Fdarkchess-robot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ryanlinjui","download_url":"https://codeload.github.com/ryanlinjui/darkchess-robot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252825609,"owners_count":21809950,"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":["aiot","computer-vision","game-theory","human-computer-interaction","robotic-arm"],"created_at":"2025-01-24T23:51:38.003Z","updated_at":"2025-05-07T06:24:06.563Z","avatar_url":"https://github.com/ryanlinjui.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e *\"The project has been re-developing and refactoring since now.\" - 2024.11.12*  \n\u003e *\"Now 'ONLY Brain Feature' is waiting for been completed......\" - 2025.04.05*\n\n# Darkchess Robot\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./assets/darkchess-robot.png\" alt=\"darkchess-robot\" width=300\u003e\u003cbr\u003e\n[![Research Report](https://img.shields.io/badge/ResearchReport-018EF5?logo=readme\u0026logoColor=fff)](https://www.mxeduc.org.tw/scienceaward/history/projectDoc/19th/doc/SA19-120_final.pdf)\n[![Video](https://img.shields.io/badge/Video-%23FF0000.svg?logo=YouTube\u0026logoColor=white)](https://www.youtube.com/watch?v=iaBYF3ZuBAg)\u003cbr\u003e\n[![HuggingFace](https://img.shields.io/badge/HuggingFace-Models_\u0026_Datasets-important?logo=huggingface)](https://huggingface.co/collections/ryanlinjui/darkchess-robot-670ccb8a15991c5bdad9f10c)\u003cbr\u003e\n\u003c/div\u003e\n\n# 🤖 Demo\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/demo1.gif\" alt=\"demo1\" width=\"49%\"\u003e\n  \u003cimg src=\"./assets/demo2.gif\" alt=\"demo2\" width=\"49%\"\u003e\n\u003c/div\u003e\n\n# 💡 Getting Started\n\n### Run Darkchess Robot System with Specific Mode\n```bash\n# Run Robot Server along with Website Monitor\npython app.py --robot\n\n# Run API Server of 'brain' \u0026 'eye' Only\npython app.py --api     \n```\n\u003e Go [`config.py`](./config.py) to configure app settings before running server.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/7ec51eee-12ef-4cbf-bbc5-92d692211b70\" alt=\"monitor\" width=\"46%\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/431ffc92-356f-46e2-9f94-5626907494d3\" alt=\"sample-board\" width=\"49%\"\u003e\n\u003c/div\u003e\n\n# 🚀 Features\n## Brain - AI Engine for Darkchess Board Game\nTBA......\n\n## Eye – Real-World Detection and Recognition of Darkchess Board States\n- **Model Architecture:** VGGNet-based darkchess board recognition\n- **Training Accuracy:** 99.9%\n- **Training Loss:** 7.2336e-06\n- **Real-world Test Success Rate:** 98.9%\n\n\u003e For Eye training/testing script, refer to [`eye_train.ipynb`](./eye_train.ipynb).  \n\u003e Detailed model information is available on [Huggingface](https://huggingface.co/ryanlinjui/darkchess-robot-eye-VGGNet).\n\n## Arm – Robotic Arm Control for Real-World Darkchess Applications\nOur **Third-Generation Catcher** model with robotic arm that doing **Chess-Flipping** actions in Real-World Darkchess game.\n\n\u003e Explore the [Hardware](./arm/hardware) and [Firmware](./arm/firmware) for more details.\n\n## AIoT – Darkchess Robot System Operable via WiFi\n- API server collects training data from both Eye and Brain features. \n- Just a single button press starts gameplay via WiFi remote control.\n\n\u003e For API specifications, please see [documentation](https://github.com/ryanlinjui/darkchess-robot/wiki).\n\n# 🌟 Awards \n- **Gold Medal (Int'l Top 50/408)** - 7th Kaohsiung International Invention \u0026 Design EXPO (2020)\n- **Merit (Nat'l Top 20/661)** - [19th Macronix Science Awards (2020)](https://www.mxeduc.org.tw/scienceaward/history/projectDoc/19th/production.htm)\n- **Second Place (Nat'l 2/200up)** - [12th i-ONE NARLabs Instrument Technology Innovation Competition (2020)](https://i-one.org.tw/Home/ListContents/107?ATimes=12)\n- **Second Place in Engineering(I) (Nat'l 2/151)** - [60th National Primary and High School Science Fair (2020)](https://twsf.ntsec.gov.tw/activity/race-1/60/pdf/NPHSF2020-052310.pdf?746)\n- **First Place in Engineering(I) (Reg)** - [53rd Taipei Primary and High School Science Fair (2020)](https://sites.google.com/csjh.tp.edu.tw/science/高級中等學校組/工程學科一?authuser=0#h.6xilplkz0fpy)\n- **First Place in Engineering(I) (H.S.)** - Taipei Municipal Neihu Vocational High School Independent Study (2020)\n\n# ®️ Patent\n- **Invention Patent** - *DARK CHESS ROBOT (Dec 1, 2021) - TWI748780B*\n- **Utility Model Patent** - *Robot arm gripper (Feb 21, 2021) - TWM608235U*\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"./assets/patent/TWI748780B.pdf\"\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/7f32135b-3ee8-4c84-a522-5c6f3ba06816\" alt=\"TWI748780B\" width=\"25%\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"assets/patent/TWM608235U.pdf\"\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/afdd1325-3f74-4391-bcd2-cf781295d385\" alt=\"TWM608235U\" width=\"25%\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n\u003e Please visit [here](https://tiponet.tipo.gov.tw/gpss/) and search for the patent code as mentioned above.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryanlinjui%2Fdarkchess-robot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fryanlinjui%2Fdarkchess-robot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryanlinjui%2Fdarkchess-robot/lists"}