CommunityImagengithub.com

fractalwright

Renderiza, anima, mide e identifica fractales como recetas reproducibles (PNG o mp4 más un JSON de receta que lo redibuja): Mandelbrot, Julia, Burning Ship y Multibrot estáticos, zooms profundos, videos de zoom, morph y loop con control de destellos, visualizadores musicales audio-reactivos a partir de una canción, llamas fractales, IFS, L-sistemas, atractores extraños, terreno fBm, dimensión de conteo de cajas. Úsalo cuando el usuario quiera una imagen, fondo de pantalla o video de fractal, pida 'renderiza un zoom de Mandelbrot', 'haz una llama fractal', 'visualizador estilo Winamp para esta canción', 'qué fractal es esta imagen', 'mide la dimensión fractal de esta costa', o quiera redibujar un fractal exactamente. También 'refresca fractalwright'. No es para shaders generales (threewright), masterización musical (musicwright) o arte de píxeles (pixelwright).

¿Qué es fractalwright?

fractalwright es una habilidad especializada para agentes de IA (como Claude Code, Cursor, Codex) que permite generar, animar, medir e identificar fractales a partir de recetas reproducibles. Cada resultado gráfico (PNG o MP4) se acompaña de un archivo JSON que contiene la receta exacta, permitiendo volver a dibujar el fractal píxel a píxel. Soporta una amplia gama de familias fractales (Mandelbrot, Julia, Burning Ship, Multibrot, IFS, sistemas-L, atractores extraños, llamas fractales) y mediciones objetivas como dimensión de conteo de cajas o dimensión de similitud. También incluye funcionalidades para crear videos (zoom, morph, loop, musicales audio-reactivos) con control automático de destellos, exploración WebGL2 en tiempo real y exportación a formatos como STL para impresión 3D y 3MF para impresión multicolor. Su diseño permite a los agentes ejecutar estas tareas de forma directa, sin necesidad de intervención manual, interpretando comandos como 'renderiza un zoom de Mandelbrot' o 'mide la dimensión fractal de esta imagen'.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/m4bwav/fractalwright/tree/HEAD/skills/fractalwright

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace fractalwright?

Resultado: cada imagen es un PNG con un archivo JSON de receta a su lado que la redibuja píxel a píxel. Los números (dimensión, área, simetría) se miden, nunca se adivinan.

FW significa python scripts/fw.py desde la raíz del repositorio (ejecútalo, no lo leas).

Paso 0: herramientas

Ejecuta la tarea de inmediato. Ejecuta FW doctor solo cuando un comando falle por falta de una herramienta (NumPy es el núcleo; moderngl, Playwright y ffmpeg son opcionales y solo se sondean). La actualización (evergreen.json) se lee al usar 'refresca fractalwright', no en cada uso. Renderiza el preset tal como se da; ajusta el aspecto (iteraciones, densidad, supermuestreo) solo cuando se pida.

Paso 1: elige la familia

FW explain <family> da la fórmula, cómo se construye y los presets. Familias: mandelbrot, julia, burning-ship, tricorn, multibrot, kronecker (fractales de rejilla exactos: FW render kronecker-carpet, o --mask 111,101,111 --power 6). Nuevo en caos: FW explain logistic da el orden didáctico, --plot cobweb|bifurcation -o out.png lo dibuja; FW explain coastline explica D mediante las reglas de Richardson. Lee references/02-escape-time.md solo cuando el usuario pida profundidad o un método de coloreado más allá del suave.

Paso 2: renderizar

FW render <preset o recipe.json> -o out.png [--size WxH] [--iter N] [--palette NAME] [--supersample 2]. Escribe out.png y out.json. Confirma que ambos archivos existen antes de informar. Para cambiar una vista, edita view.centre y view.width de la receta (cadenas decimales, conserva todos los dígitos) y renderiza la receta de nuevo. FW palette lista las paletas; FW palette NAME -o swatch.png muestra una. Más allá de un ancho de aproximadamente 1e-13, float64 falla; dilo en lugar de renderizar ruido (references/03-deep-zoom.md).

Paso 2a: explorar

FW serve [--port 8765] [--out-dir DIR] [--open] ejecuta el explorador WebGL2 solo en 127.0.0.1 (cualquier otro host es rechazado). Arrastrar para mover la vista, rueda o pellizco para hacer zoom, clic con mayúsculas para elegir Julia c; fórmula, iteraciones, rotación ([ y ] giran 15 grados) y paleta se encuentran en el panel lateral; las recetas con paletas de parada (hasta 8 paradas) viajan en el hash como ps=pos:rrggbb,.... El hash de la URL es la vista completa, por lo que la dirección es un enlace para compartir. Un cuadro de precisión advierte cuando float32 se acerca a su límite; más allá de eso, Mandelbrot y Julia (potencia 2, ancho >= 1e-60) cambian a GPU profunda: la página publica la vista en /orbit, el servidor calcula la órbita de referencia Decimal, y la página la dibuja con el sombreador de perturbación de doble precisión (las cadenas del centro conservan cada dígito durante el zoom; mientras una nueva órbita está pendiente, la página muestra una previsualización aproximada de la última órbita y cancela las solicitudes obsoletas); Render exacto solicita al servidor un PNG NumPy (o de perturbación) de la misma vista, Exportar escribe un JSON de receta en el directorio de salida. FW export "<share url o #hash>" -o recipe.json hace lo mismo desde la línea de comandos. --route browser renderiza con Edge sin cabeza y el sombreador de la página; --deep --route browser (o cualquier ancho inferior a 1e-12) ejecuta perturbación de doble precisión en la GPU hasta un ancho de 1e-60 (diferencias de recuento del 0.1-1%), por lo que usa la ruta de la CPU cuando los recuentos exactos importan. Detalles (alternativas, --gpu-precision float32, burning ship): references/13-route-details.md.

