When to use the CLI
Bulk uploads
Push hundreds of FASTQ files from a sequencing run to a project without clicking through the browser uploader.
Scripted workflows
Wire Galagos into shell scripts, Snakemake or Nextflow stages, or institutional pipelines that already run from a terminal.
HPC integration
Trigger an analysis from a login node or a scheduled job on an institutional cluster.
CI and reproducibility
Re-run a defined analysis on a schedule, or as part of an automated reproducibility check.
Generating an access token
The CLI authenticates with a personal access token you mint from your profile page. Tokens carry your account’s permissions and let you read and write any workspace you can access through the web app.1
Open your profile
Click your account avatar in the top-right corner and choose Profile.
2
Scroll to API tokens
Find the API token section on the profile page. If you have not generated a token before, the section will be empty.
3
Generate a token
Click Generate token. The full token is shown once, immediately after generation, and remains visible for five minutes before being hidden.
4
Copy the token now
Copy the token to your clipboard or a secure password manager during the five-minute window. After that, only the token’s prefix is visible and the full value cannot be recovered.
5
Regenerate if needed
If you lose a token, click Regenerate. The old token is revoked immediately. Any device using the previous token will need to re-authenticate.
Installing the CLI
The CLI is distributed as a standalone Python package. Installation and command details live in the CLI’s own repository.Galagos CLI repository
Installation instructions, command reference, and release notes.
What you can do from the CLI
The CLI mirrors the most common project operations available in the web app:- Upload one or many files into a project.
- Download project outputs to your local machine.
- List projects, sessions, and files.
- Trigger a new analysis by sending a prompt to a session.
Rotating or revoking access
If a token is exposed — or someone leaves the lab — rotate immediately:- Open Profile → API token.
- Click Regenerate. The previous token is revoked the moment the new one is issued.
- Distribute the new token to any machines that need to keep CLI access.
Related pages
Account setup
Register, choose a plan, and configure your account before generating a token.
Workspaces
The audit log records every action a CLI token takes inside a workspace.

