O que é DeerFlow?
O DeerFlow (Deep Exploration and Efficient Research Flow) é o harness de agentes de código aberto da ByteDance, construído sobre LangGraph e LangChain. Ele começou como um framework de pesquisa aprofundada; a versão 2.0, lançada em fevereiro de 2026 e marcada como v2.0.0 em junho, é uma reescrita do zero que não compartilha código com a v1 (ainda mantida em um branch 1.x) e o reposiciona como um harness geral que planeja, cria subagentes, roda código em sandboxes e mantém memória de longo prazo.
Ele roda como uma stack Docker ou como servidor de desenvolvimento local, com um espaço de trabalho web, uma Gateway API, um cliente Python embutido, uma bancada de terminal e canais de mensagens como Telegram, Slack, Discord e Feishu. É agnóstico em relação a modelos sobre APIs compatíveis com OpenAI, com presets para OpenAI, Anthropic, DeepSeek, Qwen, Doubao, Kimi, Zhipu e MiniMax.
O repositório tem licença MIT, cerca de 84.800 estrelas no GitHub e aproximadamente 990 issues abertas; a versão mais recente é a v2.1.0 (24 de setembro de 2026), e há commits todos os dias.
DeerFlow vale a pena?
O DeerFlow 2.0 é menos um framework do que um produto que você implanta: um servidor com subagentes, um sistema de arquivos em sandbox, memória, tarefas agendadas, projetos e canais de chat já conectados entre si. Essa é sua principal vantagem sobre LangGraph ou CrewAI, em que você monta essas partes por conta própria, e seu principal custo, porque a superfície que você passa a operar é grande. Só o README passa de 4.000 linhas de notas de configuração.
A reescrita segue o que os usuários fizeram com a v1. A ByteDance diz que as pessoas empurraram a ferramenta de pesquisa aprofundada para pipelines de dados, apresentações de slides e painéis, então a 2.0 dá ao agente um espaço de trabalho e deixa o agente principal entregar partes de um trabalho a subagentes com contexto próprio. A execução pode rodar no host, em contêineres Docker ou em pods Kubernetes por meio de um provisionador, e o assistente de configuração pergunta logo de início se deve permitir bash e gravação de arquivos. Busca e fetch se conectam a uma longa lista de provedores (Tavily, Brave, Jina, SearXNG, Firecrawl e outros), e uma skill claude-to-deerflow permite que o Claude Code envie trabalhos para ele.
A segurança é a parte para ler duas vezes. O próprio aviso do projeto diz que o DeerFlow pode executar comandos do sistema e foi pensado para uma máquina confiável em 127.0.0.1; a stack Docker se vincula ao loopback por padrão, e abri-la para uma LAN ou para a internet sem uma lista de IPs permitidos e um proxy com autenticação é, nas palavras dele, um risco de execução não autorizada de comandos. Administradores do Gateway podem registrar servidores MCP stdio, o que a documentação diz que deve ser tratado como execução de código no host.
O guia de dimensionamento é honesto sobre o peso: 4 vCPU e 8 GB de RAM para avaliar, 8 vCPU e 16 GB para um servidor compartilhado, antes de qualquer modelo local. Frente ao OpenHands, que é mais restrito e ajustado para tarefas de software, o DeerFlow é o generalista mais amplo; frente ao Hermes Agent, é mais pesado, porém mais voltado a serviço de equipe. Para um grupo que quer um único agente auto-hospedado para o qual as pessoas mandam mensagens pelo Slack e que deixam rodando por uma hora, é a opção aberta mais completa sobre a qual lemos, e o ritmo diário de commits significa que a configuração que você aprender este mês vai mudar.
Onde ele se destaca
Uma equipe de pesquisa de mercado de cinco pessoas
Transformar uma pergunta em um relatório com fontes e gráficos durante a noite
O agente principal planeja a pesquisa, subagentes buscam e coletam pelo Tavily ou pelo Brave, e código no sandbox Docker monta os gráficos. O software é gratuito; o custo são tokens do modelo mais um servidor de 8 vCPU e 16 GB.
Um engenheiro de plataforma em uma empresa de 200 pessoas
Dar à equipe um único agente interno para o qual possam mandar mensagens pelo Slack ou pelo Feishu
Rode a stack Docker no Linux, mantenha-a no loopback atrás de um proxy nginx com autenticação e de uma lista de IPs permitidos, e ative o canal do Slack em Socket Mode. Reserve tempo para a configuração de segurança em que o README insiste.
Um desenvolvedor que já usa o Claude Code
Delegar trabalhos de pesquisa longos sem sair do terminal
Instale a skill claude-to-deerflow para que o Claude Code envie tarefas a uma instância do DeerFlow em execução e verifique seu status, mantendo o trabalho de horas fora da sessão de programação.
Antes de decidir
- Configuração
- Clone o repositório e rode make setup, um assistente de cerca de dois minutos que escolhe provedor, busca e modo de sandbox; depois make docker-start. Precisa de Python 3.12+, Node 22+ e Docker Compose 2.24+.
- Integrações
- Modelos compatíveis com OpenAI, com presets para OpenAI, Anthropic, DeepSeek, Qwen, Doubao, Kimi, Zhipu e MiniMax; servidores MCP; Telegram, Slack, Discord, Feishu, DingTalk e WeCom; rastreamento com LangSmith e Langfuse; RAGFlow para conhecimento privado.
- Dados e privacidade
- Auto-hospedado; prompts e arquivos só vão para os provedores de modelo e de busca que você configurar. Vincula-se a 127.0.0.1 por padrão. Licença MIT; nenhum aviso de segurança publicado no GitHub, mas o próprio aviso de segurança do README adverte contra redes não confiáveis.
- Custo em escala
- Nenhuma edição paga é descrita. O README dimensiona um servidor compartilhado em 8 a 16 vCPU e 16 a 32 GB de RAM; os tokens do modelo para execuções multiagente de horas são a conta maior.
- Limites
- Cerca de 990 issues abertas; a 2.0 quebrou totalmente a compatibilidade com a v1; a configuração muda com frequência; macOS e Windows servem para avaliação, Linux com Docker para servidores.
O que é bom
- Subagentes, sandbox, memória, skills e agendamento vêm juntos
- Sandboxes Docker, locais ou Kubernetes; só loopback por padrão
- Agnóstico a modelos, com presets para oito grandes provedores
- Canais de mensagens, Gateway API, cliente Python e TUI
O que não é
- Executa comandos; inseguro expor sem um proxy com autenticação e uma lista de permissões
- Configuração extensa; o README passa de 4.000 linhas
- Precisa de 8 vCPU e 16 GB de RAM para um servidor compartilhado
- Cerca de 990 issues abertas e uma base de código que muda rápido
Ideal para
Equipes que querem um serviço de agentes auto-hospedado e de longa duração para pesquisa, relatórios e trabalhos de código, e que podem rodá-lo atrás de controles de rede adequados.
Alternativas ao DeerFlow
DeerFlow: perguntas frequentes
- DeerFlow vale a pena?
- Um servidor de agentes sério e completo da ByteDance, que hoje faz muito mais do que pesquisa, desde que você o trate como o serviço que executa código que ele é. Damos nota 4.2 de 5.
- Quanto custa DeerFlow?
- Gratuito e de código aberto (MIT); você paga a API do modelo e o servidor onde ele roda.
- Quais são as desvantagens de DeerFlow?
- Executa comandos; inseguro expor sem um proxy com autenticação e uma lista de permissões; configuração extensa; o README passa de 4.000 linhas; precisa de 8 vCPU e 16 GB de RAM para um servidor compartilhado; cerca de 990 issues abertas e uma base de código que muda rápido.
- Para quem DeerFlow é indicado?
- Equipes que querem um serviço de agentes auto-hospedado e de longa duração para pesquisa, relatórios e trabalhos de código, e que podem rodá-lo atrás de controles de rede adequados.
- Quanto custa DeerFlow para uma equipe ou em produção?
- Nenhuma edição paga é descrita. O README dimensiona um servidor compartilhado em 8 a 16 vCPU e 16 a 32 GB de RAM; os tokens do modelo para execuções multiagente de horas são a conta maior.
- DeerFlow é seguro para dados da empresa?
- Auto-hospedado; prompts e arquivos só vão para os provedores de modelo e de busca que você configurar. Vincula-se a 127.0.0.1 por padrão. Licença MIT; nenhum aviso de segurança publicado no GitHub, mas o próprio aviso de segurança do README adverte contra redes não confiáveis.
- Quais são as melhores alternativas ao DeerFlow?
- As alternativas mais próximas que analisamos são OpenHands, Hermes Agent, LangGraph, Magentic-UI (MagenticLite) e Agent Zero.
Respostas verificadas em 31 de out. de 2026.