Installation

Step-by-step guide to install and run MAFIS in web, desktop, and CLI modes.

MAFIS runs in three modes. Pick the one that fits your workflow.

Web (Browser)

No installation needed. Open the simulator URL and start experimenting.

Requirements: A modern browser (Chrome, Firefox, Edge) with WebGL support.

[!NOTE] The web version supports up to 1,000 agents. For larger experiments or batch runs, use the desktop version (up to 5,000 agents).

Desktop (Native)

The desktop version has full performance: parallel computation via rayon, the complete Egui panel interface, and no WASM size constraints.

Prerequisites

Rust toolchain (stable)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Clone the repository

git clone https://github.com/stasis-industries/mafis.git
cd mafis

Run

cargo run --release

That’s it. The desktop app opens with the full Egui interface: simulation controls, solver selection, fault injection panels, charts, and the resilience scorecard.

CLI (Headless)

For batch experiments and scripted parameter sweeps without a graphical interface.

Install

From the project root:

cargo install --path cli

Run

mafis                              # Interactive REPL
mafis experiment list              # List available experiment presets
mafis experiment run solver_resilience   # Run a specific experiment
mafis experiment smoke             # Quick validation (~1s)
mafis experiment run-all           # Full paper suite
mafis results list                 # View result files
mafis results show <file>          # Pretty-print a CSV

The REPL mode opens when no subcommand is given. You can also run experiments directly via subcommands.

Experiments use baseline caching: configs sharing the same solver/topology/scheduler/agents/seed compute their baseline once and reuse it across fault scenarios, eliminating ~85% of redundant computation in multi-scenario matrices.

Build for Web (WASM)

If you want to build the web version yourself:

Prerequisites

rustup target add wasm32-unknown-unknown
cargo install wasm-bindgen-cli basic-http-server

Build & Serve

# 1. Compile (~2-3 min)
cargo build --release --target wasm32-unknown-unknown

# 2. Generate JS bindings
wasm-bindgen --out-dir web --target web \
  target/wasm32-unknown-unknown/release/mafis.wasm

# 3. Serve locally (opens on http://localhost:4000)
basic-http-server web

Quick Feedback Loop

For logic changes (solver, analysis, metrics), you don’t need the full WASM build:

cargo check   # Type + borrow check (~5s)
cargo test    # Run all tests (~10s, 553 tests)

Only build WASM when touching rendering, the JS bridge, or visual elements.