RD-Agent README

The project's README from github.com/microsoft/RD-Agent. As one markdown file: README.md.

RA-Agent logo

🖥️ Live Demo | 🎥 Demo Video ▶️YouTube | 📖 Documentation | 📄 Tech Report | 📃 Papers

CI CodeQL Dependabot Updates Lint PR Title Release.yml Platform PyPI PyPI - Python Version Release GitHub pre-commit Checked with mypy Ruff Chat Documentation Status Readthedocs Preview arXiv

📰 News

🗞️ News 📝 Description
Agent² RL-Bench Preprint A benchmark for evaluating LLM agents on end-to-end post-training engineering. See the project page and code.
ICML 2026 Acceptance We are thrilled to announce that our paper FT-Dojo: Towards Autonomous LLM Fine-Tuning with Language Agents has been accepted to ICML 2026. The FT-Agent implementation is available in the LLM fine-tuning guide.
ACL 2026 Findings Acceptance We are thrilled to announce that our paper Reasoning as Gradient has been accepted to ACL 2026 Findings. Execution traces are available at Gome GPT-5 Traces
Web UI Release We release a new frontend that can be built and served by rdagent server_ui for real-time interaction and trace viewing, currently excluding the data_science scenario.
NeurIPS 2025 Acceptance We are thrilled to announce that our paper R&D-Agent-Quant has been accepted to NeurIPS 2025
Technical Report Release Overall framework description and results on MLE-bench
R&D-Agent-Quant Release Apply R&D-Agent to quant trading
MLE-Bench Results Released R&D-Agent currently leads as the top-performing machine learning engineering agent on MLE-bench
Support LiteLLM Backend We now fully support LiteLLM as our default backend for integration with multiple LLM providers.
General Data Science Agent Data Science Agent
Kaggle Scenario release We release Kaggle Agent, try the new features!
Official WeChat group release We created a WeChat group, welcome to join! (🗪QR Code)
Official Discord release We launch our first chatting channel in Discord (🗪Chat)
First release R&D-Agent is released on GitHub

🧪 Agent² RL-Bench

Project Page · Paper · Code & Quick Start · Microsoft Research

Agent² RL-Bench evaluates whether LLM agents can autonomously engineer end-to-end post-training pipelines, spanning static optimization and stateful online RL.

🏆 The Best Machine Learning Engineering Agent!

MLE-bench is a comprehensive benchmark evaluating the performance of AI agents on machine learning engineering tasks. Utilizing datasets from 75 Kaggle competitions, MLE-bench provides robust assessments of AI systems' capabilities in real-world ML engineering scenarios.

R&D-Agent currently leads as the top-performing machine learning engineering agent on MLE-bench:

Agent Low == Lite (%) Medium (%) High (%) All (%)
R&D-Agent o3(R)+GPT-4.1(D) 51.52 ± 6.9 19.3 ± 5.5 26.67 ± 0 30.22 ± 1.5
R&D-Agent o1-preview 48.18 ± 2.49 8.95 ± 2.36 18.67 ± 2.98 22.4 ± 1.1
AIDE o1-preview 34.3 ± 2.4 8.8 ± 1.1 10.0 ± 1.9 16.9 ± 1.1

Notes:

You can inspect the detailed runs of the above results online.

For running R&D-Agent on MLE-bench, refer to MLE-bench Guide: Running ML Engineering via MLE-bench

🥇 The First Data-Centric Quant Multi-Agent Framework!

R&D-Agent for Quantitative Finance, in short RD-Agent(Q), is the first data-centric, multi-agent framework designed to automate the full-stack research and development of quantitative strategies via coordinated factor-model co-optimization.

image

Extensive experiments in real stock markets show that, at a cost under $10, RD-Agent(Q) achieves approximately 2× higher ARR than benchmark factor libraries while using over 70% fewer factors. It also surpasses state-of-the-art deep time-series models under smaller resource budgets. Its alternating factor–model optimization further delivers excellent trade-off between predictive accuracy and strategy robustness.

