setup-singler-remote-tool
Set up SingleR as a remote tool
Sharing this model for a user, not developing it? Follow the
tooluniverse-share-computerguide; 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/singler curl -fsSL -o ~/.tooluniverse/envs/singler-tooluniverse.txt https://connect.aiscientist.tools/install-requirements.txt curl -fsSL -o ~/.tooluniverse/envs/singler-requirements.txt https://raw.githubusercontent.com/mims-harvard/ToolUniverse/main/src/tooluniverse/remote/singler/requirements.txt ~/.local/bin/uv pip install --python ~/.tooluniverse/envs/singler/bin/python -r ~/.tooluniverse/envs/singler-tooluniverse.txt -r ~/.tooluniverse/envs/singler-requirements.txt ~/.local/bin/tu remote check singler --python ~/.tooluniverse/envs/singler/bin/python # lists anything still missing ~/.local/bin/tu serve --allow singler --python ~/.tooluniverse/envs/singler/bin/python --share --detach --name "<computer name>" --service https://tooluniverse-backend.onrender.comIf 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): R 4.4.3/SingleR 2.8.0, loopback discovery, and a deterministic query/reference call passed with 240 aligned labels. Public publication, cross-user isolation, representative reference/accuracy validation, broad concurrency, 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.