memlnaut-nisps/README.md

# Neural Interactive Shaping of Parameter Spaces

https://musicallyembodiedml.github.io/memlnaut/approaches/nisps

## Firmware

The hardware firmware targets the MEMLNaut RP2350 build and uses repo-local helper
scripts for the known-good build configuration:

```bash
git submodule update --init --recursive

scripts/build-firmware.sh
scripts/flash-firmware.sh
scripts/build-and-flash-firmware.sh
```

Notes:
- The scripts build for `rp2040:rp2040:solderparty_rp2350_stamp_xl` with `Optimize3`.
- The build forces C++20 because the firmware uses `std::span` and concepts.
- `flash-firmware.sh` accepts an optional mountpoint argument, or auto-detects common UF2 bootloader mounts such as `/run/media/$USER/RP2350` and `/run/media/$USER/RPI-RP2`.

## Web Playground

Try NISPS in your browser — no hardware required:

```bash
cd playground
python3 -m http.server
# Open http://localhost:8000
```

Train a neural network to map joystick positions to generative visuals through interactive machine learning. Two learning modes: direct example mapping and reinforcement learning with thumbs up/down feedback.

The playground UI includes an **Expand** toggle on the visual surface so you can make the canvas nearly full-screen while compressing parameter/control panels into a minimal strip beneath it.
Update project title and add reference link 2025-11-13 18:24:18 +01:00			`# Neural Interactive Shaping of Parameter Spaces`

			`https://musicallyembodiedml.github.io/memlnaut/approaches/nisps`

Add firmware helper scripts and docs 2026-04-15 17:32:32 +02:00			`## Firmware`

			`The hardware firmware targets the MEMLNaut RP2350 build and uses repo-local helper`
			`scripts for the known-good build configuration:`

			```bash
			`git submodule update --init --recursive`

			`scripts/build-firmware.sh`
			`scripts/flash-firmware.sh`
			`scripts/build-and-flash-firmware.sh`
			```

			`Notes:`
			- The scripts build for `rp2040:rp2040:solderparty_rp2350_stamp_xl` with `Optimize3`.
			- The build forces C++20 because the firmware uses `std::span` and concepts.
			- `flash-firmware.sh` accepts an optional mountpoint argument, or auto-detects common UF2 bootloader mounts such as `/run/media/$USER/RP2350` and `/run/media/$USER/RPI-RP2`.

feat: add web-based interactive playground for NISPS Faithful JS port of nisps-core MLP + IML engine with a touch-friendly UI for exploring neural parameter mapping visually. Two learning modes: example-based (set slider targets) and RL feedback (thumbs up/down with exploration noise). Flow field particle system controlled by 8 MLP outputs. 2026-02-11 13:17:17 +01:00			`## Web Playground`
Update project title and add reference link 2025-11-13 18:24:18 +01:00
feat: add web-based interactive playground for NISPS Faithful JS port of nisps-core MLP + IML engine with a touch-friendly UI for exploring neural parameter mapping visually. Two learning modes: example-based (set slider targets) and RL feedback (thumbs up/down with exploration noise). Flow field particle system controlled by 8 MLP outputs. 2026-02-11 13:17:17 +01:00			`Try NISPS in your browser — no hardware required:`

			```bash
			`cd playground`
			`python3 -m http.server`
			`# Open http://localhost:8000`
			```

			`Train a neural network to map joystick positions to generative visuals through interactive machine learning. Two learning modes: direct example mapping and reinforcement learning with thumbs up/down feedback.`
playground: add expandable visual mode and docs 2026-02-14 09:47:47 +01:00
			`The playground UI includes an Expand toggle on the visual surface so you can make the canvas nearly full-screen while compressing parameter/control panels into a minimal strip beneath it.`