LibreAI / AI Agents / Tongyi Deep Research
// agents · Alibaba-NLP/DeepResearch

Tongyi Deep Research

Tongyi Deep Research - Alibaba's open-source deep research agent and 30B model

★ 20.0k stars⑂ 1.5k forksApache-2.0updated 2026-02
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Tongyi Deep Research is an open-source ai agents project by Alibaba-NLP (Alibaba-NLP/DeepResearch on GitHub). It has 20,022 GitHub stars and 1,532 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 27 February 2026.

GitHub stars
20,022
Forks
1,532
License
Apache-2.0
Last updated on GitHub
27 February 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Prepare your questions

    Collect the research questions you want to evaluate, in the JSONL format the repo expects.

  2. Get the model and code

    Clone the repo and download the Tongyi-DeepResearch model weights from the Model Download section.

  3. Set up the environment

    Create the conda environment, install requirements, and copy the example environment file.

  4. Run your first research task

    Configure the inference script (model path, dataset, output) and run it.

// features

Why people love it

Deep research agent

A ReAct-style agent that plans, searches and synthesizes long-form research answers.

Open model weights

Tongyi-DeepResearch-30B-A3B weights are downloadable for local inference.

Tool use

Supports tools such as retrieval, web search and a calculator, configured per run in the inference script.

Document processing

Handles file references in questions, with documented formats and organization.

Benchmark suite

Includes the deep research benchmark evaluation used by the project.

Hosted option via OpenRouter

The model is available on OpenRouter, so you can run inference with no GPUs at all.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/Alibaba-NLP/DeepResearch.git
    cd DeepResearch
  2. Set up the environment

    The README's example uses conda with Python 3.10, then installs the requirements.

    conda create -n react_infer_env python=3.10.0
    conda activate react_infer_env
    pip install -r requirements.txt
  3. Configure and run inference

    Edit run_react_infer.sh (MODEL_PATH, DATASET, OUTPUT_PATH and any tool API keys), then run it.

    # Edit run_react_infer.sh per README step 4, then run the script - see README step 5
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by Alibaba's Tongyi team (Alibaba-NLP) on GitHub.

Is it free to use?

Yes - the project is Apache-2.0 licensed; model weights are provided under the terms on their download pages.

Does it need a paid API key?

Local runs need no API key beyond any tool credentials you enable (for example a search API). The OpenRouter route requires an OpenRouter account and is pay-per-use.

How does it compare to alternatives?

Compared with hosted deep-research features in chatbots, Tongyi Deep Research gives you the open model and agent code to run, inspect and benchmark yourself.

How do I get started?

Clone the repo, create the conda env, install requirements, download the weights, configure run_react_infer.sh and run your first question file.

// keep exploring

Similar tools

AI Agents

local-deep-research

Deep research that stays on your machine — local or cloud LLMs, 10+ search engines, encrypted and private.

★ 9.2k starsMIT
View guide →
Agents

tons-of-skills-marketplace

Model-agnostic marketplace of agent skills with a harness-free canonical layer.

★ 2.8k starsMIT
View guide →
AI Agents

ESP32 iPhone Agent

ESP32 iPhone Agent — let an AI model use a real iPhone with a $7 ESP32: AirPlay eyes, USB HID hands, no computer, no jailbreak

★ 2.4k starsMIT
View guide →
AI Agents

agent-world-model

Snowflake's Agent World Model: synthesise 1,000 executable MCP tool-use environments for agentic RL.

★ 465 starsNOASSERTION
View guide →
AI Agents

page-agent

Alibaba's in-page GUI agent: control any web interface with natural language, from one script tag

★ 29.4k starsMIT
View guide →
AI Agents

LobsterAI

A desktop-grade AI agent from NetEase Youdao that does real work — analysis, slides, docs, video and research.

★ 6.1k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if Tongyi Deep Research is not the right fit.

Get Tongyi Deep Research

Free and open — grab the source, star the repo, and start creating.