{"full_name":"bytedance/deer-flow","owner":"bytedance","name":"deer-flow","url":"https://github.com/bytedance/deer-flow","description":"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.","homepage":"https://deerflow.tech","topics":[],"language":"Python","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/4158466?v=4","created_at":"2025-05-07T02:50:19Z","pushed_at":"2026-11-10T09:26:39Z","metrics":{"stars":85209,"forks":11985,"watchers":330,"issues":2622,"prs":5160,"releases":3,"issues_open":null,"issues_closed":null,"prs_open":null,"prs_closed":null,"prs_merged":null,"discussions":145},"growth":{"day":{"stars":39,"forks":5,"base_day":"2026-11-09"},"week":{"stars":321,"forks":54,"base_day":"2026-11-03"}},"history":{"dates":["2026-10-17","2026-10-18","2026-10-19","2026-10-20","2026-10-21","2026-10-22","2026-10-23","2026-10-24","2026-10-25","2026-10-26","2026-10-27","2026-10-28","2026-10-29","2026-10-30","2026-10-31","2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-09","2026-11-10"],"stars":[83754,83810,83866,83911,83959,84021,84150,84200,84248,84287,84337,84380,84449,84494,84577,84654,84735,84888,84946,85170,85209],"forks":[11654,11669,11684,11694,11705,11714,11750,11766,11777,11785,11796,11803,11824,11835,11855,11869,11885,11931,11941,11980,11985],"watchers":[339,339,339,338,336,336,334,334,334,334,334,329,329,329,331,330,329,331,331,330,330],"issues_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null],"prs_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null]},"boards":{"total":198},"same_owner":[{"full_name":"bytedance/Dolphin","name":"Dolphin","boards":{}},{"full_name":"bytedance/IconPark","name":"IconPark","boards":{}},{"full_name":"bytedance/UI-TARS","name":"UI-TARS","boards":{}},{"full_name":"bytedance/UI-TARS-desktop","name":"UI-TARS-desktop","boards":{}},{"full_name":"bytedance/monolith","name":"monolith","boards":{}},{"full_name":"bytedance/sonic","name":"sonic","boards":{}},{"full_name":"bytedance/trae-agent","name":"trae-agent","boards":{}},{"full_name":"bytedance/xgplayer","name":"xgplayer","boards":{}}],"issues":[{"number":1156,"title":"有没有人建个QQ群互相讨论的？没有的话我临时创建一个，Q群号：711729347","comments":40,"created_at":"2026-03-16T08:25:01Z"},{"number":1669,"title":"RoadMap of DeerFlow Q2","comments":30,"created_at":"2026-03-31T09:46:51Z"},{"number":819,"title":"DeerFlow 2.0 wish list,  你们希望有哪些功能？","comments":22,"created_at":"2026-01-17T14:51:30Z"},{"number":6269,"title":"Feature: 统一 DeerFlow Knowledge 能力层，并接入 WeKnora","comments":21,"created_at":"2026-10-04T09:30:13Z"},{"number":1415,"title":"按照文档接入飞书后无法使用","comments":19,"created_at":"2026-03-26T13:28:30Z"},{"number":4189,"title":"Checkpoint storage still grows: residual base64 in messages, multi-instance storage, retention policy, large tool results","comments":17,"created_at":"2026-07-15T01:02:33Z"},{"number":4680,"title":"[feat] 多智能体协同：lead_agent可以调度custom agent吗？因为大部分人观念里面，我创建了一个custom agent后应该可以由主智能体调度的","comments":16,"created_at":"2026-08-04T13:58:05Z"},{"number":74,"title":"MCP 工具无法调起，如何强制调起外部的 MCP server 服务来进行服务","comments":16,"created_at":"2025-05-12T07:34:27Z"}],"discussions":[{"number":7970,"title":"Tool-level idempotency registry for recovered tool executions — is this worth building?","comments":1,"category":"Ideas","created_at":"2026-11-07T09:17:10Z"},{"number":7896,"title":"DeerFlow 2.2.0","comments":0,"category":"Announcements","created_at":"2026-11-04T12:56:58Z"},{"number":7895,"title":"[Proposal] Adaptive Ephemeral Tool Output Pruning in SummarizationMiddleware for Long-Horizon Agent Runs","comments":4,"category":"Ideas","created_at":"2026-11-04T12:54:08Z"},{"number":7880,"title":"建议将 examples 下的扩展统一迁移至 deer-flow 组织管理","comments":1,"category":"Ideas","created_at":"2026-11-04T06:24:44Z"},{"number":7785,"title":"Has the team considered Rust for DeerFlow's core runtime?","comments":0,"category":"Q&A","created_at":"2026-11-01T09:22:39Z"},{"number":7680,"title":"[RFC] Subagent task cards: grouping, settings and retry / 子 Agent 任务卡：分组、配置与重试","comments":0,"category":"Ideas","created_at":"2026-10-29T08:07:08Z"},{"number":7649,"title":"[Proposal] HarnessGuardMiddleware: Pre-write syntax validation, error diagnosis, and anti-doom-loop guard","comments":0,"category":"Ideas","created_at":"2026-10-28T06:41:49Z"},{"number":7592,"title":"[Proposal] Optional lead/subagent scope for config-declared middlewares","comments":0,"category":"Ideas","created_at":"2026-10-26T23:55:13Z"}],"latest_release":{"name":"DeerFlow 2.2.0","tag":"v2.2.0","published_at":"2026-11-04T12:56:57Z","body":"# DeerFlow 2.2.0\r\n\r\nDeerFlow 2.2 turns the 2.1 super-agent harness into a deployment-grade platform\r\nwith a focus on **operating at scale and delegating with trust**: scheduled\r\ntasks grow into goal-driven workflows with fair multi-owner execution, every\r\nsubsystem from IM channels to workflows runs across multiple Gateway\r\ninstances, the extension platform ships full-stack plugins, knowledge\r\nretrieval becomes provider-independent with verifiable citations, and models,\r\nmemory and channels gain production-grade management — hardened by fail-closed\r\ndefaults, at-rest credential encryption, and a much stricter uploads and paths\r\nlayer.\r\n\r\nThis release closes the [2.2.0 milestone](https://github.com/bytedance/deer-flow/milestone/3)\r\nwith **1068 merged PRs** since the 2.1.0 release.\r\n\r\n> 📖 Full notes: [CHANGELOG.md](../CHANGELOG.md) · [中文版](../CHANGELOG_zh.md)\r\n\r\n---\r\n\r\n## ⚠️ Breaking changes\r\n\r\n- **Local dev binds loopback** — `make dev` / `make start` no longer listen on\r\n  all interfaces; ports 2026/8001/3000 and `/setup` stay off LAN/VPN. Set\r\n  `BIND_HOST=0.0.0.0` in `.env` to expose the stack, and note that values\r\n  nginx would misread (`0`, `1.2.3`, bracketed IPv6) are now rejected before\r\n  any service stops. ([#6587], [#6635])\r\n- **Stored credentials are encrypted at rest** — a new env-only\r\n  `DEER_FLOW_CREDENTIALS_KEY` (Fernet, comma-separated for rotation) protects\r\n  IM channel credentials and MCP OAuth refresh tokens; multi-instance\r\n  deployments with `channel_connections` or refresh-token OAuth refuse to\r\n  start without it. IM bot credentials move from plaintext\r\n  `channels/runtime-config.json` into the shared `channel_runtime_configs`\r\n  table — existing bots are imported once on first start, and a downgrade must\r\n  re-enter UI-configured bots. ([#6611], [#7207], [#6988])\r\n- **The multi-process gate is stricter** — `GATEWAY_WORKERS > 1` (or\r\n  `deployment.multi_instance: true`, or `WEB_CONCURRENCY`) now requires the\r\n  Redis stream bridge; the memory bridge no longer starts multi-process. The\r\n  new `channels.leader_lease` section must stay enabled when a non-GitHub IM\r\n  channel is configured. ([#6328], [#6746], [#6252])\r\n- **Scheduler contracts change** — `/api/scheduled-tasks*` errors return a\r\n  structured `{\"detail\": {\"code\", \"message\", \"params\"}}` envelope (read\r\n  `detail.message`); a new `scheduler.max_concurrent_runs_per_user` (default\r\n  2) caps one owner's concurrent scheduled runs; IM notices are honest,\r\n  localized, and sent at most once per occurrence; DST-skipped `once` wall\r\n  times are rejected with 422. ([#6378], [#6393], [#7281])\r\n- **Thread deletion cascades** — deleting a thread now also removes its runs,\r\n  run events and feedback, so deleted threads can no longer be read or\r\n  inherited by recreated thread ids. ([#5535])\r\n- **Model-bound history stays append-only** — superseded `write_file` payload\r\n  elision becomes opt-in (`tool_output.elide_superseded_writes`, default\r\n  false) because elision rewrote earlier request segments and invalidated\r\n  provider prompt caches; skill `allowed-tools` is compatibility metadata only\r\n  and no longer hides or blocks tools. ([#7319], [#7455], [#6935])\r\n- **Tool authorization covers middleware tools** — plan-mode `write_todos` and\r\n  extension middleware tools now pass Layer-1 authorization like any other\r\n  tool; deployments with an explicit `tools` policy that omitted them stop\r\n  binding them. ([#6105])\r\n- **Fail-closed security defaults** — delegated `web_fetch`/`web_capture`\r\n  backends (Browserless, Crawl4AI, Firecrawl, fastCRW) screen their base URL\r\n  and refuse loopback/private defaults until confirmed; the SSRF guard refuses\r\n  the CGNAT range `100.64.0.0/10` (tailnets need\r\n  `allow_private_addresses: true`); IM `allowed_users` parse fail-closed on\r\n  Slack, DingTalk, QQ and Telegram (an invalid list now denies everyone\r\n  instead of silently allowing); external `system`/`developer` messages are\r\n  rejected with 400; permission checks now"},"readme":true,"readme_zh":true,"news":[{"title":"Has Anyone Tried Deerflow?","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=47546059","source":"Hacker News","lang":"en","date":"2026-03-27","points":4,"comments":0},{"title":"DeerFlow, a community-driven Deep Research framework","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=43960205","source":"Hacker News","lang":"en","date":"2025-05-12","points":4,"comments":0},{"title":"Deer-Flow Installing Line","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=47573623","source":"Hacker News","lang":"en","date":"2026-03-30","points":3,"comments":1},{"title":"Deep Exploration and Efficient Research Flow","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=47400727","source":"Hacker News","lang":"en","date":"2026-03-16","points":2,"comments":0},{"title":"DeerFlow 2.0: open-source SuperAgent harness that researches, codes, creates","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=47383760","source":"Hacker News","lang":"en","date":"2026-03-15","points":2,"comments":0},{"title":"DeerFlow: Deep Research Framework","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=43972305","source":"Hacker News","lang":"en","date":"2025-05-13","points":2,"comments":0},{"title":"DeerFlow 2.0 – Deep Exploration and Efficient Research Flow","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=48176077","source":"Hacker News","lang":"en","date":"2026-05-18","points":1,"comments":0},{"title":"An open-source long-horizon SuperAgent harness that researches,codes and creates","url":"https://github.com/bytedance/deer-flow","hn":"https://news.ycombinator.com/item?id=47814576","source":"Hacker News","lang":"en","date":"2026-04-18","points":1,"comments":1},{"title":"ByteDance Open-Sources Deer-Flow 2.0, Tops GitHub Trending","url":"https://pandaily.com/byte-dance-open-sources-deer-flow-2-0-tops-git-hub-trending","source":"pandaily","lang":"en","date":"2026-03-22"},{"title":"ByteDance's AI Agent Infrastructure 'DeerFlow 2.0' is Amazing—What I Learned by Researching and Trying It Out","url":"https://note.com/bright_jacana710/n/nf022e31b543a?hl=en","source":"note","lang":"en","date":"2026-03-22"},{"title":"ByteDance의 AI 에이전트 기반 'DeerFlow 2.0'이 대단하다——조사하고 직접 써보며 알게 된 점","url":"https://note.com/bright_jacana710/n/nf022e31b543a?hl=ko","source":"note","lang":"en","date":"2026-03-22"},{"title":"【GitHub项目推荐--DeerFlow：社区驱动的深度研究框架完全指南】","url":"https://blog.csdn.net/j8267643/article/details/151863781","source":"blog.csdn","lang":"zh","date":"2025-09-19"},{"title":"DeerFlow：手把手教你把字节开源的GitHub深度研究项目部署到本地","url":"https://www.53ai.com/news/OpenSourceLLM/2025052380653.html","source":"53ai","lang":"zh","date":"2025-05-22"},{"title":"GitHub - bytedance/deer-flow: DeerFlow is a community-driven framework for deep research, combining language models with tools like web search, crawling, and Python execution ...","url":"https://x.com/hereticreader/status/1922179992357859378","source":"x","lang":"en","date":"2025-05-12"},{"title":"10 Open-Source AI Agent Frameworks to Automate Your Work in 2026","url":"https://news.google.com/rss/articles/CBMiigFBVV95cUxQcVZOWXZ0RW5Kd3dGTXZDNkxlNy1lNWJVWGhadzZ3TVBaTTdZNktmWTF2WTEzT09SNWVjQXFINEZCN1hmYVpEdDF0WnVPckFwSzdaRTJJN3N2VWtXYkpHMzUxRlJSalFmOHk3NlF2alY2elg5V2tidkoxSEo0MF9ZUTM3SUc0LUIxbUE?oc=5","source":"Pasquale Pillitteri","lang":"en","date":"2026-04-27"},{"title":"2026年自动化工作的10个开源AI智能体框架","url":"https://news.google.com/rss/articles/CBMiggFBVV95cUxQU01DNG10dXRkenlQaWRvLVdJdGpWZHY1OHRxWk9mUTNXaUFjUDVnVENnbU5KVXBRc2NZZklSNXhNNFRWWUhLaFpMOEwtNDlRNVotLVR1TWdBdXV1a0RQSy1ucFczQWQyQkpYdTVPempVeGJLWXM5TUFNcWxGWmI3T1Nn?oc=5","source":"Pasquale Pillitteri","lang":"zh","date":"2026-04-26"},{"title":"字节版龙虾架构火爆GitHub！开源获35k+ Star，内置Skill全家桶，原生适配飞书","url":"https://news.google.com/rss/articles/CBMiSEFVX3lxTFBqMzdsb2NheUNoY2xSa0huTHNyamRGdjZHQXFOWktrRnVCdFFEdEF1Q2o5YmVlNHJ2UTJRQ3ZBMjA4T2ZNSHZ0cg?oc=5","source":"智源社区","lang":"zh","date":"2026-03-24"},{"title":"Deer-Flow Deep Dive: Managing Long-Running Autonomous Tasks","url":"https://news.google.com/rss/articles/CBMiiwFBVV95cUxPSGJXU1gzLUprbXEycnFVcmJGYk40RUIzaHBpVW1CcmJHMWxlUzFoN2xkSG1yWkJlWkZXNUpSX3Jka2FHTDBYUV9NczZmOU5vZ2M3UFN0YlF5YkdCVERuSWt4RkIzUWtaNEFuWHJabUtKY0hfd3Z1YWE5VnBOb3A1RXgwdklsTXZ4MTJF?oc=5","source":"SitePoint","lang":"en","date":"2026-03-02"},{"title":"从AI Agent到Agentic AI：开源如何助力开发者解决行业痛点？","url":"https://news.google.com/rss/articles/CBMiXkFVX3lxTE1VVzg3MTdUSVFFekxpVFZSQVdsYTJ2ZHRrS0lnWk1ZWFZTSEFQby1EMGp4UlN3R1QtTUNfb0xGRktKRHRiYVNFamZwNlFhSXlVZldneGVUcHRxZl9CMGc?oc=5","source":"InfoQ.cn","lang":"zh","date":"2025-06-25"},{"title":"字节DeerFlow深度解析：下一代AI研究助理，还是又一个Agent框架？","url":"https://news.google.com/rss/articles/CBMicEFVX3lxTE5LS3BDM1ZSSHhINkgxdG1IaE5VcnVPaUVCY2swM2ZIbmF6a1IxZUJ5QWZHQzZVeXBPWDUzbUhlZDN3WEEyb29qbm9YN1J1bWdPMWR3NVY0aXYyWG9JMGJSbFN6MGpVV0xvbXZUcEpZWE4?oc=5","source":"53AI","lang":"zh","date":"2025-06-15"},{"title":"The Sequence Engineering #661: Create Your Own Deep Research Agent with DeerFlow","url":"https://news.google.com/rss/articles/CBMiekFVX3lxTFB0aE5UVXRDSkdzSjB1M3REZGtESThTcjNfMUNuWU9XT0VuOUV1WmVQM05mYmhNdjB2aERfYlVTMlVkN0lFdUZlTXRsZGVHX2tNbHNSeVRnNllvdXVidWxoTlgxNnpEcXBzdDhHT2dtYTlUcURrX2xpajRB?oc=5","source":"TheSequence | Jesus Rodriguez","lang":"en","date":"2025-06-11"},{"title":"字节跳动 Deep Research 项目正式开源：基于 LangStack，支持 MCP 无缝集成","url":"https://news.google.com/rss/articles/CBMiXkFVX3lxTE92SzVnaEk2M2xFRjBTVzBvWmRGVTRGTlY1RFRKb0NPWmJpYThEZ0FYbjl6M3V1THprblFiMDg0alg5LWZ1WmN0S09BNE1sVENwN1F4LUl2bDhaN0diN3c?oc=5","source":"InfoQ.cn","lang":"zh","date":"2025-05-16"}],"stale":false,"snapshot_at":"2026-11-10T09:35:25Z","history_start":"2026-09-06"}