Repolode
disler

disler/durable-pi

Agentes Pi duráveis que rodam nos seus próprios dispositivos e continuam trabalhando após desconexões de clientes e reinicializações, controlados por uma interface web, terminal ou curl.

Estrelas
346
Forks
94
Issues abertas
0
Último commit
há 27 dias

O que é?

Durable Pi é uma rede de agentes de IA persistentes criada sobre pi-durable. Cada dispositivo roda um servidor pequeno, dpi-backend, que gerencia seus agentes, bancos de dados SQLite e ferramentas. Os clientes se conectam usando uma URL e um bearer token, por meio de um hub web que monitora todos os dispositivos, de um cliente de terminal chamado dpi-tui ou de uma única requisição curl.

Os agentes gravam o histórico, as entradas enfileiradas, os checkpoints das tarefas e o estado da aplicação no SQLite antes de exibir a saída. Se o navegador for fechado, o terminal for encerrado ou a máquina reiniciar durante a execução de uma ferramenta, a execução continua do último checkpoint. Ferramentas que podem ter sido executadas parcialmente retornam como resultados interrompidos, em vez de serem repetidas silenciosamente.

O repositório também inclui uma demonstração proativa em que um agente durável é iniciado por um evento de monitoramento de logs e prepara uma correção para aprovação. Há suporte a compactação, forks, um estado compartilhado da aplicação em JSON, jobs duráveis e controle de ferramentas por agente. Os dispositivos são declarados em um arquivo YAML e configurados por SSH, systemd, launchd ou exe.dev.

Recursos principais

  • 01Os agentes persistem o histórico, as entradas enfileiradas e os checkpoints no SQLite antes de exibir a saída.
  • 02As execuções continuam do último checkpoint após a desconexão de um cliente ou a reinicialização do dispositivo.
  • 03A interface web, o cliente de terminal (dpi-tui) e uma API HTTP simples compartilham o mesmo backend de agentes.
  • 04Faça fork de qualquer agente em qualquer entrada; os subagentes ficam aninhados sob o agente pai.
  • 05Estado compartilhado da aplicação em JSON, com atualizações atômicas de caminhos e detecção de conflitos 409.
  • 06Os dispositivos são declarados em YAML e implantados por SSH, systemd, launchd ou exe.dev.

Casos de uso

  • Executar um agente de programação pessoal em um servidor doméstico ou VM na nuvem, acessível de qualquer dispositivo.
  • Criar um agente proativo que começa a trabalhar a partir de eventos de log e prepara tarefas antes de você conferir.
  • Permitir que vários engenheiros acompanhem e orientem o mesmo agente durante um incidente.
  • Incorporar um agente durável e compatível com vários clientes atrás da interface do seu próprio produto.

Início rápido

  1. 1

    Copie o modelo de variáveis de ambiente e defina OPENROUTER_API_KEY

    cp .env.example .env
  2. 2

    Copie o modelo de configuração de rede

    cp dpi-network.example.yaml dpi-network.yaml
  3. 3

    Instale as dependências de todos os pacotes

    just install
  4. 4

    Registre esta máquina e compile a interface web; em seguida, inicie o backend

    just net up local

Antes de usar

  • Para executar, é necessário ter Node.js 24, just, zsh e uma chave de API da OpenRouter.
  • Dispositivos remotos precisam de conexão ssh sem senha e de alguma configuração em cada máquina.

Em coleções

Tópicos

Perguntas frequentes

O que é durable-pi?
Agentes Pi duráveis que rodam nos seus próprios dispositivos e continuam trabalhando após desconexões de clientes e reinicializações, controlados por uma interface web, terminal ou curl. Durable Pi é uma rede de agentes de IA persistentes criada sobre pi-durable. Cada dispositivo roda um servidor pequeno, dpi-backend, que gerencia seus agentes, bancos de dados SQLite e ferramentas. Os clientes se conectam usando uma URL e um bearer token, por meio de um hub web que monitora todos os dispositivos, de um cliente de terminal chamado dpi-tui ou de uma única requisição curl.
durable-pi é gratuito? Qual é a licença?
durable-pi é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
durable-pi ainda é mantido?
Manutenção ativa. O último commit de durable-pi foi em 11 de out. de 2026.
Para que posso usar durable-pi?
Executar um agente de programação pessoal em um servidor doméstico ou VM na nuvem, acessível de qualquer dispositivo. Criar um agente proativo que começa a trabalhar a partir de eventos de log e prepara tarefas antes de você conferir. Permitir que vários engenheiros acompanhem e orientem o mesmo agente durante um incidente. Incorporar um agente durável e compatível com vários clientes atrás da interface do seu próprio produto.
Como instalar durable-pi?
Copie o modelo de variáveis de ambiente e defina OPENROUTER_API_KEY: cp .env.example .env Copie o modelo de configuração de rede: cp dpi-network.example.yaml dpi-network.yaml Instale as dependências de todos os pacotes: just install Registre esta máquina e compile a interface web; em seguida, inicie o backend: just net up local
Onde consigo durable-pi?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/disler/durable-pi

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados