Skip to content

OpenBMB/ChatDev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ChatDev 2.0 - DevAll

DevAll Logo

A Zero-Code Multi-Agent Platform for Developing Everything

ใ€English | ็ฎ€ไฝ“ไธญๆ–‡ใ€‘

ใ€๐Ÿ“š Developers | ๐Ÿ‘ฅ Contributors๏ฝœโญ๏ธ ChatDev 1.0 (Legacy)ใ€‘

๐Ÿ“– Overview

ChatDev has evolved from a specialized software development multi-agent system into a comprehensive multi-agent orchestration platform.

  • ChatDev 2.0 (DevAll) is a Zero-Code Multi-Agent Platform for "Developing Everything". It empowers users to rapidly build and execute customized multi-agent systems through simple configuration. No coding is requiredโ€”users can define agents, workflows, and tasks to orchestrate complex scenarios such as data visualization, 3D generation, and deep research.
  • ChatDev 1.0 (Legacy) operates as a Virtual Software Company. It utilizes various intelligent agents (e.g., CEO, CTO, Programmer) participating in specialized functional seminars to automate the entire software development life cycleโ€”including designing, coding, testing, and documenting. It serves as the foundational paradigm for communicative agent collaboration.

๐ŸŽ‰ News

โ€ข Jan 07, 2026: ๐Ÿš€ We are excited to announce the official release of ChatDev 2.0 (DevAll)! This version introduces a zero-code multi-agent orchestration platform. The classic ChatDev (v1.x) has been moved to the chatdev1.0 branch for maintenance. More details about ChatDev 2.0 can be found on our official post.

Old News

โ€ขSep 24, 2025: ๐ŸŽ‰ Our paper Multi-Agent Collaboration via Evolving Orchestration has been accepted to NeurIPS 2025. The implementation is available in the puppeteer branch of this repository.

โ€ขMay 26, 2025: ๐ŸŽ‰ We propose a novel puppeteer-style paradigm for multi-agent collaboration among large language model based agents. By leveraging a learnable central orchestrator optimized with reinforcement learning, our method dynamically activates and sequences agents to construct efficient, context-aware reasoning paths. This approach not only improves reasoning quality but also reduces computational costs, enabling scalable and adaptable multi-agent cooperation in complex tasks. See our paper in Multi-Agent Collaboration via Evolving Orchestration.

โ€ขJune 25, 2024: ๐ŸŽ‰To foster development in LLM-powered multi-agent collaboration๐Ÿค–๐Ÿค– and related fields, the ChatDev team has curated a collection of seminal papers๐Ÿ“„ presented in a open-source interactive e-book๐Ÿ“š format. Now you can explore the latest advancements on the Ebook Website and download the paper list.

โ€ขJune 12, 2024: We introduced Multi-Agent Collaboration Networks (MacNet) ๐ŸŽ‰, which utilize directed acyclic graphs to facilitate effective task-oriented collaboration among agents through linguistic interactions ๐Ÿค–๐Ÿค–. MacNet supports co-operation across various topologies and among more than a thousand agents without exceeding context limits. More versatile and scalable, MacNet can be considered as a more advanced version of ChatDev's chain-shaped topology. Our preprint paper is available at https://arxiv.org/abs/2406.07155. This technique has been incorporated into the macnet branch, enhancing support for diverse organizational structures and offering richer solutions beyond software development (e.g., logical reasoning, data analysis, story generation, and more).

โ€ข May 07, 2024, we introduced "Iterative Experience Refinement" (IER), a novel method where instructor and assistant agents enhance shortcut-oriented experiences to efficiently adapt to new tasks. This approach encompasses experience acquisition, utilization, propagation and elimination across a series of tasks and making the pricess shorter and efficient. Our preprint paper is available at https://arxiv.org/abs/2405.04219, and this technique will soon be incorporated into ChatDev.

โ€ข January 25, 2024: We have integrated Experiential Co-Learning Module into ChatDev. Please see the Experiential Co-Learning Guide.

โ€ข December 28, 2023: We present Experiential Co-Learning, an innovative approach where instructor and assistant agents accumulate shortcut-oriented experiences to effectively solve new tasks, reducing repetitive errors and enhancing efficiency. Check out our preprint paper at https://arxiv.org/abs/2312.17025 and this technique will soon be integrated into ChatDev.

โ€ข November 15, 2023: We launched ChatDev as a SaaS platform that enables software developers and innovative entrepreneurs to build software efficiently at a very low cost and remove the barrier to entry. Try it out at https://chatdev.modelbest.cn/.

