loom

O Loom (Zhi Liu) é uma plataforma de fluxo de trabalho para agentes que opera localmente, projetada para resolver o ciclo completo de tarefas complexas como modelagem matemática, relatórios de pesquisa e redação de documentos longos. Ele decompõe as tarefas em fluxos de múltiplas etapas editáveis, onde cada etapa pode ser vinculada a habilidades (skills), nomes de arquivos de saída, papéis (execução/revisão/edição), motores e modelos. O sistema suporta pausas em checkpoints para confirmação manual. Funcionalidades Principais: - Orquestração Visual: Interface para adicionar, remover e configurar etapas do fluxo. - Biblioteca de Habilidades: Gerenciamento de especificações de prompt, com suporte à criação, edição, cópia e importação de pacotes padrão (zip/SKILL.md). - Execução em Tempo Real: Utiliza SSE (Server-Sent Events) para execução em streaming, exibindo chamadas de ferramenta e saídas na área de transcrição. O painel de status mostra o progresso de cada etapa, enquanto o painel de arquivos lista os documentos sendo gerados, com renderização instantânea de Markdown e pré-visualização de imagens/PDFs. - Revisão Local Conversacional: Permite corrigir etapas específicas sem precisar reexecutar todo o fluxo. - Importação/Exportação: Fluxos são salvos como arquivos JSON para compartilhamento e backup. Regra Fundamental: O conteúdo textual é gerado exclusivamente por agentes CLI locais. O Loom não se conecta diretamente a interfaces de grandes modelos; ele injeta endpoints e chaves no Claude Code (`claude`) ou Codex CLI (`codex`). É necessário ter um desses instalados e logados. Instalação e Execução: ```bash pip install -r requirements.txt python run.py # Inicia em http://127.0.0.1:8000 python run.py --port 8001 # Altera a porta python run.py --auto-kill # Libera portas ocupadas automaticamente ``` Testes de Regressão: ```bash python -m pytest -q ``` Estrutura do Projeto: - `app/`: Backend FastAPI (main.py, runner.py, agents.py, updater.py). - `static/`: Frontend nativo (HTML/CSS/JS). - `tests/`: Testes pytest. - `loom_launch.py`: Ponto de entrada empacotado (pywebview). - `run.py`: Ponto de entrada para código fonte. - `make_release.py` e `upload_cos.py`: Scripts de build e publicação. Armazenamento de Dados: Os dados residem em `modex-data/` durante o desenvolvimento e em `data/` junto ao executável após instalação. Inclui SQLite, workspace, habilidades personalizadas e exportações. Os dados persistem entre atualizações e não são excluídos na desinstalação. Privacidade: Sem contas de servidor, rastreamento ou upload de dados. Todo o processamento ocorre localmente. A única comunicação externa é para verificação de versão ou interação direta do agente CLI com serviços de modelo. Download: https://lxlrwxs.top/modelflow/ (Windows 10/11, totalmente local).