fabricatio-team

MIT

Team coordination for Fabricatio agents. Provides a Team container for assembling agent rosters, a Cooperate mixin that gives individual roles awareness of their teammates, and optional integration with fabricatio-digest for task planning across a team.

Requires Python 3.12+.

Installation

pip install fabricatio[team]
# or
uv pip install fabricatio[team]

Key Components

Team

Dataclass that manages a set of RoleName members. Build a team, add or remove members, then call inform() to notify every Cooperate-capable member of the full roster and dispatch() to activate them all.

from fabricatio_core import Role
from fabricatio_team.models.team import Team
from fabricatio_team.capabilities.team import Cooperate

class Analyst(Cooperate):
    ...

class Reviewer(Cooperate):
    ...

alice = Analyst(name="alice")
bob = Reviewer(name="bob")

team = Team()
team.join(alice).join(bob)
team.inform()
team.dispatch()

Cooperate

Mixin class (extends ScopedConfig, ABC) that gives a Role team-awareness. Inherit from it alongside a base Role to let the role track teammates, look them up by name, and collect their event acceptors for workflow routing.

from fabricatio_core import Role
from fabricatio_team.capabilities.team import Cooperate

class Planner(Role, Cooperate):
    async def plan(self, task: str):
        for mate in self.team_members:
            info = mate.bio
            # delegate subtasks based on bio
        ...

CooperativeDigest

Optional mixin (requires fabricatio-digest) that combines Cooperate with the Digest task-planning capability. When installed, exposes cooperative_digest(requirement, with_self=True) — it delegates to Digest.digest, automatically passing the team roster as context so the generated task list accounts for all available members.

pip install fabricatio[team,digest]

from fabricatio_digest.capabilities.digest import Digest
from fabricatio_team.capabilities.digest import CooperativeDigest

class TeamPlanner(CooperativeDigest, Digest):
    ...

planner = TeamPlanner()
tasks = await planner.cooperative_digest("Build the authentication module")

Configuration

All options below are read through the fabricatio configuration chain (see the Configuration Guide). Set them under the [ext.team] table in fabricatio.toml, equivalently under [tool.fabricatio.ext.team] in pyproject.toml, or via FABRICATIO_EXT__TEAM__<FIELD_UPPER> environment variables.

[ext.team]

The TeamConfig schema currently defines no options and is reserved for future use.

Access at runtime: from fabricatio_team.config import team_config.

Package Structure

fabricatio-team/
├── python/fabricatio_team/
│   ├── models/
│   │   └── team.py            - Team dataclass
│   ├── capabilities/
│   │   ├── team.py            - Cooperate mixin
│   │   └── digest.py          - CooperativeDigest (optional)
│   ├── actions/               - Action stubs (extend here)
│   ├── workflows/             - Workflow stubs (extend here)
│   ├── config.py              - TeamConfig
│   └── __init__.py
└── pyproject.toml

Dependencies

• fabricatio-core — Role, RoleName, ScopedConfig, configuration system, event routing
• fabricatio-digest (optional) — enables CooperativeDigest for team-aware task planning

License

MIT — see LICENSE