Skip to content

mchl-schrdng/antipode

v0.1.0Apache-2.0

Create original sounds with your coding agent: local synthesis, layered stereo recipes, effects and WAV export. No sample library or model download.


Describe a texture, a UI gesture, or a cinematic atmosphere. Your coding agent composes a declarative JSON recipe; Antipode synthesizes it locally into a 48 kHz PCM16 WAV, analyzes its spectral and spatial profile, and refines it iteratively.

"A low, slowly breathing A1 drone. Brittle glass gliding from A4 to E5 while panning left to right. A distant metallic impact dissolving into dark stereo reverb. Ten seconds."

Your brief ──► Coding Agent ──► Local MCP (stdio) ──► Procedural DSP ──► 48 kHz WAV + Spectral Report

Listening Room

Three original studies synthesized entirely by the bundled engine — no external samples or recordings:

StudyCharacterAudioRecipe
Event HorizonDeep breathing sub-drone (55 Hz), detuned stereo pads, sparse glass & metallic decayListen / WAVevent-horizon.json
Glass OrbitShimmering inharmonic glass resonances orbiting across the stereo fieldListen / WAVglass-orbit.json
AfterimageAccelerating filtered riser landing in a deep sub impact and metallic tailListen / WAVafterimage.json

Experience them interactively in the live listening room at antipode.quest.


Quick Install

Install uv once and keep it on your PATH. Antipode prepares Python and its locked dependencies (numpy, mcp) automatically on first launch and runs 100% offline afterward.

Claude Code

claude plugin install antipode --marketplace mchl-schrdng/antipode-audio

Or run /plugin install antipode --marketplace mchl-schrdng/antipode-audio inside a Claude Code session.

Codex

codex plugin marketplace add mchl-schrdng/antipode-audio
codex plugin add antipode@antipode-local

Gemini CLI

gemini extensions install https://github.com/mchl-schrdng/antipode-audio

Antigravity & OpenCode

See the Agent Integration Guide for native Antigravity bundles and OpenCode project configuration.


The Instrument

1. MCP Tools

Antipode runs as a local stdio process (antipode-mcp) with no daemon, API key, or network activity. All outputs are written atomically to the workspace (~/.antipode/audio by default) and existing files are never overwritten.

ToolRole
list_presetsDiscover the 16 built-in procedural synthesis voices
generate_soundRender a single mono voice by frequency (20–8000 Hz) or scientific pitch (E0–B8)
render_recipeSynthesize and mix up to 16 stereo layers with pitch glides, panning, per-layer filters & master effects
process_audioApply high-pass/low-pass filtering, gain, fades, reversal & peak normalization to an existing WAV
analyze_audioMeasure peak/RMS dBFS, transient peak time, AC spectral centroid (Hz), stereo balance & clipping

2. Sixteen Procedural Voices (4 × 4 Matrix)

