Get up and running with your first workflow in Python.#
In this quickstart, you install the Latch SDK and register a workflow to sort and assemble COVID genomes. The workflow makes use of two computational tools, SAM tools and bowtie, which will allow us to reconstruct the COVID genome from its reads.
Register for an account and log into the Latch Console
Step 1: Set up your developer environment#
For Linux/ MacOS#
We recommend installing Latch SDK in a fresh environment for best behaviour. To do so, you can use
python3 -m venv env
The Latch SDK is a Python package, so we recommend installing Latch SDK in a fresh environment for best behavior. To do so, you can use
First, install the WSL command:
This command will enable the features necessary to run WSL and install the Ubuntu distribution of Linux.
Activate the Linux shell:
Now, you are in a Linux environment and can create a virtual environment like so:
python3 -m venv env
Alternatively, you can use
conda to create your environment:
conda create --name latch python==3.10
Step 2: Install Latch#
The Latch SDK is available as a Python package.
Latch currently supports Python >=3.8, <3.11.
Install it using pip:
python3 -m pip install latch
Step 3: Initialize Workflow Directory#
Bootstrap a new workflow directory by running
latch init from the command line:
latch init covid-wf
The command opens a list of workflow templates that you can select from. for this tutorial, select Subprocess Example:
The command creates a folder in your current working directory called
covid-wf. Inside that folder, it will generate the initial project structure:
│ ├── bowtie2
│ └── ...
│ ├── wuhan.1.bt2
│ └── ...
Step 4: Register your first workflow#
To get a live version of your workflow on Latch, simply type:
latch register --remote --yes covid-wf
When registering the workflow for the first time, you will be prompted to log into Latch via the browser.
Optional: Registering workflow on a machine without a browser#
If you are using a virtual machine without a browser, you will be prompted to enter an API key. To retrieve your key:
Navigate to your Personal Workspace.
Visit the Developer Settings > Access Tokens
Copy the API key, and paste to the terminal prompt
Once registration completes, visit Latch Console, and you will see a live, no-code interface of your assemble and sort workflow!
Step 5: Running your workflow on Latch#
To launch your first workflow, make sure that you are on your workflow page in Latch Console. Then, select the Test Data and click Launch.
Once the workflow finishes running, you can see both the
covid_sorted.bam files on Latch Console. The SAM file contains the sequence alignment data, and the BAM file is the binary version of the SAM file.
To further check that the genome is aligned properly, simply double click on the output file to open an IGV.
The next time your scientists want to reconstruct COVID genome from sequencing reads, they can visit your workflow on Latch Console!