selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

deer-flow logo

Self-host deer-flow

v2.2.0
ReleaseOpen SourceMIT
Updatedlast week
LanguagePython
Setup difficultyAdvanced
Stars
85 366
Ports
2026 (nginx reverse proxy entry point (configurable via PORT env var)), 8001 (Gateway API (FastAPI) internal port), 3000 (Frontend Next.js production server internal port)
Requires
Python
Install with Docker Compose

What is deer-flow?

DeerFlow is an open-source super agent harness developed by ByteDance that enables long-horizon autonomous task execution. It orchestrates sub-agents, persistent memory (DeerMem), and isolated sandbox environments with filesystem access to handle complex, multi-step tasks that can take minutes to hours. The system is built on LangGraph and LangChain, providing a web UI, terminal workbench (TUI), and embedded Python client. Key capabilities include: extensible skill system with built-in skills for research, report generation, slide creation, and media generation; MCP server integration for custom tools; agentic browser control via Playwright; scheduled tasks with cron/interval/one-time triggers; RAGFlow integration for private knowledge retrieval; multi-channel IM support (Telegram, Slack, Discord, Feishu/Lark, WeCom); and personal access tokens for API access. It can be deployed via Docker Compose (production), local development with hot-reload, or run as a standalone TUI. The default deployment binds to localhost only for security, with documented hardening steps for network exposure. Licensed under MIT.

Should you self-host deer-flow?

deer-flow scores 86/100 on selfhost.directory (how scoring works) and ranks #4 of 208 in AI Agents. It has 85 366 GitHub stars, +1 660 in the last 30 days.

It shipped 3 stable releases in the past year. The latest, v2.2.0, came out on 4 November 2026. New versions land roughly every 2 months.

Setup is advanced: plan for several services and some ongoing maintenance. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Orca (91/100, 125 495 stars). It scores higher overall, so compare the two before you pick. See deer-flow vs Orca side by side.

Features

  • Agentic Browser ControlOptional extra, requires `uv sync --extra browser` and `playwright install chromium`
  • Extensible Skill System
  • MCP Server Integration
  • Multi-Channel IM Support
  • Persistent Memory (DeerMem)
  • Personal Access Tokens
  • RAGFlow Integration
  • Sandbox Execution Environments
  • Sub-agents
  • Super Agent Harness
  • Terminal Workbench (TUI)

deer-flow README

How to install deer-flow

Install deer-flow with Docker Compose

Environment variables
BIND_HOST, PORT, BETTER_AUTH_SECRET, DEER_FLOW_INTERNAL_AUTH_TOKEN, DEER_FLOW_CREDENTIALS_KEY, LANGSMITH_TRACING, LANGSMITH_API_KEY
make docker-init # Pull sandbox image (only once or when image updates)
make docker-start # Start services (auto-detects sandbox mode from config.yaml)
make docker-logs # View logs

Production deployment with nginx, frontend, gateway, redis, optional provisioner

How to configure deer-flow

  • LANGSMITH_TRACINGfalseEnable LangSmith tracing

    values: true/false

  • LANGSMITH_API_KEYLangSmith API key when tracing enabled

    values: API key string

  • DEER_FLOW_INTERNAL_AUTH_TOKENShared internal Gateway auth token for multi-worker IM channels

    values: Random string

  • BIND_HOST127.0.0.1Host interface for nginx to bind to (default 127.0.0.1)

    values: IP address or 0.0.0.0

  • PORT2026Published port for nginx (default 2026)

    values: Port number

deer-flow releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in AI Agents

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…