FamilyPresetSynthesis TopologySuggested Range
Foundations & PadstonePure sine oscillator for sub reinforcement and clean UI cues40–2000 Hz (E1–B6)
droneSlowly beating subharmonics, detuned overtones and gentle FM55–110 Hz (A1–A2)
padEight detuned harmonic pairs with slow spectral bloom110–440 Hz (A2–A4)
choirBreathing vocal-formant harmonic ensemble with gentle 5.2 Hz vibrato110–520 Hz (A2–C5)
Melodic & ResonantpluckPlucked harmonic string with fast high-partial damping110–880 Hz (A2–A5)
chimeThree exponentially decaying harmonic partials220–2000 Hz (A3–B6)
bellFM struck bell with decaying spectral brightness and warm hum220–1200 Hz (A3–D6)
glassDelicate inharmonic glass partials with a long decaying shimmer440–1200 Hz (A4–D6)
Impacts & RhythmkickPitch-dropping sine transient falling to a quarter of its start frequency120–220 Hz (B2–A3)
woodHollow woody modal strike (1 : 2.57 : 4.64) for organic percussion & UI clicks150–900 Hz (D3–A5)
metalSix inharmonic struck resonators with a crisp noise burst attack90–500 Hz (F#2–B4)
pulseWarm breathing harmonic pulses modulated at 2.5 Hz55–220 Hz (A1–A3)
Motion & AirsweepRising or gliding tonal sweep110–1760 Hz (A2–A6)
riserCubic accelerating tonal sweep through filtered air220–2000 Hz (A3–B6)
windSlowly swelling dark filtered noise shaped around the target frequency100–800 Hz (G2–G5)
noiseDeterministic seeded white noise sourceSeeded (0–2³²−1)

3. Declarative Sound Recipes

Recipes are plain, version-controllable JSON objects supporting scientific notes (E0–B8), exponential pitch glides (note → note_end), constant-power stereo movement (pan → pan_end), per-layer filters (highpass_hz, lowpass_hz), and master bus DSP:

{
  "duration": 8,
  "seed": 73,
  "peak_db": -3,
  "layers": [
    {
      "preset": "drone",
      "duration": 7.2,
      "note": "A1",
      "level_db": -6,
      "lowpass_hz": 900,
      "fade_in": 1.2,
      "fade_out": 2.0
    },
    {
      "preset": "glass",
      "start": 1.5,
      "duration": 4.5,
      "note": "A4",
      "note_end": "E5",
      "level_db": -14,
      "pan": -0.7,
      "pan_end": 0.7,
      "fade_in": 0.05,
      "fade_out": 1.8
    }
  ],
  "effects": {
    "highpass_hz": 30,
    "lowpass_hz": 8000,
    "drive": 1.2,
    "delay_seconds": 0.375,
    "delay_feedback": 0.35,
    "delay_mix": 0.15,
    "reverb_seconds": 2.4,
    "reverb_mix": 0.35
  }
}

CLI Usage

git clone https://github.com/mchl-schrdng/antipode-audio.git
cd antipode-audio

# Generate a single voice by scientific pitch or frequency
uv run --locked antipode --workspace ./my-sounds generate ui-chime.wav --preset glass --note A4 --duration 1.5

# Render a multi-layer stereo recipe
uv run --locked antipode --workspace ./my-sounds render examples/recipes/event-horizon.json event-horizon.wav

# Filter and normalize an existing WAV without overwriting the source
uv run --locked antipode --workspace ./my-sounds process event-horizon.wav dark-horizon.wav --lowpass-hz 1200 --normalize-db -3

# Inspect level, transient timing, spectral centroid and stereo balance
uv run --locked antipode --workspace ./my-sounds analyze dark-horizon.wav

Development & Continuous Integration

Every push and pull request is verified across Linux (Python 3.11 & 3.12), macOS (Python 3.12), and Windows (Python 3.12) via GitHub Actions:

CheckScope
DSP & Synthesis (test_engine.py, test_composition.py)Bit-accuracy of the 3 reference studies, exponential glides, constant-power panning, per-layer & multi-rate filtering, DC-free spectral centroid, concurrent atomic writes
Path & Format Safety (test_engine.py)Workspace confinement, symlink/traversal rejection, Windows drive/ADS rejection, malformed RIFF/WAV handling
Transports (test_cli.py, test_mcp.py, test_integrations.py)CLI commands, real stdio MCP subprocesses (modern & legacy negotiation), offline plugin manifest launches
Reproducible Packaging (test_distribution.py)Deterministic SHA-256 ZIP bundles for portable Agent Plugins and Antigravity

Run the full suite locally:

uv run --locked python -m unittest discover -s tests -v
uv build
uv run --locked python scripts/build_plugin.py
uv run --locked python scripts/build_plugin.py --client antigravity

Rights & Provenance

  • Software & original vector artwork: Apache-2.0.
  • Bundled demo audio & recipes: CC0-1.0, to the extent contributors hold rights.
  • Your renders: Antipode claims no ownership, royalty, or attribution requirement over audio you generate.
  • Notices: Read Rights & Provenance and Third-Party Notices (note: the working name Antipode has not undergone formal trademark clearance).