DeerFlow

ByteDance’s self-hosted agent harness combines sandboxed tools, memory, skills and subagents for longer tasks.

Published by bytedancebytedance/deer-flow

Local dependenciesExecutes code

Requires local software or significant compute. Read the pinned requirements and check available memory, disk and runtime versions before setup.

Can execute code or change local files through tools, hooks or an addon. Review permissions, keep backups and test in an isolated workspace.

Open source on GitHub

.install .install-tabs{display:none}.install .install-panel[hidden]{display:block}@media (max-width:767px){.install .install-panel[hidden]{display:flex}}.install .install-panel+.install-panel{border-top:1px solid var(--line)}.install .install-panel-label{display:block}.install .install-all{display:none}

Install

Pick your client, then copy the command.

Claude Code

No Claude Code snippet verified for this entry yet

Compatibility is not confirmed, so there is no copy-ready command. Start from the pinned checkout and follow the source docs for where the folder goes.

Pinned checkout (same for every client)

git clone 'https://github.com/bytedance/deer-flow.git'
cd deer-flow && git checkout 5a563b4e99c5af3c8a1508e145bf987107a1b57f

Read pinned setup documentation

Codex

No Codex snippet verified for this entry yet

Compatibility is not confirmed, so there is no copy-ready command. Start from the pinned checkout and follow the source docs for where the folder goes.

Pinned checkout (same for every client)

git clone 'https://github.com/bytedance/deer-flow.git'
cd deer-flow && git checkout 5a563b4e99c5af3c8a1508e145bf987107a1b57f

Read pinned setup documentation Codex skills documentation

Cursor

No Cursor snippet verified for this entry yet

Compatibility is not confirmed, so there is no copy-ready command. Start from the pinned checkout and follow the source docs for where the folder goes.

Pinned checkout (same for every client)

git clone 'https://github.com/bytedance/deer-flow.git'
cd deer-flow && git checkout 5a563b4e99c5af3c8a1508e145bf987107a1b57f

Read pinned setup documentation

Setup

Terminal; review the setup wizard and configure your model provider

git clone https://github.com/bytedance/deer-flow.git
cd deer-flow
git checkout 5a563b4e99c5af3c8a1508e145bf987107a1b57f
make setup

Git

Check out the pinned revision

git clone 'https://github.com/bytedance/deer-flow.git'
cd deer-flow && git checkout 5a563b4e99c5af3c8a1508e145bf987107a1b57f

Any agent

Paste into your agent chat

Read the source at https://github.com/bytedance/deer-flow/blob/5a563b4e99c5af3c8a1508e145bf987107a1b57f/README.md (pinned revision 5a563b4e99c5). Explain what it does and which tools, credentials and network access it needs. Do not install or run anything until I confirm.

All client instructions (works without JavaScript)

Claude Code

No dedicated setup snippet verified for this client. Review the shared setup and pinned source below; compatibility is not confirmed.

Read pinned source

Codex

No dedicated setup snippet verified for this client. Review the shared setup and pinned source below; compatibility is not confirmed.

Read pinned source

Cursor

No dedicated setup snippet verified for this client. Review the shared setup and pinned source below; compatibility is not confirmed.

Read pinned source

Setup

Terminal; review the setup wizard and configure your model provider

git clone https://github.com/bytedance/deer-flow.git
cd deer-flow
git checkout 5a563b4e99c5af3c8a1508e145bf987107a1b57f
make setup

Git

Check out the pinned revision

git clone 'https://github.com/bytedance/deer-flow.git'
cd deer-flow && git checkout 5a563b4e99c5af3c8a1508e145bf987107a1b57f

Any agent

Paste into your agent chat

Read the source at https://github.com/bytedance/deer-flow/blob/5a563b4e99c5af3c8a1508e145bf987107a1b57f/README.md (pinned revision 5a563b4e99c5). Explain what it does and which tools, credentials and network access it needs. Do not install or run anything until I confirm.

Listed ≠ audited. Snippets follow the pinned source docs; review the source and any scripts before running them. Nothing is installed from this page.

Source record

Repository: bytedance/deer-flow
Source file: README.md
Pinned revision: 5a563b4
Upstream commit: 24 Oct 2026
Last checked: 24 Oct 2026
Stars at check: 84349 (2026-10-24)
Repository created: 2025-05-07
Default branch: main
License: MIT

No review scores. No automatic installs. Not affiliated with the publisher.

What you are opening

ByteDance’s self-hosted agent harness combines sandboxed tools, memory, skills and subagents for longer tasks.

How to set it up

Read the pinned README, license and companion scripts.
Choose a documented setup below; review dependencies and any configuration changes before running it.
Try one small task in a test workspace and review the result.

Requirements and third-party terms

A configured model provider and substantial local resources. The README recommends at least 4 vCPU, 8 GB RAM and 20 GB SSD for local evaluation; review sandbox and outbound-network settings.

Before you add it

Read the instructions and review any scripts before running them.
Check tool access, required credentials and third-party network requests.
The source license and any resource-specific terms take precedence.

What you are opening

How to set it up

Requirements and third-party terms

Before you add it

Other agents