Skip to main content
AI Tool Radar
OSI-openAgent frameworks and runtimes

reef

human-agent-society

Continual-learning infrastructure that lets agents improve from real usage through a serve-observe-grow-commit loop.

4.2k stars(as of 2026-09-23)View on GitHubHomepage

What is reef?

An open-source infrastructure platform connecting agent inference, feedback collection, model training and versioned artifact delivery, so agents improve continually without manual retraining cycles. It runs a four-stage cycle (Serve, Observe, Grow, Commit), supports both model-weight training and harness-only optimization (the GPU-free 'Reefine' recipe), and plugs into existing vLLM or SGLang inference.

reef at a glance
FactValue
Maintainerhuman-agent-society
GitHub stars4,191 (as of 2026-09-23)
Forks347
LicenseApache-2.0
License typeOSI-open
CategoryAgent frameworks and runtimes
StatusRising
Edition2026-09
Last verified2026-09-23

reef in depth

Agents that ship once and never change are already the norm; agents that keep improving from how people actually use them are still mostly a research problem, solved ad hoc with a bespoke fine-tuning script bolted onto whatever inference server a team already runs. reef, from the Human Agent Society (a research collaboration whose contributors list MIT, Stanford, Berkeley, CMU, Google DeepMind, Meta and ByteDance affiliations on its homepage), tries to make that loop a piece of reusable infrastructure rather than a one-off project. Instead of retraining an agent by hand whenever it misbehaves, reef wires inference, user feedback and training into a single continuous pipeline, so an agent's next version becomes a natural output of how the last one was actually used.

The architecture is a four-stage cycle: Serve handles live agent requests and records the interaction, Observe matches incoming user feedback back to the recorded interaction it belongs to, Grow generates candidate updates from training data that has accumulated and become eligible, and Commit applies a selection policy before publishing an accepted update to a versioned artifact history via Git LFS. Updates can target model weights directly through frameworks like Slime, veRL or AReaL, or skip GPU training entirely via the Reefine recipe, which optimizes the agent's harness and prompting instead. Inference plugs into existing vLLM or SGLang deployments rather than requiring a new serving stack.

reef is aimed squarely at teams already running an agent in production who are tired of manually curating feedback and re-triggering fine-tuning jobs by hand. Because Reefine works without a GPU, it is also reachable for teams that want the continual-improvement loop but cannot justify a training cluster yet - they can start by evolving the agent's harness and prompts from real usage data and add weight training later. The vLLM/SGLang integration means it fits naturally into a stack that already serves models that way, rather than asking you to replace your inference layer to adopt it.

The caveats start with age: reef's repository was created on 2026-08-31 and its first tagged release, v0.1.0, shipped the same day this review was written, so there is no long-term track record yet, despite the fast-growing star count. The LICENSE file's copyright line reads 'Copyright 2025 Zhipu AI' rather than the Human Agent Society organization that publishes the project, an inconsistency worth clarifying before you rely on it commercially, even though the Apache-2.0 terms themselves are unambiguous. The benchmark results the project cites, against AIME 2025, IMOAnswerBench, CEO-Bench and Terminal-Bench, are its own reported numbers and have not been independently reproduced, so treat them as a starting point, not a guarantee.

The verdict: reef is worth watching if you are building agents that need to learn from production feedback and do not want to hand-roll the plumbing between serving, feedback capture, training and version control yourself, and the GPU-free Reefine path lowers the barrier to trying it. Treat it as an early-stage infrastructure bet rather than a mature dependency - the commit activity and contributor spread are real, but three weeks of history and an unresolved licensing inconsistency mean it is too early for anything you cannot afford to revisit or replace.

Pros & Cons

Pros

  • Full four-stage pipeline (serve, observe, grow, commit) rather than a single training script, with a GPU-free harness-optimization mode (Reefine) alongside full weight training
  • Real engineering signals: 10+ active contributors, commits through the day of this check, benchmarks published against AIME 2025, Terminal-Bench and other suites (the project's own numbers)
  • Apache-2.0 on code, plugs into existing vLLM/SGLang serving instead of requiring a new inference stack

Cons

  • Very young: repo created 2026-08-31, first tagged release (v0.1.0) shipped the same day this was checked - no track record yet despite the fast-growing star count
  • LICENSE file's copyright holder (Zhipu AI) does not match the human-agent-society org that publishes it - worth clarifying before relying on it commercially
  • Benchmark results (AIME 2025, IMOAnswerBench, CEO-Bench, Terminal-Bench) are the project's own reported figures, not independently reproduced

License

Apache-2.0 (OSI-open)

Apache-2.0 per the repo badges and README - but the LICENSE file's copyright line reads 'Copyright 2025 Zhipu AI', not the human-agent-society org, an inconsistency worth noting even though the terms themselves are unambiguous Apache-2.0.

When it is interesting

Teams building agents that need to learn from production feedback without hand-rolling the plumbing between serving, feedback and training.

When it is too early

Production use before the license anomaly is clarified, or if you need a project with more than three weeks of history.

This repo featured in the 2026-09 edition of the Open-Source AI Radar.