Paso 2b: láminas y video

FW audio <song.wav> [--preset julia-pulse|mandel-dive] [--recipe R] [--size 640x360] [--fps 30] [--duration S] [--intensity 0.6] [--route auto|browser|numpy] crea un video musical: las envolventes de la canción impulsan el fractal (bajo, golpes, medios, croma, agudos, volumen; nada se mueve en silencio), los fotogramas pasan por un limitador de destellos, flashcheck filtra el resultado (código de salida 4 en caso de fallo) y la canción se multiplexa. Se rechaza MP3 a menos que se use --allow-mp3. FW serve también sirve /audio, una página en vivo. Detalles del mapeo: references/13-route-details.md.

FW sheet <recipe> --palettes A,B,C o --vary params.max_iter --values 100,300,1000 (valores complejos como re:im) escribe un PNG de lámina de contactos etiquetado y un JSON con la receta de cada mosaico. Video: FW zoom <recipe> --to-width W [--from-width W0] [--to-centre re,im] (ancho exponencial, centro suavizado), FW morph <recipe> --path "re,im;re,im" (julia c por defecto, --vary para otro parámetro), FW loop <recipe> --circle re,im,r [--phase] (trayectoria cerrada, el último fotograma envuelve al primero). Todos aceptan --size WxH --fps N --duration S, escriben los fotogramas exactos en <out>_frames/, un mp4 H.264 (yuv420p, CRF 18) y <out>.json con animation (fotogramas clave, fps, duración_s). El estilo AI está desactivado por defecto; --ai añade una copia img2img de ComfyUI Z-Image (<out>_ai.*, marcada como interpreted) y siempre conserva el video exacto (references/13-route-details.md). Cada video recibe una verificación de destellos; FW flashcheck <video or frame dir> lo ejecuta solo y sale con código 4 cuando ocurren destellos de luminancia del 10% (o rojo saturado) más de 3 veces por segundo juntos en más del 25% de un campo de 10 grados; la línea de veredicto nombra la regla fallida y su área (los swings/s de todo el fotograma son solo de referencia, por lo que "1 swings/s" no significa aprobado o reprobado). Informa de un fallo, nunca lo envíes (references/09).

Paso 2c: IFS, atractores, terreno, interpolación

FW ifs sierpinski|fern|unequal-tiles -o out.png (juego del caos, p por |det|, primeros 20 puntos descartados, enmarcado por una bola que garantiza que contiene el atractor). FW attractor-search --hits 5 -o best.png (mapeos cuadráticos de Sprott clasificados por D2 1.1-1.5 y L pequeño, una regla de libro; Lyapunov en bits). FW terrain -o t.png [--method midpoint] [--H 0.8] (espectral por defecto; las arrugas del punto medio se miden) escribe un PNG y un .npy. FW fif --points "0,0;1,1;2,0" --d 0.5,-0.5 -o f.png [--numbers y.txt] dibuja una curva de interpolación fractal a través de los puntos.

Paso 2d: llamas, L-sistemas, atractores

FW flame [sierpinski|swirl-sierpinski|recipe.json] -o f.png [--seed N --tries 24] (juego del caos sobre transformaciones, 12 variaciones de Draves-Reckase, transformación final, mezcla de colores, densidad logarítmica con gamma y vitalidad, supermuestreo 2, estimación de densidad; sin preset = llamas aleatorias con semilla puntuadas por cobertura, se conserva la mejor). FW lsystem koch|koch-snowflake|dragon|hilbert|sierpinski-arrowhead|plant-a|plant-b|plant-d|plant-e|plant-f|plant-stochastic -o p.png [--n N --seed N] escribe PNG, SVG y receta. FW attractor clifford|dejong|icon|icon-3|icon-halloween|icon-clam|icon-streamers|icon-flower|lorenz|chen|lu|multiscroll -o a.png [--params a,b,c,d] [--search] (iconos de Symmetry in Chaos Tabla A.1; los parámetros multiscroll son a, Mx, Nx de Yalcin) (sombreado de densidad; la búsqueda clasifica conjuntos aleatorios de Clifford o de Jong por la regla de Sprott). Cada comando escribe un JSON de receta que lo redibuja.

Paso 2f: vecinos (no todos fractales)

