Quick Start#
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.
Prerequisites#
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 venv
.
python3 -m venv env
source env/bin/activate
For Windows#
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 venv
.
First, install the WSL command:
wsl --install
This command will enable the features necessary to run WSL and install the Ubuntu distribution of Linux.
Activate the Linux shell:
wsl
Now, you are in a Linux environment and can create a virtual environment like so:
python3 -m venv env
source env/bin/activate
Using Conda#
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:
covid-wf
├── LICENSE
├── README.md
├── bowtie2
│ ├── bowtie2
│ └── ...
├── reference
│ ├── wuhan.1.bt2
│ └── ...
├── system-requirements.txt
├── version
└── wf
├── __init__.py
├── assemble.py
└── sort.py
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_assembly.sam
and 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!
Next Steps#
Understand how to author your own workflow.
Understand how to test and debug your workflow.
Read the Concepts page
Visit Examples to see real-world bioinformatics workflows being built using Latch SDK
Join the SDK open-source community on Slack here!