w1n5t0n/memlnaut-nisps
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
427 commits 1 branch 0 tags 9.6 MiB
C++ 69.4%
TypeScript 25.4%
Shell 1.6%
HTML 1%
JavaScript 0.8%
Other 1.8%
Find a file
monkey-w1n5t0n 1f38f1a7fb fix(engines): restore MEMLCelium's feedback tap (L7) 
feedback_/fbzm1_/fb_smooth_alpha_ were read every process() call but nothing
ever wrote feedback_, so the path was silently inert. Git history shows this
was a *muted* feature, not dead code: `feedback = v0 * feedbackGain` with
feedbackGain 0.1f (MEMLCeliumAudioApp.hpp @ d095688), then "0; //0.1f" —
zeroed with the value kept in the comment — then the write was dropped
entirely when the engine was ported to nisps/engines/ at the 2026-04-29
rewrite (8d0d47b). Operator decision: port it back, live at 0.1f.

The tap is voice 0's own enveloped output, post-envelope and pre voice-1/mix/
shape — NOT the final output. This differs from PAFSynth's feedback shape;
where the sibling and the reference disagreed, the reference won.

Not schema-exposed: the reference hardcoded it, and MEMLCelium has no voice
spaces to vary it by. If feedback depth becomes a research axis it wants to be
a runtime parameter — noted, not built.

Verification, and a gap worth recording: parity-check.sh PASSES (max delta
2.38e-7) but that is NOT evidence for this change — its harness only exercises
PAFSynth and ChannelStrip, and the impulse baseline runs all-params-0.5, under
which voice 0's sequencer never triggers, so v0_env stays 0 and the new write
is 0 either way. That baseline is blind to this path, not a check on it. So it
was cross-checked directly instead: sequencer params forced to trigger early,
4800 samples native vs WASM through the nisps_engine_* C ABI —

  native vs WASM max abs diff  1.19e-7   (tolerance 1e-5)
  all 4800 samples nonzero, finite, max amplitude ~0.99 (tanh-bounded)
  same run with gain forced to 0 diverges by up to 1.49 — not a no-op

No fixture regenerated. nisps.wasm ships here because it is a tracked artifact
under the Phase 0 freshness gate.

Follow-up: the parity harness covers 2 of 8 engines. "Firmware and WASM share
the same engines" is asserted repo-wide but tested narrowly.
2026-07-21 17:04:35 +02:00
.github/workflows chore: delete retired-playground artefacts and root relics 2026-07-21 12:47:58 +02:00
.vscode memlnautmodes, channelstrip 2025-11-19 15:17:37 +00:00
assets/media docs: restructure design docs into docs/specs (adr/plans/recon), update path references 2026-07-13 23:15:46 +03:00
codegen chore(schemas): retire the clobbering seed script; fix the direction-of-truth text 2026-07-21 14:03:07 +02:00
docs feat(firmware): bump memllib to current upstream and dissolve the fork 2026-07-21 17:04:10 +02:00
firmware feat(firmware): bump memllib to current upstream and dissolve the fork 2026-07-21 17:04:10 +02:00
manifold fix(engines): restore MEMLCelium's feedback tap (L7) 2026-07-21 17:04:35 +02:00
nisps fix(engines): restore MEMLCelium's feedback tap (L7) 2026-07-21 17:04:35 +02:00
schemas chore(schemas): retire the clobbering seed script; fix the direction-of-truth text 2026-07-21 14:03:07 +02:00
scripts fix(gates): close the no-heap lint's false negatives and parity's silent FAIL 2026-07-21 13:23:11 +02:00
src feat(firmware): bump memllib to current upstream and dissolve the fork 2026-07-21 17:04:10 +02:00
tests/cpp refactor(engines): extract the shared sequencer machinery 2026-07-21 14:02:23 +02:00
vcv fix(vcv): close the audio-thread race and remove JSON from process() 2026-07-21 13:23:11 +02:00
.envrc chore: add .envrc + playground package-lock 2026-06-28 04:14:30 +02:00
.gitignore feat(manifold)!: P1 — retire playground/, manifold is the sole browser app 2026-07-13 23:27:56 +02:00
.gitmodules feat(firmware): bump memllib to current upstream and dissolve the fork 2026-07-21 17:04:10 +02:00
AGENTS.md docs+ci: P5 doc sync; codegen golden wired into run-all-tests stage 5 2026-07-18 12:45:45 +02:00
ALIGNMENT.md feat(firmware): bump memllib to current upstream and dissolve the fork 2026-07-21 17:04:10 +02:00
CLAUDE.md chore(agents): converge project instructions 2026-07-13 22:58:26 +02:00
LICENSE Initial commit 2025-04-10 14:17:18 +01:00
MAP.md docs: sync MAP with Phase 3; burn down plan §4 and hand S26 to the operator 2026-07-21 14:03:16 +02:00
README.md feat(manifold)!: P1 — retire playground/, manifold is the sole browser app 2026-07-13 23:27:56 +02:00

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:

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.
  • build-firmware.sh accepts an optional variant name such as MEMLCelium or BreakOr. Matching remains case-insensitive, so memlcelium still works. If you omit it in an interactive shell, the script parses MEMLNaut-NISPS.ino, prompts for a variant, and rewrites the active MEMLNAUT_MODE_TYPE before building.
  • 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.

Manifold (browser app)

Try NISPS in your browser — no hardware required. Manifold is the React front-end running the same C++ engines + ML as the firmware, compiled to WASM:

cd manifold
bun install
bun run dev

Staging deployment: https://meml.lnfinitemonkeys.org/next/

Train a neural network to map input gestures to synth parameters through interactive machine learning: place examples, or use verdict-based feedback (explore-and-place, geometric dislike).

(The former SolidJS playground was retired in July 2026 — archived on branch archive/playground-solidjs, tag playground-solidjs-final.)