deerflow2/web
Willem Jiang dac18ed551 fix(frontend): passing the MCP header and env setting to backend (#810)
This pull request adds support for custom HTTP headers to the MCP server configuration and ensures that these headers are properly validated and included when adding new MCP servers. The changes are primarily focused on extending the schema and data handling for MCP server metadata.
2026-01-09 22:52:49 +08:00
..
docs feat: add deep think feature (#311) 2025-06-14 13:12:43 +08:00
messages feat(eval): add report quality evaluation module and UI integration (#776) 2025-12-25 21:55:48 +08:00
public feat: add deep think feature (#311) 2025-06-14 13:12:43 +08:00
src fix(frontend): passing the MCP header and env setting to backend (#810) 2026-01-09 22:52:49 +08:00
tests fix(web): handle incomplete JSON in MCP tool call arguments (#528) (#727) 2025-11-29 16:38:29 +08:00
.dockerignore feat: add docker support (#104) 2025-05-13 19:53:28 +08:00
.env.example fix: make SSE buffer size configurable to prevent overflow during multi-round searches (#664) (#665) 2025-10-27 17:03:38 +08:00
.gitignore chore: merge with web UI project 2025-04-17 12:02:23 +08:00
.npmrc chore: merge with web UI project 2025-04-17 12:02:23 +08:00
Dockerfile feat: add docker support (#104) 2025-05-13 19:53:28 +08:00
README.md feat: add docker support (#104) 2025-05-13 19:53:28 +08:00
components.json chore: merge with web UI project 2025-04-17 12:02:23 +08:00
docker-compose.yml feat: add docker support (#104) 2025-05-13 19:53:28 +08:00
eslint.config.js chore: ignore `src/components/*` 2025-04-25 10:53:27 +08:00
jest.config.mjs fix: react key warnings from duplicate message IDs + establish jest testing framework (#655) 2025-10-25 20:46:43 +08:00
jest.setup.js fix: react key warnings from duplicate message IDs + establish jest testing framework (#655) 2025-10-25 20:46:43 +08:00
next.config.js feat: add i18n support and add Chinese (#372) 2025-07-12 15:18:28 +08:00
package.json build(deps): bump jspdf from 3.0.4 to 4.0.0 in /web (#798) 2026-01-06 09:07:18 +08:00
pnpm-lock.yaml build(deps): bump jspdf from 3.0.4 to 4.0.0 in /web (#798) 2026-01-06 09:07:18 +08:00
postcss.config.js chore: add license header for web 2025-04-17 14:26:41 +08:00
prettier.config.js chore: add license header for web 2025-04-17 14:26:41 +08:00
tsconfig.json fix: react key warnings from duplicate message IDs + establish jest testing framework (#655) 2025-10-25 20:46:43 +08:00

README.md

🦌 DeerFlow Web UI

License: MIT

Originated from Open Source, give back to Open Source.

This is the web UI for DeerFlow.

Quick Start

Prerequisites

  • DeerFlow
  • Node.js (v22.14.0+)
  • pnpm (v10.6.2+) as package manager

Configuration

Create a .env file in the project root and configure the following environment variables:

  • NEXT_PUBLIC_API_URL: The URL of the deer-flow API.

It's always a good idea to start with the given example file, and edit the .env file with your own values:

cp .env.example .env

How to Install

DeerFlow Web UI uses pnpm as its package manager. To install the dependencies, run:

cd web
pnpm install

How to Run in Development Mode

[!NOTE] Ensure the Python API service is running before starting the web UI.

Start the web UI development server:

cd web
pnpm dev

By default, the web UI will be available at http://localhost:3000.

You can set the NEXT_PUBLIC_API_URL environment variable if you're using a different host or location.

# .env
NEXT_PUBLIC_API_URL=http://localhost:8000/api

Docker

You can also run this project with Docker.

First, you need read the configuration below. Make sure .env file is ready.

Second, to build a Docker image of your own web server:

docker build --build-arg NEXT_PUBLIC_API_URL=YOUR_DEER-FLOW_API -t deer-flow-web .

Final, start up a docker container running the web server:

# Replace deer-flow-web-app with your preferred container name
docker run -d -t -p 3000:3000 --env-file .env --name deer-flow-web-app deer-flow-web

# stop the server
docker stop deer-flow-web-app

Docker Compose

You can also setup this project with the docker compose:

# building docker image
docker compose build

# start the server
docker compose up

License

This project is open source and available under the MIT License.

Acknowledgments

We extend our heartfelt gratitude to the open source community for their invaluable contributions. DeerFlow is built upon the foundation of these outstanding projects:

In particular, we want to express our deep appreciation for:

These outstanding projects form the backbone of DeerFlow and exemplify the transformative power of open source collaboration.