Skip to content

Swarm

A swarm distributes goals across gdc instances. Use local subagents for work on one host.

Roles

Role Responsibility
Master Membership authority and signed invites
Orchestrator Plan goals, dispatch tasks and aggregate results
Worker Execute assigned tasks against its model backend
Reviewer Worker advertising review skills

The initializing node starts as master and orchestrator. Members use cryptographic identities and TLS transport.

Workflow

  1. Initialize and join the swarm.
  2. Start an orchestrator and separately joined workers.
  3. Submit a goal.
  4. Inspect tasks and retrieve the workflow result.
  5. Manage membership as required.

--role both runs an orchestrator and worker on one instance for setup experiments. Goal submission should use separately joined workers because connections using the same agent identity can conflict.