菜单
GNN audio generation and sonification. Use when creating audio representations of GNN models, generating sonification of state spaces, or working with SAPF and Pedalboard audio backends.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generalized Notation Notation (GNN) processing pipeline for Active Inference generative models. Use when working with GNN files, running the 25-step pipeline, parsing model specifications, generating simulations, or producing visualizations and reports from GNN model definitions.
GNN command-line interface dispatch and health checks. Use when invoking the `gnn` CLI, validating subcommand availability, or checking command-line access to pipeline modules.
GNN LLM-enhanced analysis and model interpretation. Use when generating natural language descriptions of GNN models, getting AI-assisted model explanations, or performing LLM-powered analysis of Active Inference specifications.
GNN Language Server Protocol integration. Use when starting editor diagnostics, checking hover behavior, or validating LSP support for GNN files.
GNN Model Context Protocol processing and tool registration. Use when registering GNN operations as MCP tools, building MCP server configurations, or integrating GNN capabilities with LLM tool-use workflows.
GNN pipeline orchestration and configuration management. Use when configuring pipeline execution, setting step inclusion/exclusion, managing pipeline state, or customizing the 25-step execution flow.
| name | gnn-audio-generation |
| description | GNN audio generation and sonification. Use when creating audio representations of GNN models, generating sonification of state spaces, or working with SAPF and Pedalboard audio backends. |
Generates audio representations (sonification) of GNN models, mapping model structures, state transitions, and matrix values to sound parameters using SAPF, Pedalboard, and other audio backends.
# Run audio generation
python src/15_audio.py --target-dir input/gnn_files --output-dir output --verbose
# As part of pipeline
python src/main.py --only-steps 15 --verbose
from audio import (
AudioGenerator, process_audio, generate_audio_from_gnn,
create_sonification, analyze_audio_characteristics,
SAPFGNNProcessor, SyntheticAudioGenerator,
check_audio_backends, generate_oscillator_audio,
apply_envelope, mix_audio_channels,
convert_gnn_to_sapf, generate_audio_from_sapf
)
# Process audio step (used by pipeline)
process_audio(target_dir, output_dir, verbose=True)
# Generate audio from GNN model
result = generate_audio_from_gnn(gnn_content, output_dir="output/")
# Create sonification
audio_data = create_sonification(model_data)
# Use AudioGenerator class
gen = AudioGenerator()
# Convert GNN to SAPF format and generate audio
sapf_code = convert_gnn_to_sapf(gnn_content)
generate_audio_from_sapf(sapf_code, output_path="model.wav")
# Check available backends
backends = check_audio_backends()
# Returns: {'librosa': {'available': True}, 'soundfile': {...}, 'pedalboard': {...}}
AudioGenerator / SAPFGNNProcessor — audio generator classesprocess_audio / generate_audio_from_gnn — main generation functionscreate_sonification — sonification from model dataSyntheticAudioGenerator — procedural audio generationgenerate_oscillator_audio, apply_envelope, mix_audio_channels — low-level audiocheck_audio_backends — check librosa/soundfile/pedalboard availability# Audio generation deps
uv sync --extra audio
# Includes: librosa, soundfile, pedalboard, pydub
output/15_audio_output/This module registers tools with the GNN MCP server (see mcp.py):
analyze_audio_characteristicscheck_audio_backendsget_audio_generation_optionsget_audio_module_infoprocess_audiovalidate_audio_content