PyLabRobot

Use os frontends agnósticos de hardware, árvore de recursos, rastreadores e backends específicos de dispositivo do PyLabRobot para desenvolver automação de laboratório. Use por padrão validação local de manifestos, contabilidade e o backend "chatterbox" apenas de software.

Snapshot verificado

• Estável no PyPI: PyLabRobot==0.2.2, lançado em 2026-07-30.
• Requisito upstream: Python >=3.9; verificações em tempo de execução aqui usaram Python 3.13.
• As páginas hospedadas /stable/ misturam páginas da API 0.2.1 com documentação de desenvolvimento. O GitHub não tem a tag v0.2.2 e seu changelog não tem a seção 0.2.2. Use a distribuição wheel/source lançada para o contrato testado, não o rótulo do URL.
• Backends de liquid-handler lançados incluem STARBackend, VantageBackend, EVOBackend, OpentronsOT2Backend e o apenas de software LiquidHandlerChatterboxBackend.
• MicroSpin e Plate.stacking_z_height estão presentes em 0.2.2, apesar de estarem listados sob Unreleased no changelog atual. APIs de desenvolvimento mais novas, incluindo a palavra-chave de deck Hamilton track=, não estão nesta versão.
• Veja a revisão de lançamento e transporte para hashes de origem, comportamento testado e a incompatibilidade conhecida de cancelamento do OT-2.

Limite de hardware não negociável

Nunca conecte, inicialize, retorne à posição inicial, mova, aqueça, agite, centrifugue, bombeie, abra/feche ou comande de outra forma equipamentos físicos automaticamente. Não transforme um plano de simulação em um backend ativo apenas mudando uma variável de ambiente, valor de configuração ou importação.

Antes de qualquer execução ativa separadamente autorizada, exija que um humano treinado:

1. Confirme explicitamente o backend exato, identidade do dispositivo, firmware, transporte, deck e revisão do protocolo.
2. Reconcilie o deck físico com a árvore de recursos, incluindo suportes, adaptadores, tampas, placas, racks de pontas, resíduos, orientação do material de laboratório, códigos de barras e cada coordenada ocupada.
3. Verifique a calibração, ensino, envelopes de movimento, riscos de colisão, folgas do gripper ou canal, e todas as coordenadas de aspiração/dispensa.
4. Revise a identidade da origem e o volume real de preenchimento, volume morto, capacidade de destino, compatibilidade do tipo/capacidade/filtro da ponta, mapeamento de canal, unidades, alturas, taxas, classe de líquido, blowout/mistura e limites de contaminação.
5. Confirme proteções, portas, capacidade de resíduos, contenção, prontidão do botão de parada de emergência, EPI, controles de biossegurança/químicos e um procedimento seguro de abortar/recuperar.
6. Aprove uma execução a seco lenta ou uma execução de comissionamento não perigosa quando algo for novo ou alterado.

O estado do rastreador é contabilidade, não detecção. Ele não pode provar que líquido ou uma ponta está fisicamente presente. Após um erro de backend, o rollback do rastreador descreve o estado do software; ele não reverte uma aspiração, dispensa ou movimento de ponta física que foi parcialmente concluído. Preserve os detalhes do erro/canal e peça ao operador para reconciliar pontas e volumes de origem/destino antes de retomar. Não tente cegamente a operação falhada do plano pré-erro. A implementação do liquid-handler 0.2.2 confirma ou reverte rastreadores de acordo com o sucesso da operação relatado. O Visualizador renderiza eventos de recurso/rastreador; ele não modela a física. Chatterbox imprime operações planejadas; ele não prova calibração, alcançabilidade, ausência de colisão, comportamento do líquido ou estado do dispositivo.

Entrada necessária

Não adivinhe nenhum destes:

• Modelo exato do dispositivo, opções instaladas, firmware, computador/SO e transporte.
• Versão estável do PyLabRobot e extras necessários.
• Deck/origem do deck, suportes, adaptadores, definições de recursos, dimensões, coordenadas, orientações e folgas de movimento.
• Capacidades e volumes mortos de placas/tubos/reservatórios; volumes físicos iniciais.
• Modelo da ponta, filtro, encaixe, capacidade, estado do rack, contagem de canais e mapeamento de canais.
• Unidades de transferência (uL, mm, uL/s, s), alturas, taxas, mistura, lacunas de ar, blowout, propriedades do líquido e classe de líquido validada pelo fornecedor.
• Política de contaminação, controles, manuseio de resíduos, intervenções do operador, critérios de aceitação e procedimento de recuperação.

Se a informação estiver faltando, produza uma lista de suposições/bloqueios e um rascunho offline apenas.

Instalação reproduzível

Para inspeção offline da API e simulação do chatterbox:

uv venv --python 3.13 .venv-pylabrobot
uv pip install --python .venv-pylabrobot/bin/python "PyLabRobot==0.2.2"

No Windows, use .venv-pylabrobot\Scripts\python.exe. Não instale extras de hardware até que o usuário nomeie o dispositivo e aprove explicitamente seu transporte

…