{"id":50866024,"url":"https://github.com/david-soliar/xordle","last_synced_at":"2026-06-15T01:06:27.016Z","repository":{"id":265553700,"uuid":"896246034","full_name":"david-soliar/xordle","owner":"david-soliar","description":"Fast, simple and accurate Python CLI Xordle solver (~99%+ accurate)","archived":false,"fork":false,"pushed_at":"2025-11-06T17:48:23.000Z","size":463,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-06T19:22:50.317Z","etag":null,"topics":["algorithm","cli","puzzle","python","solver","word-game"],"latest_commit_sha":null,"homepage":"https://xordle.org/","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/david-soliar.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":"2024-11-29T21:39:56.000Z","updated_at":"2025-11-06T17:48:28.000Z","dependencies_parsed_at":"2024-11-29T22:43:35.485Z","dependency_job_id":null,"html_url":"https://github.com/david-soliar/xordle","commit_stats":null,"previous_names":["david-soliar/xordle"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/david-soliar/xordle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/david-soliar%2Fxordle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/david-soliar%2Fxordle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/david-soliar%2Fxordle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/david-soliar%2Fxordle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/david-soliar","download_url":"https://codeload.github.com/david-soliar/xordle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/david-soliar%2Fxordle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34343349,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"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":["algorithm","cli","puzzle","python","solver","word-game"],"created_at":"2026-06-15T01:06:26.328Z","updated_at":"2026-06-15T01:06:27.006Z","avatar_url":"https://github.com/david-soliar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xordle\r\n\r\nxordle is a Python package that provides tools to solve and interact with the Xordle word-guessing game. The module includes the core solver logic, a simplified emulator for testing, and CLI modes for interaction. It is designed to help analyze the game and automate the guessing process.\r\n\r\n## Installation\r\n\r\nTo install xordle locally for testing or development, use the following command in your terminal\r\n(make sure you're in the root of the project directory):\r\n\r\n```bash\r\npip install -e .\r\n```\r\n\r\n## Running Demos\r\n\r\nOnce the module is installed, you can test different functionalities using the demo scripts in the `demos` folder. \r\n\r\n\r\n### Make sure you’re in the root directory when running demos\r\n\r\n### 1. `demo01.py` - Testing 100 attempts and success Rate\r\n\r\n#### This uses the Emulator, which is more challenging than the real xordle.org games. For a more accurate test, use `demo02.py`.\r\nThis demo runs a default of 100 attempts (but you can specify a different number) and logs the success rate of solving the Xordle puzzle.\r\n\r\nWhen scripts finishes 2 files will appear:\r\n- `/log/not_guessed.txt` containing games, which solver could not guess\r\n- `/log/all_games.txt` containing all games\r\n\r\n#### How to Run:\r\n\r\n- By default, the script will run 100 attempts. To run it with a different number of attempts, use the `--games` argument followed by the desired number.\r\n\r\n    ```bash\r\n    python demos/demo01.py --games 999\r\n    ```\r\n\r\n- If no argument is passed, it will default to 100 attempts.\r\n\r\n    ```bash\r\n    python demos/demo01.py\r\n    ```\r\n\r\n### 2. `demo02.py` - Testing first 1000 games from xordle.org\r\n\r\n#### This uses real xordle.org games. For more broad testing, use `demo01.py`.\r\nThis demo runs a configurable number of attempts (default is 1000) and logs the success rate of solving the Xordle puzzle.\r\n\r\n#### How to Run:\r\n\r\n- By default, the script will run 1000 attempts starting from the first game. You can modify the number of games to test and the offset using the `--offset` and `--games` arguments.\r\n\r\n    To run the demo with the default settings (1000 games starting from the first):\r\n\r\n    ```bash\r\n    python demos/demo02.py\r\n    ```\r\n\r\n- To specify a different starting game or the number of games to test, use the `--offset` (starting game) and `--games` (number of games) options:\r\n\r\n    Example with offset and custom number of games:\r\n\r\n    ```bash\r\n    python demos/demo02.py --offset 100 --games 500\r\n    ```\r\n\r\n### 4. `demo03.py` - Running xorlde solver in CLI Normal Mode\r\nThis demo runs the solver in CLI mode, where you can play the Xordle in normal mode version.\r\n\r\n#### How to Run:\r\n\r\n- Run the following command:\r\n\r\n    ```bash\r\n    python demos/demo03.py\r\n    ```\r\n\r\n### 3. `demo04.py` - Running xordle solver in CLI Hard Mode\r\nThis demo runs the solver in CLI mode, where you can play the Xordle in hard mode version.\r\n\r\n#### How to Run:\r\n\r\n- Run the following command:\r\n\r\n    ```bash\r\n    python demos/demo04.py\r\n    ```\r\n\r\n### 5. `demo05.py` - Testing one attempt with given clue and two words to guess\r\nThis demo is similar to `demo01.py` but only tests a single attempt with a given first word and two words to guess.\r\n\r\n#### How to Run:\r\n\r\n- Run the following command:\r\n\r\n    ```bash\r\n    python demos/demo05.py xclue word1 word2\r\n    ```\r\n*(xclue word1 word2) are words of your choice\r\n\r\n### 5. `demo06.py` - Testing all games which solver in `demo01.py` failed to guess\r\nThis demo tests all games in file `/log/not_guessed.txt` generated by `demo01.py`.\r\n\r\n#### How to Run:\r\n\r\n- Run the following command:\r\n\r\n    ```bash\r\n    python demos/demo06.py\r\n    ```\r\n\r\n# \r\n# hard mode sometimes does not work as it should\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavid-soliar%2Fxordle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavid-soliar%2Fxordle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavid-soliar%2Fxordle/lists"}