# DeerFlow — SuperAgent for Research, Code & Creative

> ByteDance's open-source long-horizon SuperAgent with sub-agents, sandboxes, memory, and skills. Handles complex tasks spanning minutes to hours. 58,300+ stars, MIT license.

## Install

Save as a script file and run:

## Quick Use

```bash
git clone https://github.com/bytedance/deer-flow.git && cd deer-flow
make config       # Generate config from templates
make docker-start # Launch via Docker (recommended)
```

Set API keys in `.env`: `OPENAI_API_KEY`, `TAVILY_API_KEY`, etc.
Access the UI at `http://localhost:2026`.

---

## Intro

DeerFlow (Deep Exploration and Efficient Research Flow) is ByteDance's open-source SuperAgent framework with 58,300+ GitHub stars and MIT license. It orchestrates sub-agents, sandboxes, memory systems, and extensible skills to handle complex, long-horizon tasks — from deep research and code generation to creative production. Hit #1 on GitHub Trending when v2.0 launched in February 2026. Supports Docker/Kubernetes deployment, multiple LLM providers (OpenAI, Anthropic, DeepSeek, Doubao), and integrations with Telegram, Slack, Feishu/Lark.

Best for: developers and researchers who need autonomous agents for complex, multi-step tasks lasting minutes to hours.
Works with: OpenAI, Anthropic Claude, DeepSeek, OpenRouter, Doubao, Kimi.
Setup time: under 5 minutes with Docker.

---

## DeerFlow — Architecture & Features

### Core Components

| Component | Purpose |
|-----------|---------|
| **Sub-Agents** | Hierarchical agent orchestration — delegate and specialize |
| **Sandboxes** | Docker/local/K8s isolation for safe code execution |
| **Memory System** | Persistent context across sessions |
| **Skills** | Composable tools: web search, code execution, file ops |
| **Context Engineering** | Sophisticated prompt management and state handling |
| **Multi-Channel** | Telegram, Slack, Feishu/Lark, WeCom |

### Deployment Modes

| Mode | Description |
|------|-------------|
| **Standard** | Separate LangGraph server + frontend |
| **Gateway** | Embedded agent runtime — fewer processes, lower overhead |
| **Docker** | `make docker-start` — recommended for production |
| **Kubernetes** | K8s-ready with sandbox isolation |

### Tech Stack

- **Backend**: Python 3.12+, LangChain, LangGraph, FastAPI
- **Frontend**: Node.js 22+, React/TypeScript
- **Observability**: LangSmith/Langfuse tracing
- **Package Management**: `uv` (Python), `pnpm` (Node.js)

### Supported LLM Providers

OpenAI, Anthropic Claude, OpenRouter, DeepSeek, Doubao, Kimi — configure in `config.yaml`.

### FAQ

**Q: What is DeerFlow?**
A: ByteDance's open-source SuperAgent framework that orchestrates sub-agents, sandboxes, and memory for complex tasks spanning minutes to hours. 58,300+ stars, MIT license.

**Q: Is it free?**
A: Yes, MIT license. You provide your own LLM API keys.

**Q: How does it compare to CrewAI or AutoGen?**
A: DeerFlow focuses on long-horizon tasks with sandbox execution, persistent memory, and multi-channel integration. CrewAI/AutoGen focus more on multi-agent conversation patterns.

---

## Source & Thanks

> Created by [ByteDance](https://github.com/bytedance). Licensed under MIT.
>
> [deer-flow](https://github.com/bytedance/deer-flow) — ⭐ 58,300+

---

<!-- ZH -->

## 快速使用

```bash
git clone https://github.com/bytedance/deer-flow.git && cd deer-flow
make config && make docker-start
```

---

## 简介

DeerFlow 是字节跳动的开源 SuperAgent 框架，58,300+ Star，MIT 许可证。编排子 Agent、沙箱、记忆系统和可扩展技能，处理从深度研究到代码生成的复杂长时任务。支持 Docker/K8s 部署和多个 LLM 提供商。

---

## 来源与感谢

> Created by [ByteDance](https://github.com/bytedance). Licensed under MIT.
>
> [deer-flow](https://github.com/bytedance/deer-flow) — ⭐ 58,300+

---
Source: https://tokrepo.com/en/workflows/1e49009e-4fce-498a-a1a9-352aa1aec19b
Author: Script Depot