Quickstart

Get started with THOA in just a few minutes, no infrastructure setup required.

1. Install

We also recommend using a virtual environment to manage system-level Python package installations.

pip install thoa

Next Step

After installing the client, create and save your API key to link your local THOA client with your workspace and securely manage your jobs and data.

2. Launch Your First Job

Once your API key is configured, you’re ready to run your first job.

The run command lets you execute containerized bioinformatics tools directly from your terminal.
Here’s a simple hello-world example to get started:

thoa run \
  --cmd "echo 'hello world, from Thoa\!' > ./output.txt" \         # the command to run inside the container
  --tools six \                                                    # which tool(s) or environments to load
  --output ./ \                                                    # where to place output files
  --download-dir ./ \                                              # where to download results on your machine
  --storage 2 \                                                    # GB of disk space to allocate
  --n-cores 1 \                                                    # number of CPU cores to use
  --ram 2 \                                                        # GB of RAM to allocate

This command will:

• Upload the files found in ./ and stage them to a virtual disk in the cloud
• Create a temporary compute environment with 1 core, 2 GB RAM, and 2 GB storage
• Create a compute environment with the specified tools (six) (currently Conda inside Docker. Support for other environments coming soon)
• Run the command echo 'hello world, from Thoa!' > ./output.txt
• Download results to the local folder ./

If you want a full breakdown of all available command flags and examples, see the CLI documentation.