You can learn more details about RD-Agent(Q) through the paper and reproduce it through the documentation.

Data Science Agent Preview

Check out our demo video showcasing the current progress of our Data Science Agent under development:

https://github.com/user-attachments/assets/3eccbecb-34a4-4c81-bce4-d3f8862f7305

🌟 Introduction

Our focused scenario

R&D-Agent aims to automate the most critical and valuable aspects of the industrial R&D process, and we begin with focusing on the data-driven scenarios to streamline the development of models and data. Methodologically, we have identified a framework with two key components: 'R' for proposing new ideas and 'D' for implementing them. We believe that the automatic evolution of R&D will lead to solutions of significant industrial value.

R&D is a very general scenario. The advent of R&D-Agent can be your

You can click the links above to view the demo. We're continuously adding more methods and scenarios to the project to enhance your R&D processes and boost productivity.

Additionally, you can take a closer look at the examples in our 🖥️ Live Demo.

Watch the demo

⚡ Quick start

RD-Agent currently only supports Linux.

You can try above demos by running the following command:

🐳 Docker installation.

Users must ensure Docker is installed before attempting most scenarios. Please refer to the official 🐳Docker page for installation instructions. Ensure the current user can run Docker commands without using sudo. You can verify this by executing docker run hello-world.

🐍 Create a Conda Environment

🛠️ Install the R&D-Agent

For Users

For Developers

More details can be found in the development setup.

💊 Health check

⚙️ Configuration

🚀 Run the Application

The 🖥️ Live Demo is implemented by the following commands(each item represents one demo, you can select the one you prefer):

RD-Agent (microsoft/RD-Agent)

Searching Database…

What is this?R&D-Agent is a Microsoft multi-agent framework that automates data-driven R&D: one agent proposes new research ideas and another implements them, applied to quant trading, data mining, Kaggle competitions, paper reproduction, and LLM fine-tuning.
Is this a library I import, or a standalone agent system?It is a standalone multi-agent system you run via the 'rdagent' CLI command, structured around an 'R' component that proposes ideas and a 'D' component that implements them, not a library you import into your own code.
How do I get it running?Install Docker, create a Python 3.10/3.11 conda environment, then install the package with 'pip install rdagent' (or from source for development), run the built-in health check, and launch a demo such as a Qlib factor/model loop or 'rdagent datascience --competition '.
Do I need Docker and an LLM API key before trying it?Yes: Docker must be installed and runnable without sudo for most scenarios, and you need a configured Chat/Embedding model (ChatCompletion, JSON mode, embeddings) via LiteLLM, OpenAI, Azure OpenAI, or DeepSeek's API.
Does it run on Windows or macOS?No, RD-Agent currently only supports Linux, so Windows and macOS users would need a Linux VM or WSL.
How good is RD-Agent at quant trading specifically?RD-Agent(Q) is a data-centric multi-agent framework for quant finance that, for under $10 in run cost, achieves roughly 2x the ARR of benchmark factor libraries while using over 70% fewer factors.
How does it rank on ML engineering benchmarks?R&D-Agent currently leads MLE-bench, a benchmark of 75 Kaggle-style ML engineering tasks, with its o3(R)+GPT-4.1(D) configuration scoring 30.22% overall success, ahead of the previous best agent AIDE.
Is there a web interface to watch the agent work?Yes, running 'rdagent serverui' builds and serves a frontend for real-time interaction and viewing agent execution traces, though this currently excludes the data science scenario.
Can it fine-tune LLMs by itself?Yes, the FT-Agent component performs autonomous LLM fine-tuning for benchmark-driven domain adaptation, described in the ICML 2026-accepted paper FT-Dojo.
Creator
microsoft
Size
67.7 MB
Stars
15K
Age
2y
Commits · 90 Days