{"id":30516781,"url":"https://github.com/gsilva00/ia-project1","last_synced_at":"2025-08-26T10:07:15.147Z","repository":{"id":310812135,"uuid":"989301602","full_name":"gsilva00/IA-Project1","owner":"gsilva00","description":"FEUP L.EIC 2024/25 - 3rd Year, 2nd Semester - 1st Project developed in the Artificial Intelligence curricular unit","archived":false,"fork":false,"pushed_at":"2025-08-20T10:39:01.000Z","size":5894,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-20T12:22:05.106Z","etag":null,"topics":["artificial-intelligence","feup","game","ia","leic","programming","search-algorithms"],"latest_commit_sha":null,"homepage":"https://sigarra.up.pt/feup/en/UCURR_GERAL.FICHA_UC_VIEW?pv_ocorrencia_id=541894","language":"Python","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/gsilva00.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-23T20:48:32.000Z","updated_at":"2025-08-20T10:20:38.000Z","dependencies_parsed_at":"2025-08-20T12:22:19.834Z","dependency_job_id":"f2049c65-b35a-492d-b360-974636ed91f7","html_url":"https://github.com/gsilva00/IA-Project1","commit_stats":null,"previous_names":["gsilva00/ia-project1"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/gsilva00/IA-Project1","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsilva00%2FIA-Project1","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsilva00%2FIA-Project1/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsilva00%2FIA-Project1/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsilva00%2FIA-Project1/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gsilva00","download_url":"https://codeload.github.com/gsilva00/IA-Project1/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsilva00%2FIA-Project1/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272207457,"owners_count":24891974,"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","status":"online","status_checked_at":"2025-08-26T02:00:07.904Z","response_time":60,"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":["artificial-intelligence","feup","game","ia","leic","programming","search-algorithms"],"created_at":"2025-08-26T10:07:14.581Z","updated_at":"2025-08-26T10:07:15.139Z","avatar_url":"https://github.com/gsilva00.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FEUP - Artificial Intelligence - 2024/2025\n\n\u003e Curricular Unit: IA - [Inteligência Artificial](https://sigarra.up.pt/feup/pt/UCURR_GERAL.FICHA_UC_VIEW?pv_ocorrencia_id=541894)\n\n## 3rd Year - 2nd Semester - 1st Group Project\n\n### How to run the project\n\n\u003e Ensure you have Python 3.x is installed on your system.\n\u003e Also ensure that you have pip3 installed. It is included by default in Python 3.4 and later versions.\n\n1. Clone the repository\n2. Navigate to the project directory\n3. Install the required dependencies\n\n```bash\npip install uv\n```\n\n\u003e Or another installation method as per [UV's documentation](https://docs.astral.sh/uv/getting-started/installation/)\n\n4. Run the project\n\n```bash\nuv run woodblock\n```\n\n## Navigation\n\nThere are multiple screens in our project so we decided to write this navigation guide to help any user that finds themselves lost. This is the common navigation order for a common user:\n\n\u003e **Start Screen:** Welcome page, simply click anywhere on the program screen in order to proceed\n\u003e\n\u003e **Player Select Screen:** In this page you will choose wether the player will be the human user with an helper ai for hints or an ai\n\u003e\n\u003e **Algorithm Select Screen:** In this page you will select the algorithm that the ai will use, either for hints in case of a human player, or simply for an ai player\n\u003e\n\u003e **Gamemode Select Screen:** In this screen you will select if you either want to play the levels where the objective is to clear all target blocks on the screen in the least amount of moves, or the infinite gamemode where the objective is to clear the biggest amount of lines/columns before the board is filled and no available piece can be placed\n\u003e\n\u003e **Level Select Screen:** In this screen you can choose the level you wish to select. Note that even though the board is the same for the same level, the pieces are randomly generated every time the level is replayed. In case you wish to compare algorithms, you will need to select custom levels where every information about the level is stored in the custom directory\n\n### Developed by:\n\n1. Gabriel Carvalho - E-mail: up202208939@up.pt\n2. Guilherme Silva - E-mail: up202205298@up.pt\n3. Valentina Cadime - E-mail: up202206262@up.pt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsilva00%2Fia-project1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgsilva00%2Fia-project1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsilva00%2Fia-project1/lists"}