¿Qué es SpectraForge?

SpectraForge no es simplemente una interfaz gráfica bonita montada sobre una API de terceros. Se trata de una herramienta de producción musical autónoma, local y de nivel profesional, construida sobre la premisa de que los creadores deben poseer sus datos, controlar su flujo de trabajo y no depender de un software as a service (SaaS) efímero en la nube.

La Arquitectura de SpectraForge

La industria actual de generación de música mediante Inteligencia Artificial sufre de un problema fundamental: la fragmentación. Generas una letra en ChatGPT, copias el texto a Udio/Suno/MiniMax, generas la pista, descargas un archivo genérico song_final_v2.mp3, abres un editor de etiquetas ID3 para ponerle nombre y carátula, y finalmente lo guardas en una carpeta.

SpectraForge unifica este caos a través de un Monorepo Híbrido Multimodal que coordina múltiples lenguajes de programación y protocolos de sistema:

1. El Frontend (React 19 + Vite + Tailwind 4)

La cara visible de la aplicación. Diseñada específicamente para parecerse a una estación de trabajo de audio digital (DAW). Utiliza React 19 concurrente para asegurar que la interfaz de usuario se mantenga a 60 FPS incluso cuando se están cargando formas de onda complejas o listas de miles de pistas. No hay recargas de página; es una Single Page Application (SPA) que se ejecuta dentro del webview ultrarrápido de Tauri.

2. El Core (Rust)

Si React es la cara, Rust es el músculo. Rust es un lenguaje de programación de sistemas que garantiza la seguridad de la memoria y un rendimiento sin precedentes. Todo el trabajo pesado de SpectraForge se ejecuta aquí:

Conexiones HTTP seguras: Las peticiones a las APIs de IA (como MiniMax) se hacen en hilos separados en Rust, lo que significa que tu navegador webview no gasta recursos en mantener la conexión abierta.
Manipulación de Binarios: Cuando descargas una pista, Rust intercepta el binario del MP3 y la imagen JPEG y opera a nivel de bits para reestructurarlos.
Base de Datos SQLite: En lugar de guardar datos en el frágil LocalStorage del navegador, Rust mantiene una base de datos compatible con ACID que garantiza que ninguna canción se corrompa si se cierra el programa abruptamente.

3. El IPC Bridge (Inter-Process Communication)

Tauri v2 actúa como el pegamento. Utiliza un sistema de paso de mensajes extremadamente rápido. Cuando haces clic en “Generar Canción”, React despacha un mensaje JSON a través del IPC, Rust lo atrapa, hace su trabajo durante minutos y va informando a React del progreso a través de eventos asíncronos.

¿Por qué ID3v2.3 Nativo?

La magia invisible de SpectraForge radica en cómo trata los metadatos musicales.

Un archivo MP3 clásico tiene un bloque al principio llamado ID3 Header. SpectraForge no guarda tus letras y carátulas solo en su base de datos, sino que inyecta esta información de forma Física y Permanente dentro de los archivos de audio:

TIT2 (Título) y TPE1 (Artista Principal): Aseguran que la pista aparezca correctamente nombrada.
APIC (Attached Picture): Inserta el archivo de imagen completo (en formato JPEG de alta calidad) dentro del archivo de audio, lo que significa que la carátula viaja con el archivo, no se queda atrás.
USLT (Unsynchronised Lyric/Text Transcription): El santo grial de la generación. La letra generada por la IA se inyecta directamente en este marco. Al subir esta canción a tu teléfono, verás la letra en tu reproductor.

Privacidad y Local-First

SpectraForge sigue la filosofía Local-First.

Tus API Keys son tuyas: Se guardan encriptadas en tu bóveda local de Tauri. SpectraForge no tiene telemetría ni servidores intermedios. Tu cliente habla directamente con el proveedor de IA.
No hay suscripciones ocultas: Tú decides cuánto gastas recargando directamente en el proveedor del modelo de IA (ej. MiniMax). SpectraForge te ofrece un software orquestador gratuito y de código abierto para gobernar ese uso.
Tus archivos en tu disco: Tú posees la ruta absoluta de exportación. Si SpectraForge desapareciera mañana, tu música seguiría estando perfectamente estructurada y etiquetada en tu disco duro C:\Users\...\Music.

En las siguientes páginas de esta documentación, te guiaremos paso a paso en cómo aprovechar al máximo este potente motor.