# Agora: Hermes Agent plugin

> Self-driving multi-agent development team.

Canonical: https://hermeswatcher.com/plugins/agora  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/agora  
Last updated in catalog: 2026-10-12

Self-driving multi-agent development team. Role-based workers (architect, developer, reviewer, tester, researcher, writer, devops) are each a real Hermes profile with its own SOUL.md and skills; they discuss and vote on decisions, and the adopted conclusion is executed by the same team. A "leader" profile chairs the discussions and a heartbeat cron wakes it to assess state, unblock workers and plan the next phase. Discussion and execution share one board: a motion is a sub-task of a per-project team channel task, speech and votes are `[agora:msg]` comments, the conclusion is written to task.result, and an adopted conclusion becomes execution tasks parented to the motion so context reaches workers through Hermes' own parent handoff. Ships 20 tools, 3 kanban lifecycle hooks, a dashboard tab and an `hermes agora` CLI; installing writes nothing — the three bundled skills are deployed by an explicit `hermes agora setup`.

## Good to know before installing

Creates a Hermes profile per worker by asking core to provision it (`hermes profile create --clone`, which copies config.yaml and .env into the new profile as owner-only files, never symlinks to the real credentials); spawns `hermes -p <profile> chat -Q -q` subprocesses to speak in discussions and to run dispatched tasks, which execute as full agents with that profile's toolset, including terminal and file writes inside the project workdir. Those subprocesses receive `--yolo --accept-hooks` ONLY when the project opted in via `agora_start_project(allow_unattended=True)`; the default is off, so a freshly installed team can read, discuss and plan but its flagged writes and shell commands fail closed. Also reads and writes the kanban database (tasks, task_comments, task_events, task_runs, task_links) restricted to its own project boards, including a persistent team-channel task pinned in `scheduled` status, and deletes a project's own tasks when it stops or completes; registers one recurring cron job and writes its runner script to HERMES_HOME/scripts/leader_heartbeat.sh; writes AGENTS.md into the configured project workdir; deploys three bundled skills into HERMES_HOME/skills/collabor

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install agora
```

2. Said no? Turn it on later:

```bash
hermes plugins enable agora
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Automation & multi-agent
- Maintained by: yzy806806 (Community)
- Needs: No API keys declared
- Adds tools: `agora_start_project`, `agora_stop_project`, `agora_project_status`, `agora_update_project`, `agora_create_task`, `agora_close_task`, `agora_raise_motion`, `agora_get_messages`, `agora_get_result`, `agora_list_motions`, `agora_close_motion`, `agora_message`, `agora_read_chat`, `agora_create_worker`, `agora_list_workers`, `agora_remove_worker`, `agora_list_templates`, `agora_create_team`, `agora_list_teams`, `agora_remove_team`
- Requires Hermes: `>=0.20`
- Version: 2.0.12
- In the catalog since: 2026-10-02, updated 2026-10-12

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/agora)
- [Source code](https://github.com/yzy806806/agora#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt