Laboratorio Guitar Alchemist — Misión

Por qué este laboratorio

Guitar Alchemist (GA) tiene mucha maquinaria: un índice de 313.047 voicings incrustados en el espacio OPTIC-K, reconocimiento de acordes, la geometría del mástil, un mástil en 3D, generadores de imágenes y de modelos. Los demás cursos del sitio desmontan cada pieza: la teoría musical, la IA de GA, three.js, ComfyUI, Blender. Este laboratorio junta las piezas en cosas que se pueden ver, oír y tener en la mano, y se pregunta cada vez si la idea funciona de verdad.

Cada prototipo sigue el mismo contrato.

Una hipótesis, confirmada primero en un commit. Antes de cualquier medición, un archivo de la carpeta results/ del prototipo dice lo que espero, con cifras. Si vi una cifra antes de escribirla, el archivo lo dice.
Mediciones. Las cifras salen de un script del repositorio, ejecutado en una máquina con nombre, con los datos fijados: el commit de GA, el SHA-256 del archivo, la semilla de la muestra.
Fracasos publicados. Una predicción que resulta falsa se queda en la lección, junto a lo que pasó en su lugar.

Para quién es este laboratorio

Escribes C# o Java, has seguido al menos uno de los cursos sobre GA, y tienes curiosidad por ver cómo son los datos de GA cuando dejas de leerlos a través de una API. Cada prototipo indica en qué lecciones se apoya. El código es JavaScript para el navegador y Node.js, más lo que necesite cada prototipo.

Requisitos previos

Node.js 24 y Git. En Windows, ejecuta los comandos desde Git Bash.
Un navegador con WebGPU: un Chrome o un Edge recientes. En otros, los prototipos recurren a WebGL 2.
Para los modos locales que leen todo el índice de GA: un clon de GuitarAlchemist/ga y unos 200 MB para el archivo del índice. Las páginas publicadas solo necesitan un navegador.
Ayuda como base: la lección 2 y la lección 3 del curso sobre la IA de GA, la lección 5 del curso de aprendizaje automático con IX, y la lección 8 del curso de three.js.

Plan

#	Prototipo	Pregunta	Estado
P1	Explorador del espacio de voicings	¿Se puede ver el espacio de voicings de GA en tres dimensiones, y qué esconde la imagen?	publicado
P2	Toca un acorde, mira el universo	Reconocimiento de acordes en el navegador: FFT, estimación de notas, plantillas sobre las calidades de acordes de GA, mástil 3D, brazalete y acorde siguiente; 624 rasgueos sintéticos y 17 grabaciones CC0, predicciones primero	publicado
P3	Portadas de álbum	¿Puede un modelo de difusión hacer una portada que diga algo cierto sobre una progresión de acordes?	previsto
P4	Pasada de render con IA	¿Mejora una textura o una iluminación generadas las escenas 3D de GA, medidas frente al render simple?	previsto
P5	Pulseras imprimibles en 3D	¿Puede una pulsera de clases de altura convertirse en un objeto imprimible, de los datos de GA a una malla que pase un slicer?	publicado
P6	Cadena completa	Del micrófono al acorde, al voicing, a la imagen y al objeto, de una vez: ¿dónde se rompe?	previsto
P7	Modelo de tocabilidad	¿Predice un modelo pequeño entrenado en la CPU lo difícil que es tocar un voicing mejor que el coste escrito a mano en GA?	publicado
—	Diario

Recursos

GuitarAlchemist/ga, el código y los datos que lee cada prototipo.
El código del laboratorio: code/ga-protos, una carpeta por prototipo, probada por .github/workflows/ga-protos-examples.yml.
three.js y su WebGPURenderer, Vite, y la Web Audio API.
Clifton Callender, Ian Quinn y Dmitri Tymoczko, “Generalized Voice-Leading Spaces”, Science 320, 2008: las equivalencias OPTIC que dan nombre a la incrustación de GA.