# jjyaoao/HelloAgents

A agent framework based on the tutorial hello-agents

Repository: https://github.com/jjyaoao/HelloAgents
Canonical: https://ross.abutalabs.com/products/helloagents
Language: Python
License: NOASSERTION
License Family: other
Topics: agent, agentic-ai, llm, skills
Last push: 2026-06-08T03:35:53+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 86, release rhythm 71, longevity 25
- inputs: {"age_days": 356, "days_push": 86, "days_rel": 193, "gap_med": 3, "n_releases_24m": 12}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2831, forks 662 (observed 2026-08-28T04:07:24.340266+00:00)

## What it is
HelloAgents is a Python multi-agent framework built on OpenAI-compatible APIs, offering tool response protocols, context engineering, session persistence, sub-agent mechanisms, and observability features. It also serves as the companion codebase for the Datawhale Hello-Agents tutorial, with a dedicated learning branch.

## Use cases
- build multi-agent llm applications in python
- learn how agent frameworks work step by step
- create a react agent with custom tools
- add session persistence and context management to an llm agent
- connect an agent to openai, claude, gemini, or ollama endpoints
- track agent decisions and token usage with tracing and logging

## When to choose
- you want a batteries-included agent framework with tooling, persistence, and observability
- you are following the Datawhale Hello-Agents tutorial and want matching code
- you need OpenAI-compatible, Anthropic, and Gemini provider support in one framework

## When to avoid
- you need a permissively licensed library for commercial products - it is CC BY-NC-SA
- you want a minimal, unopinionated agent loop
- you need a framework in a language other than Python (a community Go port exists separately)

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, llm-inference, prompt-engineering, chatbot, workflow-automation, logging, tracing
- domain: artificial-intelligence, large-language-models, developer-tools, education
- platform: python, cross-platform
- tags: multi-agent, react-agents, tool-registry, session-persistence, context-engineering, skills, openai-compatible, tutorial-companion, non-commercial-license, ai-agents

## Member repositories
- jjyaoao/HelloAgents (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:24.340266+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:38:09.155816+00:00, confidence not recorded.
  - readme: https://github.com/jjyaoao/HelloAgents (fetched 2026-08-28T04:07:24.340266+00:00, sha e7123be27557)
- Data as of 2026-08-30T08:39:29.467469+00:00.