datawhalechina/hello-agents
📚 《从零开始构建智能体》——从零开始的智能体原理与实践教程
How hello-agents is put together
datawhalechina/hello-agents is a Chinese-language educational monorepo for the HelloAgents LLM-agent framework, combining book chapters (Extra-Chapter/, Additional-Chapter/) with a large collection of community 'Co-creation-projects' — each an independent mini agent application (database Q&A, stock analysis, data analysis, recipe, GPS, learning agents, etc.). Each co-creation project is self-contained with its own README, requirements.txt, and entry point (main.py or main.ipynb), typically built on the hello-agents PyPI package (HelloAgentsLLM, SimpleAgent, ReAct/PlanSolve/Reflection agents) plus OpenAI-compatible LLM APIs configured via .env. The primary language is Python; interfaces range from CLI REPLs and Jupyter notebooks to Gradio and FastAPI web apps. Data flow is generally: user query -> agent loop (ReAct/planning/reflection) -> tool calls (DB queries, akshare market data, file/data processing) -> LLM synthesis -> printed/saved report.
Languages
Frameworks
Datastores
Infrastructure
Major components
Book & chapter content (Extra-Chapter/, Additional-Chapter/)
Markdown teaching material covering context engineering, Dify, GUI/Web agents, skills, environment setup, and N8N/Node.js install guides.
Co-creation-projects collection
Dozens of independently authored student/community agent projects, each with its own README, requirements.txt, and entry point.
DatabaseAgent (939147533-DatabaseAgent)
ReAct-style agent that translates natural-language questions into Oracle SQL queries using DatabaseConfig validated from env vars.
InnoCoreAI (Apricity-InnocoreAI)
FastAPI multi-agent research-assistant platform with auth/papers/tasks/analysis/writing routers, SQLAlchemy models, and an AgentController lifecycle.
StockInsightAgent (CC1227871-StockInsightAgent)
Stock analysis assistant offering framework and hand-written ReAct/PlanSolve/Reflection modes, watchlist memory, RAG knowledge import, Gradio UI and CLI.
DataAnalysisAgent projects (1zrj-, alexrunner-)
Notebook/script pipelines that plan analysis tasks, run data-cleaning/statistics tools, generate ECharts HTML visualizations and Markdown reports.
Smart-Recipe-Agent (AstrumPush)
Recipe/diet-recommendation agent built on hello-agents with protocol tools and basic function tests.
GPSAgent (BitSecret) and LearningAgent (Yixiang-Wu)
Smaller single-purpose agents: a matplotlib/numpy/sympy-based GPS agent delivered as a notebook, and a CLI REPL learning agent.
A quiet week focused on final cleanup of the neuro-symbolic chapter.
5 weeksWeek of 2026-08-17
Week of 2026-08-17latest
A quiet week focused on final cleanup of the neuro-symbolic chapter.
Week of 2026-08-10
Documentation fixes from code review were batched in, alongside a neuro-symbolic alignment fix and an environment-loading bug fix.
Week of 2026-08-03
A busy week combining reviewed documentation fixes with several new community graduation projects.
Week of 2026-07-27
Three new graduation projects landed along with assorted bug fixes and a figure caption correction.
Week of 2026-07-20
A single notable addition: a smart paper-assistant graduation project.
Over the past five weeks, the hello-agents project has been steadily polishing its educational content while welcoming a wave of community-contributed graduation projects. Early weeks focused on adding new student-built agents like a paper assistant and movie recommender, then attention shifted to fixing reviewed documentation issues and aligning explanations with their figures. The most recent weeks wrapped up with smaller corrections, including a fix to the neuro-symbolic chapter's explanation order and updated statistics.
Week by week
2026-08-17A quiet week focused on final cleanup of the neuro-symbolic chapter.latest2 changes
Fix
Neuro-symbolic section ordering corrected
A merged pull request fixed the order of the neuro-symbolic explanation so it matches its accompanying figure.
Chore
Project stats refreshed
The repository's tracked statistics were updated to reflect recent activity.
2026-08-10Documentation fixes from code review were batched in, alongside a neuro-symbolic alignment fix and an environment-loading bug fix.3 changes
Fix
Neuro-symbolic explanation aligned with figure
The written explanation in the neuro-symbolic chapter was adjusted so it matches what the figure actually shows.
Fix
Batch of reviewed issues resolved
Roughly a hundred flagged documentation issues (numbered 642 through 745) were addressed in one combined update.
Fix
AI Town environment loading repaired
A community contribution fixed a problem where the AI Town example failed to load its environment properly.
2026-08-03A busy week combining reviewed documentation fixes with several new community graduation projects.6 changes
Docs
Reviewed documentation issues fixed
A batch of documentation problems identified during review were corrected across the materials.
Feature
MeetingActionAgent graduation project added
A new student capstone project that helps capture and act on meeting action items was added to the collection.
Feature
Movie recommender graduation project added
A pre-release (yingqian) movie recommendation agent built as a graduation project joined the repo.
Docs
GRPO learning-rate warning added
Chapter 11 now includes notes explaining how too high a learning rate can cause the GRPO training method to collapse.
Refactor
Memory tool naming standardized
Calls to the memory tool were renamed from 'execute' to 'run' for consistency.
Chore
Star history image and citation updated
The repository's star-growth chart image and its citation information were refreshed.
2026-07-27Three new graduation projects landed along with assorted bug fixes and a figure caption correction.5 changes
Feature
Movie recommender graduation project added
The yingqian movie recommendation agent was introduced as a student capstone project.
Feature
RequirementClarifierAgent graduation project added
A new capstone agent that helps clarify project requirements was contributed by the community.
Feature
GPSAgent graduation project added
BitSecret contributed a GPS-based agent as another graduation design project.
Fix
General bug fixes
Several small bugs found during development were patched.
Docs
GAIA figure caption corrected
The caption for a figure in the GAIA-related material was fixed for accuracy.
2026-07-20A single notable addition: a smart paper-assistant graduation project.1 change
Feature
Smart paper assistant graduation project added
An intelligent research-paper helper agent was added as a new student capstone project.
Dependencies and code review
Dependency advisories
Security Watch
No known advisories across 0 scanned dependencies.
No known advisories in the scanned dependencies.
Code review
No concrete code-level issues confirmed.
Get this report every week for your repos.
GitZoid learns each repo, reports what changed, and flags what needs attention. One flat price for the whole team.
$19 a month, flat · First 10 outputs free · No card required