Set up MACS3 as a remote tool

Sharing this model for a user, not developing it? Follow the tooluniverse-share-computer guide; no ToolUniverse source checkout is needed. The model runs in its own Python environment, with its dependencies:

~/.local/bin/uv venv --python 3.12 ~/.tooluniverse/envs/macs3
curl -fsSL -o ~/.tooluniverse/envs/macs3-tooluniverse.txt https://connect.aiscientist.tools/install-requirements.txt
curl -fsSL -o ~/.tooluniverse/envs/macs3-requirements.txt https://raw.githubusercontent.com/mims-harvard/ToolUniverse/main/src/tooluniverse/remote/macs3/requirements.txt
~/.local/bin/uv pip install --python ~/.tooluniverse/envs/macs3/bin/python -r ~/.tooluniverse/envs/macs3-tooluniverse.txt -r ~/.tooluniverse/envs/macs3-requirements.txt
~/.local/bin/tu remote check macs3 --python ~/.tooluniverse/envs/macs3/bin/python   # lists anything still missing
~/.local/bin/tu serve --allow macs3 --python ~/.tooluniverse/envs/macs3/bin/python --share --detach --name "<computer name>" --service https://tooluniverse-backend.onrender.com

If the check reports a missing environment variable (a data folder, a model cache, a provider key), set it in the same shell before tu serve; "Obtain credentials, data, and model weights" below says what each one is. The model reads only the variables it declares.

The rest of this guide is for developers working from the ToolUniverse source, and for diagnosing problems with this model.

Validation status (2026-08-16): compiled MACS3 3.0.4, loopback discovery/call, and provider-root rejection passed; the current documented no-model/fixed-extension synthetic BED call returned three peaks. Public publication, cross-user isolation, representative accuracy, broad concurrency, cancellation, and recovery remain incomplete. Authenticated private Platform import and owner testing passed on 2026-08-16; public publication and independent-caller authorization/isolation remain untested.