The CLI

The machinable command mirrors the Python API: name a module, optionally a version and config overrides, and call methods.

machinable get <module> [~version …] [key=value …] [--method …]

Resolving and launching

machinable get optimize lr=0.5 --launch          # resolve + run __call__
machinable get optimize lr=0.5 --launch --loss   # then call .loss() and print it
machinable get train ~adam lr=3e-4 --launch       # versions and overrides

• key=value sets a config override (dotted paths nest: optimizer.lr=0.1).
• ~version applies a version method (~adam, ~large).
• --<method> calls a method on the resolved interface; a returned value is printed. --launch runs the interface. Arguments follow the same convention as ~versions: --summary(top=3) calls summary(top=3) (quote the token if your shell parses parentheses).
• .<path> is shorthand for interface.<path>: machinable get .example is machinable get interface.example.

Chaining contexts

List several modules; all but the last are opened as contexts wrapping the final one, the CLI equivalent of nested with blocks (e.g. an execution or a scope):

machinable get multiprocess processes=4 train ~sgd --launch
#               └── context ──────────┘ └── target ──┘

Choosing where results live

By default results go to ./storage. Point machinable at a specific storage location by opening machinable.storage as a context:

PYTHONPATH=.:$PYTHONPATH machinable get machinable.storage directory=$STORAGE <interfaces…>

A handy alias for your .bashrc:

function ma { PYTHONPATH=.:$PYTHONPATH machinable get machinable.storage directory=$STORAGE "$@"; }
# then:  ma optimize lr=0.5 --launch

Other commands

machinable version          # print the installed version
machinable fetch            # download declared remotes without importing them
machinable mcp --project .  # launch the research MCP server (see Agents & MCP)
machinable help get         # usage

machinable fetch supports inspecting remote code before it ever executes.

The machinable mcp server is documented in Agents & MCP → Setup.