6. O código-fonte completo e os modelos usados

Objetivo deste post

Publicamos o código-fonte usado nos experimentos da IA de sudoku. O código só é carregado quando você abre um arquivo.

Modelos usados

• Qwen3-VL-2B-Instruct: usado no primeiro treino (lora_stoku), no treino por tentativa e erro (lora_move), na busca de casas certas (lora_cell) e nas versões 2B da leitura de tabuleiro e do julgamento do número 1.
• Qwen3-VL-8B-Instruct: treinado para leitura de tabuleiro (lora_board_read_8b) e para casas proibidas por número (lora_digit1_illegal_8b). A resolução do post 4 usou o adaptador de 15 ciclos, e a importação por foto usa o adaptador de leitura de tabuleiro.
• LoRA: peft, r=8, alpha=16. Todos os adaptadores usam a mesma configuração.
• Qwen2.5-1.5B-Instruct: decide se uma mensagem do chat na web é um pedido de jogada.
• Gemma 4 (31B, E4B, mlx 4bit): testado apenas para ver se conseguia ler as coordenadas do tabuleiro.
• Jogada na web: hoje é escolhida apenas por código, sem o VLM.

Estrutura de pastas

• dataset_*.py na raiz: geração de dados de treino
• *_train_loop.py e train_vlm.py na raiz: treino LoRA e repetição de ciclos
• sudoku_engine.py, sudoku_human_solver.py, vlm_digit_strategy.py: geração de quebra-cabeças, resolução no estilo humano, busca de jogadas certas
• human_judge_*.py: a demonstração de julgamento do post 4
• sudoku_vlm_server.py, chat_bridge_server.py: servidor de VLM e servidor de chat
• main.py, main_window.py, photo_board_*.py: app em PyQt6 e importação por foto
• web: tela do sudoku na web em Next.js, registros de resolução (db.ts), painel de chat com a IA
• solve.md: documento que descreve como as pessoas resolvem

As configurações de implantação do servidor, os scripts de monitoramento e automação, os dados de treino e logs e os pesos dos modelos ficaram de fora da publicação. O código de operação da web, como anúncios e a lista de outros jogos, e os arquivos de configuração também foram retirados, por isso alguns imports apontam para arquivos não publicados.

Código-fonte completo