hello-agents

Chinese-language course on building LLM agents from scratch

Documentation ↗ Website ↗ Repository on GitHub ↗

Stars: 82.9k
License: custom license
Last commit: Oct 2026
Last release: Jul 2026
Language: Python

Checked 13 Oct 2026 on GitHub.

Overview

A 16-chapter Chinese tutorial from Datawhale covering agent fundamentals, ReAct, Plan-and-Solve and Reflection, low-code platforms (Coze, Dify, n8n) and frameworks (AutoGen, AgentScope, LangGraph). Later chapters build a custom framework on the OpenAI API and cover memory, RAG, context engineering, MCP/A2A/ANP, Agentic-RL (SFT to GRPO) and evaluation. Chapter code is in the repo's code folder.

Who it is for: Python developers and students learning to build LLM agents, Chinese readers

Strengths

16 chapters from theory to capstone, with runnable code in the code folder
Includes an Agentic-RL chapter going from SFT to GRPO training
Builds a custom agent framework on the OpenAI API, not only framework usage
Free online reading and PDF download, plus extra chapters on interviews and skills

Weaknesses

Written in Chinese; an English README is linked separately
License is CC BY-NC-SA 4.0, which bars commercial use
Assumes basic Python and experience calling an LLM API
Hardware and model requirements for the exercises are unknown

What it needs

Needs OpenAI-compatible LLM API
Models: OpenAI API

Head to head

Also in Learning and cookbooks

See all 8

Also in Learning and cookbooks
Rank	Project	Score
1	generative-ai-for-beginners21-lesson course on building generative AI apps in Python and TypeScript121.3k starsMIT	80 out of 100
2	ai-engineering-from-scratchHands-on curriculum for building AI systems from math to agents68.4k starsMIT	75 out of 100
3	llms-from-scratchCode for the book on building a GPT-style LLM in PyTorch106.5k starscustom license	74 out of 100
#5	ai-agents-for-beginners18-lesson course on building AI agents with Microsoft Agent Framework77.1k starsMIT	70 out of 100
#6	openai-cookbookExample notebooks and guides for building with the OpenAI API76.6k starsMIT	65 out of 100

How to choose

Check the date: guides older than a year often use APIs that changed.
Prefer material with runnable notebooks or repos over slides.
Pick by level: curricula start from zero, cookbooks assume you already build.

Health

Releases: 3 in the last 12 monthsLast one 88 days ago
Top contributor: 45% of commits206 of 459 in the last 12 months
Security advisories: NoneOn GitHub, in the last 12 months
OpenSSF Scorecard: Not checked

Read from GitHub, deps.dev and OpenSSF on 13 Oct 2026. Bots and coding-agent accounts are left out of the commit counts. Not part of the score: how we check.

License in plain words

custom license Custom terms

Use it at work: Check
Change it and rebrand it: Check
Sell it or host it for others: Check

Your part: GitHub could not match these terms to a standard license. Read the license before you use it at work, rebrand it or host it for others.

A plain summary, not legal advice. Read the license on GitHub ↗ (opens in a new tab)

For maintainers

Show this rank in your README. It updates twice a day.

[![Archestack](https://archestack.com/badge/datawhalechina/hello-agents.svg)](https://archestack.com/best-of-ai/projects/hello-agents/)

How badges work

On your site or blog

A card with the rank, score and signals, in light or dark to match the reader.

<iframe src="https://archestack.com/embed/best-of-ai/hello-agents/" title="hello-agents on Archestack" width="400" height="270" style="border:0;max-width:100%" loading="lazy"></iframe>

Preview the card

Best of Open-Source AI on GitHub

Each review comes from the project's README and facts we check on GitHub. The fix form opens with hello-agents filled in.