// agents · Human-Agent-Society/reef

reef

Reef — infrastructure for continually self-improving agents: weight-training and harness-evolving deployments.

★ 7.5k stars⑂ 698 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

reef is an open-source ai agents project by Human-Agent-Society (Human-Agent-Society/reef on GitHub). It has 7,504 GitHub stars and 698 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
7,504
Forks
698
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Choose your improvement path — weight training, harness evolution, or both — and identify which agent traffic and feedback signals will drive it.

  2. Get the project

    Clone Human-Agent-Society/reef from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Install reef-infra from PyPI for use, or clone and install from source for development and the full recipes.

  4. Run your first task

    Stand up a minimal deployment, send a provider-compatible inference request through it, then send an outcome report and confirm the loop records it.

// features

Why people love it

Two improvement paths

Supports weight-training deployments and harness-evolving deployments, so improvement can target the model or its scaffolding.

Provider-compatible inference

Your agent sends provider-compatible inference requests through Reef, keeping the integration surface familiar.

Outcome reporting loop

Clients send reports about inference outcomes back to Reef, closing the loop that continual improvement needs.

Fits your existing stack

Designed to slot into an agent stack you already run, rather than replacing your agent framework.

Recipes and examples

Ships recipes and examples for the documented deployment patterns.

PyPI or source install

Install reef-infra from PyPI, or from source with uv, including an optional slime extra for the training path.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source from the official GitHub repository for reef.

    git clone https://github.com/Human-Agent-Society/reef.git
    cd reef
  2. Install from PyPI

    Install the published package as the README's installation section shows.

    uv pip install reef-infra
  3. Or install from source

    Clone the repository and install it in editable mode (with the training extra if you need it).

    git clone https://github.com/Human-Agent-Society/reef.git
    cd reef
    uv pip install -e .
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains reef?

Human-Agent-Society, through the Human-Agent-Society/reef repository, with the site at reefinfra.ai.

Is reef free to use?

Yes — the project is open source under the Apache-2.0 license as recorded for this listing. See the license terms for any conditions on redistribution.

Does reef need a paid API key?

Reef's inference path is provider-compatible, so model calls use your configured provider and keys; Reef itself is free and Apache-2.0 licensed.

How does Reef compare to a standard agent framework?

Frameworks help you build and run an agent once. Reef is infrastructure for what happens next — collecting inference outcomes and continually improving weights or harness — so it complements a framework rather than competing with it.

How do I get started with reef?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — stand up a minimal deployment, send a provider-compatible inference request through it, then send an outcome report and confirm the loop records it.

// keep exploring

Similar tools

AI Agents

evolver

A GEP-powered self-evolving engine for AI agents — auditable evolution with Genes, Capsules and Events.

★ 9.1k starsGPL-3.0
View guide →
AI Agents

Raven

The harness of harnesses: a persistent, self-evolving multi-agent ecosystem built for RSI.

★ 5.3k starsApache-2.0
View guide →
AI Agents

EvoAgentX

EvoAgentX — a framework for building self-evolving ecosystems of AI agents.

★ 3.4k starsMIT
View guide →
AI Agents

webcmd

Self-learning browser infrastructure for AI agents — sites remembered, so agents stop rediscovering the web

★ 2.7k starsApache-2.0
View guide →
AI Agents

PraisonAI

PraisonAI 🦞 — Hire a 24/7 AI Workforce. Stop writing boilerplate and start shipping autonomous self-improving agents that research, plan, code, and execute t…

★ 9.1k starsMIT
View guide →
AI Agents

MemOS

Self-evolving memory OS for LLMs and agents: persistent graph memory, hybrid retrieval, skill reuse.

★ 11.8k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if reef is not the right fit.

Get reef

Free and open — grab the source, star the repo, and start creating.