{"id":16200925,"url":"https://github.com/ivaniscoding/quantomoku","last_synced_at":"2026-05-02T02:40:02.718Z","repository":{"id":87028215,"uuid":"233298546","full_name":"IvanIsCoding/Quantomoku","owner":"IvanIsCoding","description":"An educational quantum game that runs on quantum computers - built during nwHacks 2020","archived":false,"fork":false,"pushed_at":"2020-09-20T22:01:30.000Z","size":6897,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-07T18:16:20.606Z","etag":null,"topics":["educational-game","python","qiskit","quantum-computing","socketio","vuejs"],"latest_commit_sha":null,"homepage":"https://www.behance.net/gallery/90676147/Quantomoku-Bakery","language":"Vue","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/IvanIsCoding.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":"2020-01-11T21:16:35.000Z","updated_at":"2023-02-19T05:40:28.000Z","dependencies_parsed_at":"2023-03-12T20:15:37.571Z","dependency_job_id":null,"html_url":"https://github.com/IvanIsCoding/Quantomoku","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/IvanIsCoding/Quantomoku","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IvanIsCoding%2FQuantomoku","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IvanIsCoding%2FQuantomoku/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IvanIsCoding%2FQuantomoku/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IvanIsCoding%2FQuantomoku/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IvanIsCoding","download_url":"https://codeload.github.com/IvanIsCoding/Quantomoku/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IvanIsCoding%2FQuantomoku/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32521113,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"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":["educational-game","python","qiskit","quantum-computing","socketio","vuejs"],"created_at":"2024-10-10T09:34:50.419Z","updated_at":"2026-05-02T02:40:02.695Z","avatar_url":"https://github.com/IvanIsCoding.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quantomoku [![Vue.js](https://img.shields.io/badge/-Vue.js-41b883)](https://github.com/topics/vuejs) [![Python](https://img.shields.io/badge/-Python-blue)](https://github.com/topics/python) [![Qiskit](https://img.shields.io/badge/-Qiskit-blueviolet)](https://github.com/topics/qiskit) [![Socket.IO](https://img.shields.io/badge/-Socket.IO-green)](https://github.com/topics/socketio)\n\n\u003cp align=\"center\"\u003e \n\u003cimg width=\"360\" height=\"414\" src=\"client/src/assets/Quat.png\"\u003e\n\u003c/p\u003e\n\nQuantomoku is an educational quantum game aimed at children. The game is inspired by the traditional Connect 5 game: two players alternate putting pieces on a board, and the first one to line up 5 pieces wins. However, there is a twist: in addition to the normal Connect 5 moves, players can play two new quantum moves: superpositions and entanglements!\n\nMoreover, the game is truly quantum: as the players play, a quantum circuit is built in the backend. Hence, quantum computers can be used to decide the result of the game.\n\n## Setting up\n\n### Javascript dependencies\n\nJavascript dependencies are managed by `npm`. To install them, run on the root directory:\n\n```\ncd client \u0026\u0026 npm install\n```\n\n### Python dependencies\n\nPython dependencies are managed by `pip`. To install them, run on the root directory:\n\n```\npip3 install -r requirements.txt\n```\n\n### Using the quantum cloud in the game\n\nBy default, the game runs the quantum circuits locally in a simulator. If you wish to run them on the quantum cloud on a real quantum computer, create an environment variable called `IBM_Q` set to your IBM Q API Token. Then, run:\n\n```\npython3 setup_ibmq.py\n```\n\nNotice that depending on the queue on the quantum cloud, this might make the game have delays that will affect gameplay.\n\n## Playing the game\n\nFor the game to work, both the server and the client need to be running on the same time. You may launch both together by running:\n\n```\npython3 server.py \u0026 cd client \u0026\u0026 npm run serve\n```\n\nAfter executing the command, the game will be now running. You can access it by going into a web browser and visiting `https://localhost:8080`. \n\n### Tutorial\n\nTo discover more about the mechanics of the game, there is an in game tutorial: just click on the Tutorial button on the main page. Quat, the Quantum Cat will explain how the game works for you.\n\n## Built With\n\n* [Vue.js](https://vuejs.org/) - Front end\n* [Python](https://www.python.org/) - Back end\n* [Qiskit](https://qiskit.org/) - Used for building quantum circuits and executing them on real quantum computers at IBM Quantum Experience\n* [Socket.IO](https://socket.io/) - Used to communicate between the front end and the back end\n\n## Authors\n\n* [**Jean-Philippe Abadir**](https://github.com/jpabadir)\n* [**Ivan Carvalho**](https://github.com/ivaniscoding)\n* [**Devina Jaiswal**](https://github.com/devinapj)\n* [**Kathryn Ng**](https://github.com/kathrynng)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivaniscoding%2Fquantomoku","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivaniscoding%2Fquantomoku","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivaniscoding%2Fquantomoku/lists"}