โ€ข November 2, 2023: ChatDev is now supported with a new feature: incremental development, which allows agents to develop upon existing codes. Try --config "incremental" --path "[source_code_directory_path]" to start it.

โ€ข October 26, 2023: ChatDev is now supported with Docker for safe execution (thanks to contribution from ManindraDeMel). Please see Docker Start Guide.

โ€ข September 25, 2023: The Git mode is now available, enabling the programmer to utilize Git for version control. To enable this feature, simply set "git_management" to "True" in ChatChainConfig.json. See guide.

โ€ข September 20, 2023: The Human-Agent-Interaction mode is now available! You can get involved with the ChatDev team by playing the role of reviewer and making suggestions to the programmer ; try python3 run.py --task [description_of_your_idea] --config "Human". See guide and example.

โ€ข September 1, 2023: The Art mode is available now! You can activate the designer agent to generate images used in the software; try python3 run.py --task [description_of_your_idea] --config "Art". See guide and example.

โ€ข August 28, 2023: The system is publicly available.

โ€ข August 17, 2023: The v1.0.0 version was ready for release.

โ€ข July 30, 2023: Users can customize ChatChain, Phasea and Role settings. Additionally, both online Log mode and replay mode are now supported.

โ€ข July 16, 2023: The preprint paper associated with this project was published.

โ€ข June 30, 2023: The initial version of the ChatDev repository was released.

๐Ÿš€ Quick Start

๐Ÿ“‹ Prerequisites

  • OS: macOS / Linux / WSL / Windows
  • Python: 3.12+
  • Node.js: 18+
  • Package Manager: uv

๐Ÿ“ฆ Installation

  1. Backend Dependencies (Python managed by uv):

    uv sync
  2. Frontend Dependencies (Vite + Vue 3):

    cd frontend && npm install

โšก๏ธ Run the Application

  1. Start Backend :

    # Run from the project root
    uv run python server_main.py --port 6400 --reload
  2. Start Frontend:

    cd frontend
    VITE_API_BASE_URL=http://localhost:6400 npm run dev

    Then access the Web Console at http://localhost:5173.

๐Ÿ”‘ Configuration

  • Environment Variables: Create a .env file in the project root.
  • Model Keys: Set API_KEY and BASE_URL in .env for your LLM provider.
  • YAML placeholders: Use ${VAR}๏ผˆe.g., ${API_KEY}๏ผ‰in configuration files to reference these variables.

๐Ÿ’ก How to Use

๐Ÿ–ฅ๏ธ Web Console

The DevAll interface provides a seamless experience for both construction and execution

  • Tutorial: Comprehensive step-by-step guides and documentation integrated directly into the platform to help you get started quickly.

  • Workflow: A visual canvas to design your multi-agent systems. Configure node parameters, define context flows, and orchestrate complex agent interactions with drag-and-drop ease.

  • Launch: Initiate workflows, monitor real-time logs, inspect intermediate artifacts, and provide human-in-the-loop feedback.

๐Ÿงฐ Python SDK

For automation and batch processing, use our lightweight Python SDK to execute workflows programmatically and retrieve results directly.

from runtime.sdk import run_workflow

# Execute a workflow and get the final node message
result = run_workflow(
    yaml_file="yaml_instance/demo.yaml",
    task_prompt="Summarize the attached document in one sentence.",
    attachments=["/path/to/document.pdf"],
    variables={"API_KEY": "sk-xxxx"} # Override .env variables if needed
)

if result.final_message:
    print(f"Output: {result.final_message.text_content()}")

โš™๏ธ For Developers

For secondary development and extensions, please proceed with this section.

Extend DevAll with new nodes, providers, and tools. The project is organized into a modular structure:

  • Core Systems: server/ hosts the FastAPI backend, while runtime/ manages agent abstraction and tool execution.
  • Orchestration: workflow/ handles the multi-agent logic, driven by configurations in entity/.
  • Frontend: frontend/ contains the Vue 3 Web Console.
  • Extensibility: functions/ is the place for custom Python tools.

Relevant reference documentation:


๐ŸŒŸ Featured Workflows

We provide robust, out-of-the-box templates for common scenarios. All runnable workflow configs are located in yaml_instance/.

  • Demos: Files named demo_*.yaml showcase specific features or modules.
  • Implementations: Files named directly (e.g., ChatDev_v1.yaml) are full in-house or recreated workflows. As follows:

๐Ÿ“‹ Workflow Collection

