--- title: "hello-agents vs statewave" type: "comparison" canonical_url: "https://www.graphcanon.com/compare/datawhalechina-hello-agents-vs-smaramwbc-statewave" tools: ["datawhalechina-hello-agents", "smaramwbc-statewave"] --- # hello-agents vs statewave *GraphCanon updated Jul 11, 2026* ## Verdict Pick hello-agents when license: hello-agents is Other, statewave is Apache-2.0; pick statewave when license: statewave is Apache-2.0, hello-agents is Other. [hello-agents](https://hello-agents.datawhale.cc) reports 65k GitHub stars, 8.1k forks, and 144 open issues, last pushed Jul 10, 2026. [statewave](https://statewave.ai) has 252 stars, 11 forks, and 1 open issues, last pushed Jul 9, 2026. Figures are from public GitHub metadata via [hello-agents's repository](https://github.com/datawhalechina/hello-agents) and [statewave's repository](https://github.com/smaramwbc/statewave). | | [hello-agents](/tools/datawhalechina-hello-agents.md) | [statewave](/tools/smaramwbc-statewave.md) | | --- | --- | --- | | Tagline | Course on building intelligent agents from scratch | Open-source memory runtime for AI agents — reproducible, provenance-tagged context bundles instead of query-time retrieval. Apache-2.0, self-hosted on Postgres + pgvector, Python + TypeScript SDKs. | | Stars | 65,432 | 252 | | Forks | 8,109 | 11 | | Open issues | 144 | 1 | | Language | Python | Python | | 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. | Apache-2.0 | | Categories | LLM Frameworks, AI Agents | AI Agents, Vector Databases, LLM Frameworks | ## Trust and health _Sourced signals - not a safety guarantee. No winner column._ | | [hello-agents](/tools/datawhalechina-hello-agents.md) | [statewave](/tools/smaramwbc-statewave.md) | | --- | --- | --- | | Days since push | 0d | 2d | | Open issues (now) | 144 | 1 | | Owner type | Organization | User | | Full report | [trust report](/tools/datawhalechina-hello-agents/trust.md) | [trust report](/tools/smaramwbc-statewave/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… - License: hello-agents is Other, statewave is Apache-2.0. - Requirements: Min 4 GB RAM; Python knowledge assumed. - Tags unique to hello-agents: 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 statewave if… - License: statewave is Apache-2.0, hello-agents is Other. - Tags unique to statewave: memory, postgres, python, provenance. - Also covers Vector Databases. - statewave ships Docker support for self-hosted deployment. ## 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 statewave - AI Agents: Don't use an agent loop when a deterministic workflow would do; agents add latency, cost, and non-determinism. - Vector Databases: Don't reach for a dedicated vector DB under ~100k vectors; pgvector on your existing Postgres is simpler to operate. - LLM Frameworks: Avoid a framework for a single prompt-and-retrieve call; the abstraction can cost more than it saves. ## Common questions ### What is the difference between hello-agents and statewave? hello-agents: Course on building intelligent agents from scratch. statewave: Open-source memory runtime for AI agents — reproducible, provenance-tagged context bundles instead of query-time retrieval. Apache-2.0, self-hosted on Postgres + pgvector, Python + TypeScript SDKs.. See the comparison table for live GitHub stats and shared categories. ### When should I choose hello-agents over statewave? Choose hello-agents over statewave when License: hello-agents is Other, statewave is Apache-2.0; Requirements: Min 4 GB RAM; Python knowledge assumed; Tags unique to hello-agents: 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 statewave over hello-agents? Choose statewave over hello-agents when License: statewave is Apache-2.0, hello-agents is Other; Tags unique to statewave: memory, postgres, python, provenance; Also covers Vector Databases; statewave ships Docker support for self-hosted deployment. ### 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 statewave? AI Agents: Don't use an agent loop when a deterministic workflow would do; agents add latency, cost, and non-determinism. Vector Databases: Don't reach for a dedicated vector DB under ~100k vectors; pgvector on your existing Postgres is simpler to operate. LLM Frameworks: Avoid a framework for a single prompt-and-retrieve call; the abstraction can cost more than it saves. ### Is hello-agents or statewave more popular on GitHub? hello-agents has more GitHub stars (65,432 vs 252). Stars measure visibility, not whether either tool fits your constraints. ### Are hello-agents and statewave open source? Yes - both are open-source projects on GitHub (hello-agents: Other, statewave: Apache-2.0). ### Where can I find alternatives to hello-agents or statewave? GraphCanon lists graph-backed alternatives at [hello-agents alternatives](/tools/datawhalechina-hello-agents/alternatives) and [statewave alternatives](/tools/smaramwbc-statewave/alternatives) ([hello-agents markdown twin](/tools/datawhalechina-hello-agents/alternatives.md), [statewave markdown twin](/tools/smaramwbc-statewave/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-smaramwbc-statewave.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers. ### Which is better maintained, hello-agents or statewave? hello-agents: Very active. statewave: 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 statewave? GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [hello-agents trust report](/tools/datawhalechina-hello-agents/trust); [statewave trust report](/tools/smaramwbc-statewave/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/_