ruv-neural-cli

CLI tool for brain topology analysis, simulation, and visualization.

Overview

ruv-neural-cli is the command-line binary (ruv-neural) that ties together the entire rUv Neural crate ecosystem. It provides subcommands for simulating neural sensor data, analyzing brain connectivity graphs, computing minimum cuts, running the full processing pipeline with an optional ASCII dashboard, and exporting to multiple visualization formats.

Installation

# Build from source
cargo install --path .

# Or run directly
cargo run -p ruv-neural-cli -- <command>

Commands

simulate -- Generate synthetic neural data

ruv-neural simulate --channels 64 --duration 10 --sample-rate 1000 --output data.json

analyze -- Analyze a brain connectivity graph

ruv-neural analyze --input graph.json --ascii --csv metrics.csv

mincut -- Compute minimum cut

ruv-neural mincut --input graph.json --k 4

pipeline -- Full end-to-end pipeline

ruv-neural pipeline --channels 32 --duration 5 --dashboard

Runs: simulate -> preprocess -> build graph -> mincut -> embed -> decode.

export -- Export to visualization format

ruv-neural export --input graph.json --format dot --output graph.dot

info -- Show system information

ruv-neural info

Displays crate versions, available features, and system capabilities.

Global Options

Integration

Depends on all workspace crates: ruv-neural-core, ruv-neural-sensor, ruv-neural-signal, ruv-neural-graph, ruv-neural-mincut, ruv-neural-embed, ruv-neural-memory, ruv-neural-decoder, and ruv-neural-viz. Uses clap for argument parsing and tokio for async runtime.

License

MIT OR Apache-2.0