Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vibrai.com/llms.txt

Use this file to discover all available pages before exploring further.

Install the Vibrai M4L device and Python remote script.

Command line

install device

Install the Vibrai Max-for-Live device + JS bridge into Live’s User Library
vibrai install device --force --source <PATH> --dest <PATH>
--force
Overwrite an existing install whose files differ from the source.
--source
[advanced] Override the source directory (test/debug use).
--dest
[advanced] Override the destination directory (test/debug use).

install remote-script

Install the Vibrai Python remote script into Live’s User Library
vibrai install remote-script --force --source <PATH> --dest <PATH>
--force
Overwrite an existing install whose files differ from the source.
--source
[advanced] Override the source directory (test/debug use).
--dest
[advanced] Override the destination directory (test/debug use).

install all

Run both install device and install remote-script
vibrai install all --force
--force
Overwrite existing installs whose files differ from the source.

MCP tools

install_device

Copy the bundled vibrai.amxd Max-for-Live device + JS bridge files into the user’s Ableton User Library. By default refuses to overwrite a modified install — pass force=true to clobber. Run once after installing the .mcpb extension; then open Ableton Live and drag vibrai.amxd onto a track. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.
{
  "tool": "install_device",
  "arguments": {
    "force": "<Boolean>",
    "source_override": "<String>",
    "dest_override": "<String>"
  }
}
force
Boolean
Overwrite an existing install whose files differ from the source (default false)
source_override
String
[advanced] Test-only override for the source directory
dest_override
String
[advanced] Test-only override for the destination directory

install_vibrai_remote_script

Copy the bundled Vibrai Python remote script into Live’s User Library Remote Scripts directory. By default refuses to overwrite a modified install — pass force=true to clobber. After install, restart Live and enable ‘Vibrai’ under Preferences → Link/Tempo/MIDI → Control Surface. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.
{
  "tool": "install_vibrai_remote_script",
  "arguments": {
    "force": "<Boolean>",
    "source_override": "<String>",
    "dest_override": "<String>"
  }
}
force
Boolean
Overwrite an existing install whose files differ from the source (default false)
source_override
String
[advanced] Test-only override for the source directory
dest_override
String
[advanced] Test-only override for the destination directory