💀 PHANTOM | MINIMA-PINET-OS DAPP

The Ghost in the Machine

A Decentralized Audio Workstation for the Edge

---

🌌 THE NEURAL CORE

PHANTOM is a tactical, AI-native Minima-PiNet-Os DApp designed for resilient creative output in any environment. By merging high-fidelity synthesis with decentralized communication protocols and RNPE-2 blockchain provenance, PHANTOM exists where the edge node meets the chain.

It is built to run on Raspberry Pi 5 edge hardware, uses local Ollama models for neural pattern generation, and fails closed when required local services or Minima MDS are unavailable.

⚡ Key Technologies

• ShadowCore Engine: Real-time 32-bit float audio processing with zero-latency signal paths and parallel stem isolation.
• GhostBridge V3: Neural pattern synthesis powered by local Ollama with no simulated pattern fallback, supporting multi-line tactical commands and MIDI exfiltration.
• Production Engines: LMMS is detected as the local production engine and Mixxx as the local mixing engine.
• Hive Protocol: Peer-to-peer LoRa Mesh networking for voice and data sync across nodes via WebSockets.
• Spirit Ledger: Immutable session anchoring and asset registration via RNPE-2 peer verification with compact RMP state roots on Minima.

---

🚀 DEPLOYMENT & SETUP

PHANTOM ships with the Express/Vite control surface for local-first Minima-PiNet-Os operation.

🛠️ Prerequisites

• Node.js: v18+ recommended.
• Ollama: Required for local Ghost Bridge neural synthesis (OLLAMA_MODEL defaults to llama3:8b-instruct-q4_K_M).
• LMMS and Mixxx: Optional local production and mixing engines detected by PHANTOM status APIs.
• Minima MDS / MiniHub: Required for RNPE-2 anchoring and provenance registration.
• PiNet_Os / Raspberry Pi 5 hardware: Required for GPIO FM RDS and Hailo NPU features.

📦 Installation

# Clone the repository
git clone https://github.com/infinity-collaborations/phantom.git
cd phantom

# Install dependencies
npm install

⚙️ Configuration

Create a .env file in the root directory (see .env.example):

OLLAMA_URL=http://localhost:11434/api/generate
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=llama3:8b-instruct-q4_K_M
MINIMA_BASE_URL=http://localhost:9001
APP_URL=http://localhost:3000
PHANTOM_URL=http://localhost:3000

⚡ Launch

# Engage the core in development mode
npm run dev

Access Point: http://localhost:3000

🍓 Raspberry Pi OS Trixie Application Mode

PHANTOM can be installed as a production Raspberry Pi OS Trixie application with a systemd service and Chromium kiosk launcher:

npm run raspi:install

The installer copies the app to /opt/phantom, builds the production frontend, writes /etc/systemd/system/phantom.service, and installs a desktop launcher. Configure runtime values in /etc/phantom/phantom.env, including local Ollama/Minima endpoints and kiosk URL overrides, then manage the app with:

sudo systemctl status phantom.service
sudo systemctl restart phantom.service

The app binds to 0.0.0.0:3000 by default so it can be opened locally on the Pi or from another device on the same network.

🟣 Minima-PiNet-Os DApp

PHANTOM ships with minidapp.conf for MiniHub packaging. Build the frontend with npm run build, include the generated dist/ assets with minidapp.conf, and run the app inside Minima MDS so window.MDS is available. Provenance actions fail closed when MDS is unavailable instead of creating simulated transaction IDs.

---

🎛️ OPERATOR INTERFACE

🧠 Ghost Bridge (AI Neural Link)

The Ghost Bridge is your neural link to the machine. Use the command console to summon complex patterns or chat with the "Ghost in the Machine."

• Tactical Commands:
  • /GENERATE - Create a new rhythmic foundation from scratch.
  • /REMIX - Re-interpret current instrumentation with new rhythms.
  • /MUTATE - Apply subtle variations to the active pattern.
  • /EVOLVE - Gradually increase signal complexity and intensity.
  • /CLEAR - Wipe the sequencer grid.
