6. El código fuente completo y los modelos utilizados

Objetivo de esta entrada

Publicamos el código fuente que usamos en los experimentos de la IA de sudoku. El código solo se carga cuando abres un archivo.

Modelos utilizados

• Qwen3-VL-2B-Instruct: se usó para el primer entrenamiento (lora_stoku), el entrenamiento por ensayo y error (lora_move), la búsqueda de casillas seguras (lora_cell) y las versiones 2B de la lectura del tablero y del juicio del número 1.
• Qwen3-VL-8B-Instruct: se entrenó para la lectura del tablero (lora_board_read_8b) y las casillas imposibles por número (lora_digit1_illegal_8b). La resolución de la entrada 4 se hizo con el adaptador de 15 ciclos, y la importación desde foto usa el adaptador de lectura del tablero.
• LoRA: peft, r=8, alpha=16. Todos los adaptadores usan la misma configuración.
• Qwen2.5-1.5B-Instruct: distingue si un mensaje del chat web es una petición de jugada.
• Gemma 4 (31B, E4B, mlx 4bit): solo se probó si podía leer las coordenadas del tablero.
• Jugadas en la web: por ahora se eligen las jugadas seguras solo con código, sin el VLM.

Estructura de carpetas

• dataset_*.py en la raíz: generación de datos de entrenamiento
• *_train_loop.py y train_vlm.py en la raíz: entrenamiento LoRA y repetición de ciclos
• sudoku_engine.py, sudoku_human_solver.py, vlm_digit_strategy.py: generación de sudokus, resolución al estilo humano y búsqueda de jugadas seguras
• human_judge_*.py: la demo de juicios de la entrada 4
• sudoku_vlm_server.py, chat_bridge_server.py: servidor de VLM y servidor de chat
• main.py, main_window.py, photo_board_*.py: app de PyQt6 e importación desde foto
• web: pantalla del sudoku web en Next.js, registros de resolución (db.ts) y panel de chat con la IA
• solve.md: documento que describe cómo resuelven las personas

La configuración de despliegue del servidor, los scripts de monitorización y automatización, los datos de entrenamiento y los registros, y los pesos de los modelos quedan fuera de lo publicado. También se omitieron el código de operación web, como los anuncios y la lista de otros juegos, y los archivos de configuración, por lo que algunos import apuntan a archivos no publicados.

Código fuente completo