---
title: "hello-agents vs pdf-reader-mcp"
type: "comparison"
canonical_url: "https://www.graphcanon.com/compare/datawhalechina-hello-agents-vs-sylphxai-pdf-reader-mcp"
tools: ["datawhalechina-hello-agents", "sylphxai-pdf-reader-mcp"]
---

# hello-agents vs pdf-reader-mcp

*GraphCanon updated Jul 11, 2026*

## Verdict

Pick hello-agents when hello-agents is primarily Python; pdf-reader-mcp is TypeScript; pick pdf-reader-mcp when pdf-reader-mcp is primarily TypeScript; hello-agents is Python.

[hello-agents](https://hello-agents.datawhale.cc) reports 65k GitHub stars, 8.1k forks, and 144 open issues, last pushed Jul 10, 2026. [pdf-reader-mcp](https://sylphxai.github.io/pdf-reader-mcp/) has 815 stars, 70 forks, and 9 open issues, last pushed Jul 10, 2026. Figures are from public GitHub metadata via [hello-agents's repository](https://github.com/datawhalechina/hello-agents) and [pdf-reader-mcp's repository](https://github.com/SylphxAI/pdf-reader-mcp).

| | [hello-agents](/tools/datawhalechina-hello-agents.md) | [pdf-reader-mcp](/tools/sylphxai-pdf-reader-mcp.md) |
| --- | --- | --- |
| Tagline | Course on building intelligent agents from scratch | 📄 The PDF intelligence layer for AI agents — Agent Document Twin, evidence-first extraction, visual crops, OCR provenance, trust reports, and benchmark-gated releases. MCP server for Claude, Cursor,  |
| Stars | 65,432 | 815 |
| Forks | 8,109 | 70 |
| Open issues | 144 | 9 |
| Language | Python | TypeScript |
| Adopt for | hello-agents is a comprehensive guide and hands-on tutorial for developing AI agents using LLMs (Large Language Models) and RAG methods. | - |
| Persona | - | - |
| Runtime | - | - |
| License | hello-agents is covered under an unconventional license which may require further review before usage. | MIT |
| Categories | LLM Frameworks, AI Agents | LLM Frameworks, AI Agents, Computer Vision |

## Trust and health

_Sourced signals - not a safety guarantee. No winner column._

| | [hello-agents](/tools/datawhalechina-hello-agents.md) | [pdf-reader-mcp](/tools/sylphxai-pdf-reader-mcp.md) |
| --- | --- | --- |
| Open issues (now) | 144 | 9 |
| Security scan | No lockfile | No MCP manifest |
| Full report | [trust report](/tools/datawhalechina-hello-agents/trust.md) | [trust report](/tools/sylphxai-pdf-reader-mcp/trust.md) |

## Decision facts: hello-agents

- **Requirements:** Min 4 GB RAM; Python knowledge assumed
- **Adopt for:** hello-agents is a comprehensive guide and hands-on tutorial for developing AI agents using LLMs (Large Language Models) and RAG methods.
- **License detail:** hello-agents is covered under an unconventional license which may require further review before usage.

## Choose when

### Choose hello-agents if…

- hello-agents is primarily Python; pdf-reader-mcp is TypeScript.
- License: hello-agents is Other, pdf-reader-mcp is MIT.
- Requirements: Min 4 GB RAM; Python knowledge assumed.
- Tags unique to hello-agents: llm, rag, tutorial, agent.
- You should use hello-agents if you are interested in practical, step-by-step instructions on building intelligent agents from the ground up.

### Choose pdf-reader-mcp if…

- pdf-reader-mcp is primarily TypeScript; hello-agents is Python.
- License: pdf-reader-mcp is MIT, hello-agents is Other.
- Tags unique to pdf-reader-mcp: llm-tool, document-processing, agent-document-twin, evidence-first.
- Also covers Computer Vision.

## When NOT to use hello-agents

- Avoid using hello-agents if you are looking for a quick, superficial introduction to AI agents; this tool focuses heavily on in-depth learning and practical application.
- Do not opt for hello-agents if you want a more general AI development resource; unlike some competitors, it has a narrower focus specifically on agent creation with advanced methods like LLMs and RAG.

## When NOT to use pdf-reader-mcp

- LLM Frameworks: Avoid a framework for a single prompt-and-retrieve call; the abstraction can cost more than it saves.
- AI Agents: Don't use an agent loop when a deterministic workflow would do; agents add latency, cost, and non-determinism.

## Common questions

### What is the difference between hello-agents and pdf-reader-mcp?

hello-agents: Course on building intelligent agents from scratch. pdf-reader-mcp: 📄 The PDF intelligence layer for AI agents — Agent Document Twin, evidence-first extraction, visual crops, OCR provenance, trust reports, and benchmark-gated releases. MCP server for Claude, Cursor, . See the comparison table for live GitHub stats and shared categories.

### When should I choose hello-agents over pdf-reader-mcp?

Choose hello-agents over pdf-reader-mcp when hello-agents is primarily Python; pdf-reader-mcp is TypeScript; License: hello-agents is Other, pdf-reader-mcp is MIT; Requirements: Min 4 GB RAM; Python knowledge assumed; Tags unique to hello-agents: llm, rag, tutorial, agent; You should use hello-agents if you are interested in practical, step-by-step instructions on building intelligent agents from the ground up.

### When should I choose pdf-reader-mcp over hello-agents?

Choose pdf-reader-mcp over hello-agents when pdf-reader-mcp is primarily TypeScript; hello-agents is Python; License: pdf-reader-mcp is MIT, hello-agents is Other; Tags unique to pdf-reader-mcp: llm-tool, document-processing, agent-document-twin, evidence-first; Also covers Computer Vision.

### When should I avoid hello-agents?

Avoid using hello-agents if you are looking for a quick, superficial introduction to AI agents; this tool focuses heavily on in-depth learning and practical application. Do not opt for hello-agents if you want a more general AI development resource; unlike some competitors, it has a narrower focus specifically on agent creation with advanced methods like LLMs and RAG.

### When should I avoid pdf-reader-mcp?

LLM Frameworks: Avoid a framework for a single prompt-and-retrieve call; the abstraction can cost more than it saves. AI Agents: Don't use an agent loop when a deterministic workflow would do; agents add latency, cost, and non-determinism.

### Is hello-agents or pdf-reader-mcp more popular on GitHub?

hello-agents has more GitHub stars (65,432 vs 815). Stars measure visibility, not whether either tool fits your constraints.

### Are hello-agents and pdf-reader-mcp open source?

Yes - both are open-source projects on GitHub (hello-agents: Other, pdf-reader-mcp: MIT).

### Where can I find alternatives to hello-agents or pdf-reader-mcp?

GraphCanon lists graph-backed alternatives at [hello-agents alternatives](/tools/datawhalechina-hello-agents/alternatives) and [pdf-reader-mcp alternatives](/tools/sylphxai-pdf-reader-mcp/alternatives) ([hello-agents markdown twin](/tools/datawhalechina-hello-agents/alternatives.md), [pdf-reader-mcp markdown twin](/tools/sylphxai-pdf-reader-mcp/alternatives.md)), ranked by typed relationship edges rather than popularity votes.

### Is there a machine-readable version of this comparison?

Yes. The markdown twin at [this comparison](/compare/datawhalechina-hello-agents-vs-sylphxai-pdf-reader-mcp.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers.

### Which is better maintained, hello-agents or pdf-reader-mcp?

hello-agents: Very active. pdf-reader-mcp: Very active. Compare maintenance labels, days since push, and release cadence in the trust section below - stars alone do not measure maintenance.

### Where are the full trust reports for hello-agents and pdf-reader-mcp?

GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [hello-agents trust report](/tools/datawhalechina-hello-agents/trust); [pdf-reader-mcp trust report](/tools/sylphxai-pdf-reader-mcp/trust).

---

**Machine-readable endpoints**

- JSON: [`/api/graphcanon/graph?tool=datawhalechina-hello-agents`](/api/graphcanon/graph?tool=datawhalechina-hello-agents)
- LLM index: [/llms.txt](/llms.txt)
- Full corpus: [/llms-full.txt](/llms-full.txt)

_GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_