FW rd coral|mitosis|default [--f F --k K --steps N --seed N] (Gray-Scott). FW ca 90|30|B3/S23 [--steps N] (regla elemental o similar a Life). FW tiling square|triangle|hex|penrose [--n N]. FW kleinian apollonian|grandma [--ta T --tb T] (Junta Apolonia, o un conjunto límite de dos generadores a partir de la receta de Grandma dibujado mediante la búsqueda de palabras en profundidad del libro; --method random para iteración inversa). Cada uno escribe un PNG y una receta. Di claramente que la reacción-difusión y los teselados no son fractales; FW measure box sobre un teselado dice "no es fractal" (references/12-neighbours.md).

Paso 2e: 3D

FW 3d render mandelbulb|mandelbox|quatjulia|menger|hybrid [--view whole|close] [--remedy ao|shadow|fog|trap|dof|aa|camera|all|none] -o x.png (DE trazado por esferas en Edge sin cabeza; escribe la receta con la cámara explícita). Aspecto predeterminado desde 0.8.0: trazado de trayectorias con 256 muestras (cielo + sol, aproximadamente 0.5-2 s) con una cámara compuesta (40 mm, ángulo bajo, sujeto en el tercio izquierdo); --pt 0 da el aspecto rápido de sombra + oclusión ambiental, que se adapta mejor a formas cúbicas tipo Menger; un archivo de receta conserva su propia configuración. --remedy añade al aspecto de sombra/ao, --remedy none lo limpia primero. Deja la niebla y la profundidad de campo desactivadas a menos que se pida: la niebla desvaneció al sujeto en la prueba de aspecto y la profundidad de campo desenfoca las vistas cercanas. FW 3d recipe ... imprime la receta; FW 3d gate -o DIR renderiza la matriz de remedios y las láminas. Solo ruta de navegador, sin respaldo de NumPy. Una ruta normal desde la prueba de aspecto 3D (2026-11-14). --pt N [--bounces 2] [--seed 1] establece las muestras (misma semilla, mismos píxeles; 512 px a 256 spp en 0.5-1.8 s); consulta references/07-3d.md. Malla imprimible: FW 3d mesh <formula|recipe> [--size-mm 60] [--res 200] [--engine auto|skimage|numpy] [--wall-mm 0.9] -o x.stl muestrea el mismo DE en NumPy y escribe un sólido hermético como STL binario en mm (JSON adjunto: triángulos, cáscaras, volumen, tiempo; sale con código 3 si no es hermético). Menger por defecto al nivel 3 para impresión. --wall-mm X genera la malla de la superficie desplazada DE = t (t = X/2 a escala de impresión) para que las partes delgadas se engrosen hacia X mm; 0.9 resolvió la advertencia de pared delgada de Mandelbulb FDM (2.7% -> 0.1% por debajo de 0.9 mm). Multicolor: -o x.3mf (o --colors N, valor predeterminado 4, máximo 8; --palette "#hex,...") también escribe un 3MF coloreado por la trampa de órbita (contenedores de superficie igual, un filamento cada uno; Bambu Studio y PrusaSlicer leen las etiquetas de filamento por triángulo). Luego pw.py check x.stl --target print-fdm (polywright-print; también lee el 3MF).

Paso 3: medir

  • FW measure box image.png [--invert] [--threshold T]: dimensión de conteo de cajas de los píxeles oscuros (o claros) en más de 15 tamaños de caja y desplazamientos aleatorios con semilla, con el rango de ajuste en décadas, la curva de pendiente local y un veredicto. Transmite el veredicto tal como está escrito: por debajo de dos décadas es "solo descriptor"; una pendiente local que se desvía es "no fractal". Da D con su barra de error de references/08-measuring.md, nunca como exacto, y nunca nombres una forma a partir de D.
  • FW measure lacunarity image.png: huequera por tamaño de caja, el segundo número junto a D (el mismo D puede verse diferente).
  • FW measure ifs --ratios 0.5,0.5,0.5: dimensión de similitud; exacta solo cuando las piezas no se superponen, de lo contrario un límite superior.
  • Los perfiles de altura y mapas de altura son autoafines: FW measure profile numbers.txt (pendiente espectral, semivariograma, Katz) y FW measure heightmap map.png|.npy (espectro radial, D superficial = 3 - H). measure box rechaza un archivo de números.
  • FW measure katz curve.txt (x,y o una columna): un número de rugosidad barato, no D.
  • FW measure area --size 1024: área de Mandelbrot por recuento de píxeles (demostrado dentro de 0.0002 de 1.50659 a 1024 px).

Paso 4: identificar

FW identify <preset | recipe.json | image.png> [--c re,im]: características hechas a mano (simetría de espejo de los píxeles, Julia conectada o polvo a partir de la órbita de 0, cardioide principal o bulbo de período 2 para c, la simetría conocida de la familia). La D de caja de una imagen se informa solo como descriptor. Nunca identifiques un fractal por su dimensión.

Mantenimiento

Archivos unitarios en la raíz del repositorio: evergreen.json, RESEARCH.md, CHANGELOG.md, LEARNINGS.md, TESTS.md. Las fuentes de fractal-art actualizan las recetas; harvest.json lista los objetivos de cosecha.

Skills relacionados