Integração LatchBio

Linha de Base Atual

Esta skill tem como alvo o Latch SDK 2.77.1, lançado em 17 de setembro de 2026. Os metadados do pacote suportam Python 3.9–3.12 e declaram Python 3.9+.

Status da revisão: as importações do SDK, assinaturas documentadas, ajuda da CLI e exemplos selecionados de grafos de fluxo de trabalho foram verificados localmente com Python 3.12. Os exemplos com rede são ilustrativos: nenhum registro autenticado, mutação de dados, lançamento ou chamada de ferramenta MCP foi realizado durante esta atualização.

Trate o pacote instalado e seu changelog como autoridade quando um guia discordar do SDK. Alguns guias do Latch mantêm intervalos de Python mais antigos ou pins de pré-lançamento específicos de compatibilidade, especialmente o tutorial do Snakemake v2. Nunca combine comandos ou importações de trilhas diferentes sem verificar seus requisitos de versão.

Quando Usar

Use esta skill para:

• Criar ou manter fluxos de trabalho e grafos de tarefas do SDK Python
• Empacotar e registrar pipelines Python, Nextflow ou Snakemake
• Configurar CPU, memória, armazenamento, GPU, cache, retentativas e timeouts de tarefas
• Trabalhar com Latch Data através de LPath, LatchFile, LatchDir ou a CLI
• Ler ou atualizar projetos, tabelas e registros do Latch Registry
• Projetar formulários de fluxo de trabalho, planos de lançamento, amostras, mensagens e links de resultados
• Preparar e depurar imagens de fluxo de trabalho com latch register --staging e latch develop
• Lançar e monitorar fluxos de trabalho através de Python ou Latch MCP
• Descobrir e usar fluxos de trabalho Latch prontos para uso

Rota para a Referência Correta

Leia apenas as referências necessárias para a tarefa:

Antes de confiar em um símbolo, execute scripts/inspect_latch_sdk.py contra a versão do SDK de destino. Ele realiza apenas importações locais e não autentica nem faz solicitações de rede.

Instalação e Autenticação

Para um ambiente reproduzível:

uv venv --python 3.12
source .venv/bin/activate
uv pip install "latch==2.77.1"

No Windows, use WSL para as ferramentas de fluxo de trabalho Linux documentadas.

Autentique-se através do fluxo OAuth suportado; não leia, imprima, copie ou analise ~/.latch/token manualmente:

latch login
latch workspace

Selecione um workspace de forma não interativa quando seu ID numérico já for conhecido:

latch workspace --id 12345

Credenciais latch login são para o SDK e CLI. Latch MCP usa uma autorização OAuth separada e suas credenciais não podem ser reutilizadas para acesso geral ao SDK.

Caminho Rápido

Crie e registre remotamente o template de subprocesso mantido:

latch init covid-wf --template subprocess
latch register --yes --open covid-wf

A construção remota de imagens é o padrão. Use --no-remote apenas quando um daemon Docker local estiver disponível e uma construção local for intencional.

Fluxo de Trabalho Python Mínimo

Mantenha os corpos dos fluxos de trabalho declarativos: invoque tarefas e retorne suas promessas. Execute computação e efeitos colaterais dentro das tarefas.

from latch import small_task, workflow


@small_task
def reverse_complement(sequence: str) -> str:
    table = str.maketrans("ACGTacgt", "TGCAtgca")
    return sequence.translate(table)[::-1]


@workflow
def reverse_complement_workflow(sequence: str) -> str:
    """Reverse-complement a DNA sequence.

    This minimal example handles A, C, G, and T bases.
    """
    return reverse_complement(sequence=sequence)

Use @workflow(metadata) quando a interface gerada precisar de rótulos personalizados, seções, regras de validação, amostras ou links de documentação. Use LatchFile ou LatchDir para preparação automática de entrada de tarefas e upload de saída; use LPath para operações de caminho remoto imperativas.

Ciclo de Vida de Desenvolvimento Recomendado

1. Inspecionar compatibilidade
   • Confirme o SDK instalado e a versão do Python.

…