EN

Sudoku - Python

This is my first game in Python, where I recreate the classic Sudoku.
Development is ongoing! New updates will be released regularly for community testing and feedback.

Objective

The main goal of this project is to recreate the classic Sudoku in Python, providing a fun and accessible experience for everyone.
Furthermore, this project has a great personal meaning for me, as it represents an opportunity to evolve and learn more about programming.
The development of this game covered several areas and was extremely enriching on a technical and personal level.

I recommend everyone to explore the source code, always respecting the project's license.

How to Install

1. Go to the releases section of this project on GitHub and download the latest version of the installer (https://github.com/RaiMonteiro/sudoku-python/releases);
2. After downloading, run the installer file;
   (Note: Your computer may display a security warning. You can proceed with the installation with confidence — the installer does not contain any viruses.)
3. Follow the steps presented by the installer until completion;
4. Once installed, just open the game and start playing!

Note: This project has only been tested on Windows; normal operation on other operating systems is not guaranteed.

How to Contribute

Simple!! You can contribute to the project by joining the Discord server and actively participating in the community.
Link: https://discord.gg/7AP2TNXKtW

Technologies Used

• Python 3.13.1
• Pygame (graphical interface)
• PyInstaller (to create the executable)
• JSON (data storage)
• NSIS (to create the Windows installer)
• Git & GitHub (version control)

PT

Sudoku - Python

Este é o meu primeiro jogo em Python, onde recrio o clássico Sudoku.
O desenvolvimento está em andamento! Novas atualizações serão lançadas regularmente para testes e feedback da comunidade.

Objetivo

O principal objetivo deste projeto é recriar o clássico Sudoku em Python, proporcionando uma experiência divertida e acessível para todos.
Além disso, este projeto tem um grande significado pessoal para mim, pois representa uma oportunidade de evoluir e aprender mais sobre programação.
O desenvolvimento deste jogo abrangeu várias áreas e foi extremamente enriquecedor a nível técnico e pessoal.

Recomendo a todos a explorarem o código fonte, sempre respeitando a licença do projeto.

Como Instalar

1. Acede à secção de releases, deste projeto no GitHub, e faz o download da versão mais recente do instalador (https://github.com/RaiMonteiro/sudoku-python/releases);
2. Após a transferência, executa o ficheiro do instalador;
   (Nota: O computador pode mostrar um aviso de segurança. Podes avançar com a instalação com confiança — o instalador não contém qualquer tipo de vírus.)
3. Segue os passos apresentados pelo instalador até à conclusão;
4. Depois de instalado, basta abrir o jogo e começar a jogar!

Nota: Este projeto foi apenas testado em Windows; o normal funcionamento noutros sistemas operativos não está garantido.

Como Contribuir

Simples!! Podes contribuir para o projeto juntando-te ao servidor no Discord e participando ativamente na comunidade.
Link: https://discord.gg/7AP2TNXKtW

Tecnologias Utilizadas

• Python 3.13.1
• Pygame (interface gráfica)
• PyInstaller (para criar o executável)
• JSON (armazenamento de dados)
• NSIS (para criar o instalador do Windows)
• Git & GitHub (controlo de versões)