CLI¶
Atomatic installs two commands into the active python environment:
| Command | Use |
|---|---|
atomatic |
Configure atomatic, and list, enable, or disable addons. |
atomatic-mcp |
Start the atomatic tools as a stdio MCP server. |
atomatic is also available as python -m atomatic.cli, and atomatic-mcp
as python -m atomatic.tools.
atomatic configure¶
Set up atomatic in the active python environment.
$: atomatic configure
The first question selects the mode:
| Mode | Computer | Result |
|---|---|---|
| ez | one computer, local MLIP only | Asks for the model and API keys, installs the extras you select (MLIP extras are preselected), and writes .env. No HPC, no jobflow-remote. |
| pro | runner computer (hpc) | Installs the extras you select, writes the jobflow-remote config to ~/.jfremote and the cron scripts, checks MongoDB, and applies the (s)crontab. |
| pro | agent computer (laptop, workstation) | Installs the extras you select and writes .env. |
| pro | agent + runner computer (local jfremote) | Agent computer setup, plus a local jobflow-remote config and runner. Starts the runner and adds it to your crontab. |
Enter selects the [default]. < goes back one question. Ctrl-C stops. Before
it changes anything, configure shows the plan (each file it writes and each
command it runs) and asks once. For the full procedure, see Setup.
| Option | Description |
|---|---|
--set KEY=VALUE |
Give a .env value for the agent computer. Its question is not asked. Repeat it for more values. The runner ignores it. |
env |
Open the .env in $EDITOR (default vi). Make it from .env.example if it does not exist. |
Examples:
$: atomatic configure --set ATOMATIC_MODEL_NAME=openai:gpt-5.6-sol
$: atomatic configure env
atomatic addon¶
List the installed addons, or enable or disable one. [x] marks the enabled
addons. The enabled addons are in ATOMATIC_ADDONS in the .env.
| Option | Description |
|---|---|
| (none) | List the installed addons. |
--enable NAME |
Install the packages of the addon if necessary, then enable it. |
--disable NAME |
Disable the addon. Its packages stay. |
--runner |
With --enable, on the runner computer: install the runner packages only. |
Examples:
$: atomatic addon
$: atomatic addon --enable reactca
$: atomatic addon --enable reactca --runner
$: atomatic addon --disable reactca
Restart the agent after you enable or disable an addon. For more information, see Addons.
atomatic-mcp¶
Start the atomatic tools as an MCP server on stdio. It has no options. Your harness starts it, so you usually do not run it yourself. For harness configuration, see Run.
$: /path/to/venv/bin/atomatic-mcp