Repolode
vstorm-co

vstorm-co/pydantic-deepagents

Assistente de programação com IA para terminal, open source e auto-hospedado, acompanhado do framework Python que o alimenta, baseado em Pydantic AI e compatível com qualquer modelo.

Alternativa open source a:Claude Code

Estrelas
1,115
Forks
145
Issues abertas
3
Último commit
há 8 dias

O que é?

Pydantic Deep Agents é um assistente de IA para terminal no estilo do Claude Code e um framework Python para criar agentes semelhantes. A CLI pode planejar tarefas, ler e editar arquivos, executar comandos shell, pesquisar na web e buscar conteúdo, manter memória persistente, iniciar subagentes e se conectar a servidores MCP. O mesmo harness fica disponível por meio de uma única chamada a create_deep_agent(), que adiciona sistema de arquivos, shell, planejamento, memória, execução em sandbox e resumo de contexto a qualquer modelo.

O projeto usa Pydantic AI e oferece suporte a modelos da Anthropic, OpenAI, Google Gemini, OpenRouter e Ollama local, além de qualquer endpoint compatível com OpenAI. Seu diferencial é a ramificação de execuções em andamento: uma execução pode ser dividida em branches isoladas, cada uma testando uma abordagem diferente, e um juiz de IA ou um comando de teste escolhe qual manter. Outros recursos incluem sandbox com Docker e workspaces nomeados, checkpoints, um sistema de skills carregadas de arquivos SKILL.md, diálogos para aprovação de ferramentas e saída estruturada por meio de modelos Pydantic.

Recursos principais

  • 01TUI de terminal com edição de arquivos, execução de shell, pesquisa e busca na web, além de suporte a servidores MCP
  • 02Ramificação de execuções em andamento, dividindo uma execução em branches que são combinadas por um juiz de IA ou pelos resultados dos testes
  • 03Ponto de entrada do framework create_deep_agent() com opções para planejamento, subagentes, memória e skills
  • 04Sandbox com Docker e workspaces nomeados, com automação de navegador opcional via Playwright
  • 05Resumo automático de contexto em conversas longas e novas tentativas com um modelo alternativo
  • 06Checkpoints para salvar, retroceder e ramificar sessões

Casos de uso

  • Executar um assistente de programação auto-hospedado que funciona com o modelo de sua escolha
  • Criar um agente personalizado de pesquisa ou programação com base em um harness de agente pronto para uso
  • Testar várias abordagens de implementação em paralelo e manter a que passar nos testes
  • Automatizar tarefas de programação sem interface em CI ou scripts usando o comando run

Início rápido

  1. 1

    Instale a CLI no Windows ou manualmente com pip

    pip install "pydantic-deep[cli]"
  2. 2

    Execute o assistente pelo terminal

    pydantic-deep

Antes de usar

  • Requer Python 3.10 ou mais recente.
  • O script de instalação de uma linha para Linux e macOS deve ser executado manualmente a partir do README.

Em coleções

Tópicos

Perguntas frequentes

O que é pydantic-deepagents?
Assistente de programação com IA para terminal, open source e auto-hospedado, acompanhado do framework Python que o alimenta, baseado em Pydantic AI e compatível com qualquer modelo. Pydantic Deep Agents é um assistente de IA para terminal no estilo do Claude Code e um framework Python para criar agentes semelhantes. A CLI pode planejar tarefas, ler e editar arquivos, executar comandos shell, pesquisar na web e buscar conteúdo, manter memória persistente, iniciar subagentes e se conectar a servidores MCP. O mesmo harness fica disponível por meio de uma única chamada a create_deep_agent(), que adiciona sistema de arquivos, shell, planejamento, memória, execução em sandbox e resumo de contexto a qualquer modelo.
pydantic-deepagents é gratuito? Qual é a licença?
pydantic-deepagents é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
pydantic-deepagents ainda é mantido?
Manutenção ativa. O último commit de pydantic-deepagents foi em 30 de out. de 2026.
Para que posso usar pydantic-deepagents?
Executar um assistente de programação auto-hospedado que funciona com o modelo de sua escolha Criar um agente personalizado de pesquisa ou programação com base em um harness de agente pronto para uso Testar várias abordagens de implementação em paralelo e manter a que passar nos testes Automatizar tarefas de programação sem interface em CI ou scripts usando o comando run
Como instalar pydantic-deepagents?
Instale a CLI no Windows ou manualmente com pip: pip install "pydantic-deep[cli]" Execute o assistente pelo terminal: pydantic-deep
Onde consigo pydantic-deepagents?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/vstorm-co/pydantic-deepagents

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

Projetos relacionados