Category Workflow Case
๐Ÿ“ˆ Data Visualization data_visualization_basic.yaml
data_visualization_enhanced.yaml

Prompt: "Create 4โ€“6 high-quality PNG charts for my large real-estate transactions dataset."
๐Ÿ› ๏ธ 3D Generation
(Requires Blender & blender-mcp)
blender_3d_builder_simple.yaml
blender_3d_builder_hub.yaml
blender_scientific_illustration.yaml

Prompt: "Please build a Christmas tree."
๐ŸŽฎ Game Dev GameDev_v1.yaml
ChatDev_v1.yaml

Prompt: "Please help me design and develop a Tank Battle game."
๐Ÿ“š Deep Research deep_research_v1.yaml
Prompt: "Research about recent advances in the field of LLM-based agent RL"
๐ŸŽ“ Teach Video teach_video.yaml
Prompt: "่ฎฒไธ€ไธ‹ไป€ไนˆๆ˜ฏๅ‡ธไผ˜ๅŒ–"

๐Ÿ’ก Usage Guide

For those implementations, you can use the Launch tab to execute them.

  1. Select: Choose a workflow in the Launch tab.
  2. Upload: Upload necessary files (e.g., .csv for data analysis) if required.
  3. Prompt: Enter your request (e.g., "Visualize the sales trends" or "Design a snake game").

๐Ÿค Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding new workflow templates, or sharing high-quality cases/artifacts produced by DevAll, your help is much appreciated. Feel free to contribute by submitting Issues or Pull Requests.

By contributing to DevAll, you'll be recognized in our Contributors list below. Check out our Developer Guide to get started!

๐Ÿ‘ฅ Contributors

Primary Contributors


NA-Wen

zxrys

swugi

huatl98

Contributors


shiowen

kilo2127

AckerlyLau

๐Ÿค Acknowledgments

ย ย  ย ย  ย ย 

๐Ÿ”Ž Citation

@article{chatdev,
    title = {ChatDev: Communicative Agents for Software Development},
    author = {Chen Qian and Wei Liu and Hongzhang Liu and Nuo Chen and Yufan Dang and Jiahao Li and Cheng Yang and Weize Chen and Yusheng Su and Xin Cong and Juyuan Xu and Dahai Li and Zhiyuan Liu and Maosong Sun},
    journal = {arXiv preprint arXiv:2307.07924},
    url = {https://arxiv.org/abs/2307.07924},
    year = {2023}
}

@article{colearning,
    title = {Experiential Co-Learning of Software-Developing Agents},
    author = {Chen Qian and Yufan Dang and Jiahao Li and Wei Liu and Zihao Xie and Yifei Wang and Weize Chen and Cheng Yang and Xin Cong and Xiaoyin Che and Zhiyuan Liu and Maosong Sun},
    journal = {arXiv preprint arXiv:2312.17025},
    url = {https://arxiv.org/abs/2312.17025},
    year = {2023}
}

@article{macnet,
    title={Scaling Large-Language-Model-based Multi-Agent Collaboration},
    author={Chen Qian and Zihao Xie and Yifei Wang and Wei Liu and Yufan Dang and Zhuoyun Du and Weize Chen and Cheng Yang and Zhiyuan Liu and Maosong Sun}
    journal={arXiv preprint arXiv:2406.07155},
    url = {https://arxiv.org/abs/2406.07155},
    year={2024}
}

@article{iagents,
    title={Autonomous Agents for Collaborative Task under Information Asymmetry},
    author={Wei Liu and Chenxi Wang and Yifei Wang and Zihao Xie and Rennai Qiu and Yufan Dnag and Zhuoyun Du and Weize Chen and Cheng Yang and Chen Qian},
    journal={arXiv preprint arXiv:2406.14928},
    url = {https://arxiv.org/abs/2406.14928},
    year={2024}
}

@article{puppeteer,
      title={Multi-Agent Collaboration via Evolving Orchestration}, 
      author={Yufan Dang and Chen Qian and Xueheng Luo and Jingru Fan and Zihao Xie and Ruijie Shi and Weize Chen and Cheng Yang and Xiaoyin Che and Ye Tian and Xuantang Xiong and Lei Han and Zhiyuan Liu and Maosong Sun},
      journal={arXiv preprint arXiv:2505.19591},
      url={https://arxiv.org/abs/2505.19591},
      year={2025}
}

๐Ÿ“ฌ Contact

If you have any questions, feedback, or would like to get in touch, please feel free to reach out to us via email at qianc62@gmail.com