• MIDI Exfiltration: Every pattern generated by the AI can be exported as a Standard MIDI File (Format 0), specifically mapped for the Roland TR-8S drum machine.
• Ableton Live Bridge: Export Live-ready multitrack MIDI clips and a PHANTOM Live Bridge manifest for Max for Live/Web MIDI workflows.
• Sample Manifests: Sessions can be exported as AKAI MPC program manifests or Serato slab manifests for local sample workflows.

💎 Prism Deck (Sampling & Stems)

• Stem Isolation: Real-time parallel crossover engine to split any signal into Vocals, Drums, Bass, and Other.
• Flux FX: Performance-grade Loop Rollers, Stutter gates, and EQ filters for high-intensity transitions.

🟪 Ableton Live Plugin Mode

PHANTOM now includes an Ableton-focused plugin bridge workflow for Live Suite users:

• Live Bridge panel: Open the ABLETON tab to view Session View scene mapping, rack macro targets, and Live-focused engines.
• Live MIDI export: Use DATA_EXFIL → ABLETON LIVE CLIPS (.MID) to export SMF Type 1 clips with separate Live track lanes.
• Plugin manifest export: Use DATA_EXFIL → LIVE PLUGIN MANIFEST (.JSON) to export Max for Live bridge metadata, macro targets, scene names, and clip note maps.
• Recommended Live setup:
  1. Create a virtual MIDI port named PHANTOM Live Bridge (IAC Driver on macOS, loopMIDI on Windows, or ALSA snd-virmidi on Linux).
  2. Enable the port for Track and Remote input in Ableton Live preferences.
  3. Import the _ableton_live.mid file into Session View.
  4. Mirror the manifest's eight macro targets in a Live rack or Max for Live companion device.
  5. Use PHANTOM's Web MIDI output, Ghost Bridge, Prism Deck, and Performance Core as the plugin control surface.

🛡️ Safety & Security

• Panic Watchdog: Real-time telemetry monitoring CPU thermals, NPU load, and memory usage.
• Kill Switch: Instant signal blackout and data purge protocol for compromised environments.

---

🔗 BLOCKCHAIN PROVENANCE

PHANTOM integrates deeply with the Minima Blockchain through the RNPE-2 provenance profile to ensure your creative output is tracked and owned.

⚓ RNPE-2 Anchoring

Anchor your entire session state to the blockchain. PHANTOM generates a cryptographic "Spirit Hash" of your current patterns, parameters, and telemetry, compresses the state into an RMP (Recursive Merkle Proof) root, then anchors both values to a Minima block using RNPE-2 state markers. This creates an immutable record of your creative process and the consensus view used when the record was created.

💎 RNPE-2 Registration

Register unique audio patterns as digital assets. Using RNPE-2, you can create a unique Minima token that represents a specific pattern, complete with its metadata, provenance hash, and RMP proof root.

---

📡 NETWORK ARCHITECTURE

PHANTOM nodes communicate via a multi-layered protocol stack designed for reliability in disconnected environments.

Layer	Protocol	Function
HIVE	WebSocket / LoRa	Real-time voice-over-mesh and peer discovery.
RELAY	Radio RF / WebSocket	Frequency-hopped text messenger and signal relay.
PHANTOM	Custom Binary	High-speed local cluster synchronization for audio sync.
RMP	Recursive Merkle Proof	Compact state root used to validate current network/session state with minimal overhead.
RNPE-2	Recursive Network Peer Exchange	Peer verification profile for requesting missing blocks and checking local state against network consensus.

---

🛠️ HARDWARE FORGE

PHANTOM is designed for the Raspberry Pi 5.

• Compute: 8GB RAM + NVMe SSD for high-speed sample access.
• AI: Hailo-8L NPU for local stem separation (Prism Core).
• Audio: I2S DAC for low-jitter, high-fidelity output.
• Comms: Waveshare LoRa Module for mesh networking.

---

Decentralized for Edge Computing.

Developed by Infinity Collaborations SDH

© 2026 // ALL RIGHTS RESERVED