// the find
bytedance/deer-flow
An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.
DeerFlow is ByteDance's open-source agent harness built on LangGraph that orchestrates sub-agents, sandboxed execution, and persistent memory for long-horizon tasks — think multi-hour research, code generation, or report creation. It's a batteries-included runtime rather than a framework you assemble yourself. Aimed at developers who want a self-hosted alternative to commercial agent platforms.
The middleware stack is genuinely well-designed — dangling tool call recovery, loop detection, and summarization are handled as composable pipeline stages rather than bolted-on hacks. The skill system (Markdown-driven workflow modules loaded progressively) is clever and keeps context windows lean. Sandbox isolation via Docker containers with per-thread filesystems is the right call for anything doing real code execution. The embedded Python client that mirrors the HTTP Gateway API and is CI-validated against the same Pydantic schemas is a sign of engineering discipline.
The single-Gateway-worker constraint due to in-process run state is a real scaling ceiling — if you need horizontal scale you're stuck until they ship a shared stream bridge, and there's no timeline for that. The config surface is enormous: config.yaml has 30+ top-level concepts, and the `make setup` wizard smooths onboarding but doesn't help when something breaks. The ByteDance-backed model recommendations (Doubao-Seed, Volcengine) and the InfoQuest integration create vendor pull toward their stack despite the model-agnostic framing. Windows support is a second-class citizen — local dev requires Git Bash and explicitly doesn't support PowerShell or WSL, which will bite anyone not on Linux or macOS.