🏛️ Hive Nation v2.2.0

Multi-Agent Orchestration powered by Mixture of Agents (MoA). Multiple specialized models analyze your task in parallel, an aggregator synthesizes their perspectives, and you get one high-quality response. Based on Hermes Agent MoA by Nous Research.

⚡ Get Started (30 seconds)

MoA is based on Hermes Agent by Nous Research. Reference models run in parallel, an aggregator synthesizes their advice into one response.

# 1. Clone
git clone https://github.com/Franzferdinan51/Agent-Teams.git && cd Agent-Teams

# 2. Install
npm install

# 3. Run MoA — ask anything, multiple models answer at once
node council-cli.js moa "should I refactor auth as microservices?"

Or via REST:

curl -X POST http://localhost:3003/api/moa/run \
  -H "Content-Type: application/json" \
  -d '{"prompt": "your question", "preset": "default"}'

That's it. No config required to try it. See docs/MOA.md for full setup, presets, and integration guides.

📋 Requirements

Requirement	Version	Notes
Node.js	18+	Download
npm	9+	Comes with Node.js
Git	Any recent	For cloning

Optional (for LLM-powered deliberation)

Provider	Required	Notes
MiniMax API Key	Recommended	Get from platform.minimax.io
LM Studio	Alternative	Download - Local, free
OpenRouter API Key	Alternative	Get from openrouter.ai - Free tier

🚀 Setup (5 Minutes)

Step 1: Clone the Repo

git clone https://github.com/Franzferdinan51/Agent-Teams.git
cd Agent-Teams

Step 2: Install Dependencies

npm install

This will install:

express - Web server
cors - Cross-origin support
ws - WebSocket support

Step 3: Configure LLM (Optional but Recommended)

Option A: MiniMax (Recommended - Best Quality)

# Get your API key from: https://platform.minimax.io/
export MINIMAX_API_KEY=sk-your-key-here

Option B: LM Studio (Free - Local)

Download LM Studio
Download a model (e.g., Gemma-4, Qwen-3)
Start LM Studio and enable "Local Server" (port 1234)

export LMSTUDIO_URL=http://127.0.0.1:1234/v1
export LMSTUDIO_KEY=sk-lm-any-key

Option C: OpenRouter (Free Tier)

# Get key from: https://openrouter.ai/keys
export OPENROUTER_API_KEY=sk-or-your-key

Step 4: Start Services

# Start everything at once
./start-all.sh

Or start individually:

# Council API (port 3007)
npm run start:council

# WebUI (port 3131)
npm run start:webui

Step 5: Open in Browser

WebUI: http://localhost:3131

Council API: http://localhost:3003/api/health

🎯 What's Built-In

Component	Description	Port
Mixture of Agents (MoA)	Multiple reference models analyze in parallel, aggregator synthesizes	3007
OpenClaw Plugin	Native MoA tools (`moa_run`, etc.) as OpenClaw agent tools	—
Council Server	LLM-powered deliberation with 46 councilors	3007
Multi-Provider LLM	MiniMax, LM Studio (local), OpenRouter	-
WebUI	Live dashboard with real-time updates	3131
46 Councilors	Diverse AI perspectives (Technocrat, Ethicist, etc.)	-
Senate (94)	Binding decrees from Council recommendations	-
Agent Teams	Spawn specialized agents for tasks	-
Hive Mesh	P2P agent communication	4000

🏛️ Architecture (v2.2.0)

┌─────────────────────────────────────────────────────────────────────┐
│                    🏛️ HIVE NATION v2.2.0 🏛️                       │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  🤖 MIXTURE OF AGENTS (MoA) — PRIMARY INTERFACE [Hermes/Nous] │   │
│  │  - Reference models fan out in parallel (Promise.all)        │   │
│  │  - Aggregator synthesizes all perspectives into one response│   │
│  │  - 3 presets: default, coding, security                     │   │
│  │  - REST: POST /api/moa/run  |  CLI: council moa          │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                              ↓                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  COUNCIL SERVER — 46 diverse LLM-powered councilors        │   │
│  │  - 9 deliberation modes: adversarial, consensus, swarm...     │   │
│  │  - Live SSE streaming | Auto-voting                           │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                              ↓                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  SENATE — 94 senators, 3 parties                          │   │
│  │  - Converts recommendations → binding DECREES               │   │
│  │  - MUST/SHALL/NEVER enforcement language                   │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                              ↓                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  EXECUTIVE — Meta-Agent executes decrees                   │   │
│  │  - Spawns agent teams | Monitors results                    │   │
│  └─────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────┘

LLM Providers

Provider	Type	Config
MiniMax	API (primary)	`MINIMAX_API_KEY` env var
LM Studio	Local (free)	`LMSTUDIO_KEY`, `LMSTUDIO_URL`
OpenRouter	API (free tier)	`OPENROUTER_API_KEY` env var

Key Files

File	Purpose
`council-cli.js`	CLI — MoA commands (`council moa "..."`)
`council-server.js`	REST API server — MoA + Council endpoints (port 3007)
`moa/moa-runtime.js`	Core MoA engine — parallel reference fan-out + aggregator
`moa/config.json`	MoA presets — default, coding, security, tiny
`moa/index.js`	Public API entry point
`moa/openclaw-plugin/`	OpenClaw plugin — native MoA tools (`moa_run`, etc.)
`councilors.json`	46 councilor definitions
`webui/server.js`	Web dashboard
`webui/public/index.html`	WebUI frontend
`scripts/hive-*.js`	80+ Hive scripts
`docs/MOA.md`	Full MoA guide (setup, API, integration)

🎮 Usage

Run Mixture of Agents (MoA)

# Via CLI — ask anything
node council-cli.js moa "should I refactor the auth system?"

# With a specific preset
node council-cli.js moa "audit this code" --preset security

# List all presets
node council-cli.js moa list

# Via REST API
curl -X POST http://localhost:3003/api/moa/run \
  -H "Content-Type: application/json" \
  -d '{"prompt": "explain this code", "preset": "coding"}'

# Via JavaScript
node -e "const {runMoA}=require('./moa/runtime'); runMoA('your prompt','default',[]).then(console.log)"

Start a Deliberation

# Via API
curl -X POST http://localhost:3003/api/session/start \
  -H "Content-Type: application/json" \
  -d '{"topic":"Should AI have rights?","mode":"proposal"}'

# Watch in WebUI
open http://localhost:3131

MoA Presets

Preset	References	Aggregator	Best For
`default`	qwen3.5-9b, gemma-26b, gemma-12b	ornith 35B	General analysis
`coding`	qwopus coder, qwen3.5-9b	ornith 35B	Architecture, code review
`security`	gemma-26b, ornith 35B	ornith 35B	Security audits

Switch LLM Provider

# Use LM Studio (local)
curl -X POST http://localhost:3003/api/llm/provider \
  -H "Content-Type: application/json" \
  -d '{"provider":"lmstudio"}'

# Check status
curl http://localhost:3003/api/llm/status

CLI Commands

npm run start:council    # Start Council only
npm run start:webui      # Start WebUI only  
npm run start:all        # Start both
npm run hive:status      # Check Hive status

📦 Files

Agent-Teams/
├── council-server.js    # LLM-powered Council (NEW!)
├── councilors.json      # 46 councilor definitions (NEW!)
├── start-all.sh         # Start all services (NEW!)
├── webui/               # Web dashboard
├── scripts/             # 80+ Hive scripts
├── agents/              # Agent definitions
├── skills/              # Agent skills
└── docs/                # Documentation

🌐 WebUI Features

📡 Live View - Watch deliberations in real-time
⚖️ Council Tab - See all 46 councilors
📊 Stats - Messages, votes, elapsed time
🔄 Auto-refresh - Updates every 2 seconds
🎨 Dark Theme - Premium command center design

⚡ Quick Commands

# Start everything
./start-all.sh

# Check services
curl http://localhost:3003/api/health
curl http://localhost:3131/api/health

# Test LLM
curl -X POST http://localhost:3003/api/llm/test

# List providers
curl http://localhost:3003/api/llm/providers | jq .

📚 Documentation

START-HERE.md - Getting started
docs/ - Full documentation
docs/MOA.md - Mixture of Agents guide (setup, presets, API, integration)
scripts/ - Hive scripts reference

🧪 Testing

# Test MoA presets load
node council-cli.js moa list

# Test MoA end-to-end
node council-cli.js moa "What is 2+2?"

# Test MoA REST API
curl -X POST http://localhost:3003/api/moa/run \
  -H "Content-Type: application/json" \
  -d '{"prompt": "hello world in python", "preset": "coding"}'

# Test Council
curl http://localhost:3003/api/councilors | jq '.councilors | length'

# Test LLM
curl -X POST http://localhost:3003/api/llm/test | jq '.content'

# Test deliberation
curl -X POST http://localhost:3003/api/session/start \
  -H "Content-Type: application/json" \
  -d '{"topic":"Test","mode":"proposal"}'

sleep 20
curl http://localhost:3003/api/session | jq '{phase, stats}'

🔧 Configuration

Set environment variables:

# LLM Providers
export MINIMAX_API_KEY=your_key
export LMSTUDIO_KEY=your_key
export LMSTUDIO_URL=http://127.0.0.1:1234
export OPENROUTER_API_KEY=your_key

# Ports
export PORT=3131

📝 Changelog

v2.1.0 (2026-04-19)

Merged AI Council into Agent-Teams (no more separate repo)
Added Multi-provider LLM support (MiniMax, LM Studio, OpenRouter)
Added Real LLM-generated deliberations (no more fake votes)
Added start-all.sh for one-command startup
Updated 46 integrated councilors with descriptions
Fixed Qwen reasoning_content parsing issue
Updated WebUI to connect to local council

v2.0.0 (Previous)

Initial release with Senate and Agent Teams

🏛️ Architecture

┌─────────────────────────────────────────────────────────────────────┐
│                    🏛️ HIVE NATION v2.0.1 🏛️                       │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  COUNCIL (46 diverse councilors)                            │   │
│  │  - 9 deliberation modes (adversarial, consensus, swarm...)  │   │
│  │  - Real LLM calls (MiniMax, OpenRouter)                    │   │
│  │  - Prevents "Yes-Man Syndrome"                             │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                              ↓                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  SENATE (94 senators, 3 parties)                            │   │
│  │  - Convert Council recommendations into binding DECREES     │   │
│  │  - MUST/SHALL/NEVER enforcement language                   │   │
│  │  - Democratic elections, weighted voting                    │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                              ↓                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  TEAMS (8 templates, parallel execution)                    │   │
│  │  - Research, Code, Security, Emergency, Planning, etc.      │   │
│  │  - Execute per Senate decree                                │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

Government Loop

1. PROBLEM identified
       ↓
2. COUNCIL debates (46 diverse voices)
       ↓
3. Council reaches consensus
       ↓
4. SENATE passes decree (THE LAW - binding)
       ↓
5. TEAMS execute per decree

⚡ Services

Service	Port	URL	Status
Hive WebUI	3131	http://localhost:3131	✅ Live
Council	3006	http://localhost:3006	✅ 46 councilors
MCP Server	3456	http://localhost:3456	✅ 23 tools
Automation	3457	http://localhost:3457	⏳ Start manually

🌐 WebUI Dashboard

Access: http://localhost:3131

Tabs

Tab	Features
📊 Overview	Live stats, quick actions, decrees, votes, agents
🏛️ Senate	Issue decrees, senator roster
🗳️ Voting	Historical votes, statistics
🤖 Agents	Rankings, scoring
👥 Teams	Spawn teams (8 templates), templates reference
🧠 Memory	Store/search memories
🧠 Council	Councilors, modes, deliberations
⚡ Automation	Job management
📈 System	Health, services

WebUI Commands

# Restart WebUI
pkill -f "node.*webui/server" && cd ~/Desktop/AgentTeam-GitHub && node webui/server.js &

# Check logs
tail -f /tmp/hive.log

🤖 Agent Teams

8 Templates

Template	Roles	Best For
🔬 Research	researcher + writer + reviewer	Research workflows
💻 Code	coder + reviewer + security	Code development
🛡️ Security	security + reviewer + communicator	Security audits
🚨 Emergency	security + communicator + planner	Incident response
📋 Planning	planner + researcher + communicator	Strategic planning
📊 Analysis	researcher + analyst + writer	Data analysis
🚀 DevOps	coder + security + communicator	Deployment
🐝 Swarm	multiple specialists	Parallel tasks

Spawn a Team

# Via CLI
node agents/teams/hive-teams.js spawn research "Build REST API"

# Via WebUI → Teams tab → Spawn Team button

🏛️ Senate Decrees

THE LAW — Binding enforcement language:

Pattern	Enforcement	Example
`MUST`	Absolute	"All agents MUST encrypt data"
`SHALL`	Absolute	"Agents SHALL verify sources"
`NEVER`	Absolute	"NEVER delete memory without approval"
`FORBIDDEN`	Absolute	"FORBIDDEN: unauthorized access"
`PREFER`	Advisory	"PREFER local models for privacy"

Issue a Decree

# Via CLI
node scripts/hive-senate-complete.js issue "Privacy" "All agents MUST encrypt sensitive data"

# Via WebUI → Senate tab → New Decree button

🧠 AI Council

46 diverse councilors with adversarial deliberation:

Deliberation Modes

Mode	Purpose
`balanced`	Neutral analysis
`adversarial`	Devil's advocate
`consensus`	Find agreement
`brainstorm`	Creative solutions
`swarm`	Parallel thinking
`legislature`	Formal debate
`prediction`	Future forecasting
`inspector`	Critical review
`devil-advocate`	Challenge assumptions

Council Workflow

# Run deliberation
node scripts/hive-workflow.js council "Should we adopt microservices?"

# Check council status
curl http://localhost:3006/status

⚡ Automation Engine v2

Persistent task runner with triggers:

# Start automation
node scripts/hive-automation-v2.js start

# Add jobs
node scripts/hive-automation-v2.js add cron "0 2 * * *" "Backup" backup
node scripts/hive-automation-v2.js add webhook "security-alert" "Alert" alert
node scripts/hive-automation-v2.js add decree "privacy" "Enforce Privacy" privacy

# List jobs
node scripts/hive-automation-v2.js list

# Stats
node scripts/hive-automation-v2.js stats

Trigger Types

Type	Trigger
cron	Schedule (e.g., `0 2 * * *` = 2 AM daily)
webhook	HTTP POST to `/webhook/:id`
event	Job completes/fails/starts
decree	Senate passes matching decree

🔌 MCP Server

23 tools exposed via JSON-RPC:

# Start MCP
node mcp-server.js

# Endpoints
# - http://localhost:3456/mcp   (JSON-RPC)
# - http://localhost:3456/sse    (SSE)
# - http://localhost:3456/health

Tool Categories

Category	Tools
Senate	senate_list, senate_decrees, senate_create_decree
Council	council_status, council_councilors, council_modes, council_session
Teams	teams_list, teams_spawn, teams_templates, teams_add_task
Memory	memory_list, memory_create, memory_recall
Scoring	scoring_list, scoring_agent
Dashboard	dashboard_status, system_health
Governance	governance_status, governance_run

💻 CLI Commands

Quick Reference

# Senate
node scripts/hive-senate-complete.js dashboard
node scripts/hive-senate-complete.js issue "Title" "Content"

# Council
node scripts/hive-workflow.js council "Question"

# Teams
node agents/teams/hive-teams.js list
node agents/teams/hive-teams.js spawn research "Task"

# Automation
node scripts/hive-automation-v2.js start
node scripts/hive-automation-v2.js list

# Execute (full pipeline demo)
node scripts/hive-execute.js

📁 Project Structure

AgentTeams/
├── webui/
│   ├── server.js              # WebUI server (Express)
│   └── public/
│       └── index.html         # Dashboard UI (v2.0.1 overhaul)
├── scripts/
│   ├── hive-core.js           # Core (LLM + persistence)
│   ├── hive-workflow.js       # Governance pipeline
│   ├── hive-execute.js        # Full system demo
│   ├── hive-automation-v2.js  # Automation engine v2
│   ├── hive-senate-complete.js
│   ├── hive-voting.js
│   └── hive-memory.js
├── mcp-server.js              # MCP server (23 tools)
├── agents/teams/
│   └── hive-teams.js          # Team system
├── plugins/
│   └── openclaw/              # OpenClaw integration
└── data/
    ├── core/state.json        # Persistent state
    └── automation/
        ├── jobs.json          # Automation jobs
        └── triggers.json     # Trigger configs

🎯 Key Features

✅ 46 Councilors with adversarial deliberation
✅ 94 Senators (3 parties, weighted voting)
✅ Senate Decrees (MUST/SHALL/NEVER enforcement)
✅ 8 Team Templates with parallel execution
✅ Automation Engine v2 (cron/webhook/event/decree)
✅ Persistent State (JSON survives restarts)
✅ Real LLM Calls (MiniMax, OpenRouter)
✅ MCP Server (23 tools)
✅ WebUI Dashboard (9 tabs, fully functional)
✅ OpenClaw Plugin (Duck CLI integration)

🔧 v2.0.1 Fixes (2026-04-19)

What's Fixed

Issue	Fix
Cold-Start Bug	State always initialized
Live LLM Integration	Real API calls (MiniMax, OpenRouter)
Persistent State	JSON files survive restarts
Inter-Agent Messaging	Real message passing with routing
WebUI Broken Tabs	Complete overhaul - all tabs working
Duplicate Navigation	Restructured 9 proper tabs
Missing Animations	Added bg gradients, hover effects, glow

WebUI Enhancements

Animated background with floating gradients
Quick actions panel on overview
Glowing brand icon with pulse
Card hover effects with border glow
Toast notifications (success/error/info)
8 team templates (was 5)
Memory search functionality
Automation tab (job management)

🧪 Testing

# Run all tests
node scripts/hive-execute.js

# Test API endpoints
curl http://localhost:3131/api/dashboard
curl http://localhost:3131/api/decrees
curl http://localhost:3131/api/teams

# Verify persistence
# Restart server, data should survive

🦆 Branding

Mascots: 🦆 Duck | 🐝 Bee | 🦞 Lobster

Parties:

🦆 Quack Party — Research & Analysis (blue)
🐝 Honey Party — Development & Security (gold)
🦞 Claw Party — Planning & Communication (red)

📜 License

MIT License

Version 2.0.1 — Built for production multi-agent governance 🏛️⚖️🦆

📁 Complete File Structure

Agent-Teams/
├── 📦 Core Council (v2.1.0)
│   ├── council-server.js      # LLM-powered deliberation API
│   ├── councilors.json        # 46 councilor definitions
│   ├── council-app.tsx        # React frontend for Council
│   └── council-mcp-server.js  # MCP tool server
│
├── 📦 Agent System
│   └── agent-api-server/      # Agent API server
│       ├── api_server.py      # Main API
│       └── package.json
│
├── 🌐 WebUI
│   ├── webui/server.js       # Web dashboard server
│   └── webui/public/         # Frontend files
│
├── 🧠 Hive Scripts (80+)
│   ├── hive-council.js       # Council integration
│   ├── hive-senate.js        # Senate system
│   └── scripts/hive-*.js     # All hive scripts
│
└── 📚 Documentation
    ├── docs/                 # Full documentation
    └── README.md

🧪 Testing the Full System

1. Test Council API

npm run council:status
npm run council:test
npm run council:providers

2. Start Full Council App

npm run start:council-app
# Opens React UI on port 3002

3. Start Agent API

npm run start:agent-api

4. Start MCP Server (for tools)

npm run start:mcp

5. Start Deliberation

npm run council:deliberate

🔧 Full Setup for All Features

# 1. Clone and install
git clone https://github.com/Franzferdinan51/Agent-Teams.git
cd Agent-Teams
npm install

# 2. Set environment variables
export MINIMAX_API_KEY=your_key
export LMSTUDIO_KEY=sk-lm-any-key

# 3. Start everything
./start-all.sh

# 4. Optionally start additional services
npm run start:council-app   # React UI (port 3002)
npm run start:agent-api      # Agent API
npm run start:mcp            # MCP tools

📊 All Available Ports

Service	Port	Description
Council API	3007	LLM deliberation
Council App	3002	React frontend
WebUI	3131	Hive dashboard
Agent API	8080	Agent server
MCP Server	3850	Tool protocol
Mesh API	4000	P2P mesh

🎨 Complete Feature List (v2.1.0)

Core Council Features

Feature	Description	Status
LLM-Powered Deliberation	Real AI-generated debate	✅
46 Councilors	Diverse AI perspectives	✅
Multi-Provider LLM	MiniMax, LM Studio, OpenRouter	✅
Real Voting	LLM-determined vote outcomes	✅
SSE Streaming	Live updates to WebUI	✅
9 Deliberation Modes	proposal, deliberation, swarm, etc.	✅

React UI Components (council-components/)

Component	Description
`ChatMessage.tsx`	Chat message with avatars
`ChatWindow.tsx`	Main chat interface
`CouncilorDeck.tsx`	Councilor selection cards
`LiveSession.tsx`	Live deliberation view
`LiveWatcher.tsx`	Real-time watcher mode
`MessageInput.tsx`	Message input with auto-complete
`OrchestrationPanel.tsx`	Swarm task orchestration
`CodingInterface.tsx`	Code generation interface
`SettingsPanel.tsx`	LLM provider settings
`Toast.tsx`	Notification toasts

Server Features (council-server.js)

Endpoint	Description
`GET /api/health`	Health check with provider status
`GET /api/llm/providers`	List all LLM providers
`GET /api/llm/status`	Current LLM status
`POST /api/llm/test`	Test LLM connection
`POST /api/llm/provider`	Switch LLM provider
`GET /api/session`	Get current session
`POST /api/session/start`	Start deliberation
`GET /api/session/messages`	Get all messages
`POST /api/session/event`	Push session event
`GET /api/councilors`	List all councilors
`GET /api/events`	SSE event stream

Additional Services

Service	Port	Description
council-server.js	3007	Main Council API
council-api-server.cjs	3001	Full API + MCP
council-mcp-server.js	3850	MCP tool server
webui/server.js	3131	Hive Dashboard
agent-api-server/	8080	Agent system

React App (council-app.tsx)

Full Council React UI (50KB)
Live session watching
Councilor deck selection
Message input with councilor selection
Settings panel for LLM providers

Documentation

File	Description
docs/COUNCILORS.md	Councilor profiles
docs/VISION-COUNCIL.md	Vision analysis system
docs/SWARM-CODING.md	Swarm coding mode
docs/COUNCIL-QUICKSTART.md	Quick start guide

🚀 Quick Command Reference

# Start all services
npm run start:all

# Start individual services
npm run start:council      # Council API (3007)
npm run start:webui        # WebUI (3131)
npm run start:council-app  # React app (3002)
npm run start:council-api  # Full API (3001)
npm run start:mcp          # MCP tools (3850)

# Test Council
npm run council:status     # Check health
npm run council:test       # Test LLM
npm run council:deliberate # Start deliberation
npm run council:providers  # List providers
npm run council:list      # Count councilors

📊 Services & Ports

Port	Service	File
3001	Full API + MCP	council-api-server.cjs
3002	React App	(needs npm install)
3007	Council API	council-server.js
3131	Hive WebUI	webui/server.js
3850	MCP Server	council-mcp-server.js
8080	Agent API	agent-api-server/

🔧 Environment Variables

# Required for LLM
MINIMAX_API_KEY=your_key        # MiniMax (primary)

# Optional
OPENROUTER_API_KEY=your_key    # OpenRouter
LMSTUDIO_KEY=sk-lm-any         # LM Studio (local)
LMSTUDIO_URL=http://localhost:1234/v1
PORT=3007                       # Council port

📁 Complete File Structure (All Merged)

Agent-Teams/
├── 🏛️ Council System
│   ├── council-server.js      # LLM deliberation API
│   ├── council-api-server.cjs # Full API + MCP
│   ├── council-mcp-server.js # MCP tools
│   ├── council-app.tsx        # React frontend
│   ├── councilors.json        # 46 councilors
│   ├── council-components/    # React components
│   │   ├── ChatMessage.tsx
│   │   ├── ChatWindow.tsx
│   │   ├── CouncilorDeck.tsx
│   │   ├── LiveSession.tsx
│   │   ├── LiveWatcher.tsx
│   │   ├── MessageInput.tsx
│   │   ├── OrchestrationPanel.tsx
│   │   ├── CodingInterface.tsx
│   │   ├── SettingsPanel.tsx
│   │   └── Toast.tsx
│   ├── council-constants.ts   # Model configs
│   ├── council-types.ts       # TypeScript types
│   ├── council-cli.js         # CLI tool
│   └── council-dist/          # Pre-built UI
│
├── 🤖 Agent System
│   ├── agent-api-server/      # Agent API
│   └── agent-swarm-system/     # Swarm orchestration
│
├── 🌐 Hive WebUI
│   ├── webui/server.js
│   └── webui/public/
│
├── 🧠 Hive Scripts (80+)
│   ├── hive-council.js
│   └── scripts/hive-*.js
│
└── 📚 Documentation
    ├── docs/
    └── README.md

Name		Name	Last commit message	Last commit date
agent-api-server		agent-api-server
agent-swarm-system		agent-swarm-system
agents		agents
automation		automation
cli		cli
config		config
council-components		council-components
council-dist		council-dist
data		data
docs		docs
moa		moa
monitoring		monitoring
multi-instance		multi-instance
plugins		plugins
providers		providers
scripts		scripts
security		security
skills		skills
src		src
tools		tools
webui		webui
workspace		workspace
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
DESIGN-MOA-INTEGRATION.md		DESIGN-MOA-INTEGRATION.md
MODEL-PREFERENCES.md		MODEL-PREFERENCES.md
MODEL-SETUP.md		MODEL-SETUP.md
QUICKREF.md		QUICKREF.md
README.md		README.md
SETUP-YOUR-MODELS.md		SETUP-YOUR-MODELS.md
START-HERE.md		START-HERE.md
VERSION		VERSION
config.json		config.json
config.yaml		config.yaml
council-api-server.cjs		council-api-server.cjs
council-app.tsx		council-app.tsx
council-cli.js		council-cli.js
council-constants.ts		council-constants.ts
council-discord.css		council-discord.css
council-index.tsx		council-index.tsx
council-package.json		council-package.json
council-server.js		council-server.js
council-server.js.bak		council-server.js.bak
council-test.js		council-test.js
council-types.ts		council-types.ts
councilors.json		councilors.json
install.sh		install.sh
mcp-server.js		mcp-server.js
package-lock.json		package-lock.json
package.json		package.json
run_test.sh		run_test.sh
start-all.sh		start-all.sh
start-council.sh		start-council.sh
start-webui.sh		start-webui.sh
start_3004.sh		start_3004.sh
start_fresh.sh		start_fresh.sh
start_server.sh		start_server.sh
test-moa.js		test-moa.js
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

🏛️ Hive Nation v2.2.0

⚡ Get Started (30 seconds)

📋 Requirements

Optional (for LLM-powered deliberation)

🚀 Setup (5 Minutes)

Step 1: Clone the Repo

Step 2: Install Dependencies

Step 3: Configure LLM (Optional but Recommended)

Step 4: Start Services

Step 5: Open in Browser

🎯 What's Built-In

🏛️ Architecture (v2.2.0)

LLM Providers

Key Files

🎮 Usage

Run Mixture of Agents (MoA)

Start a Deliberation

MoA Presets

Switch LLM Provider

CLI Commands

📦 Files

🌐 WebUI Features

⚡ Quick Commands

📚 Documentation

🧪 Testing

🔧 Configuration

📝 Changelog

v2.1.0 (2026-04-19)

v2.0.0 (Previous)

🏛️ Architecture

Government Loop

⚡ Services

🌐 WebUI Dashboard

Tabs

WebUI Commands

🤖 Agent Teams

8 Templates

Spawn a Team

🏛️ Senate Decrees

Issue a Decree

🧠 AI Council

Deliberation Modes

Council Workflow

⚡ Automation Engine v2

Trigger Types

🔌 MCP Server

Tool Categories

💻 CLI Commands

Quick Reference

📁 Project Structure

🎯 Key Features

🔧 v2.0.1 Fixes (2026-04-19)

What's Fixed

WebUI Enhancements

🧪 Testing

🦆 Branding

📜 License

Version 2.0.1 — Built for production multi-agent governance 🏛️⚖️🦆

📁 Complete File Structure

🧪 Testing the Full System

1. Test Council API

2. Start Full Council App

3. Start Agent API

4. Start MCP Server (for tools)

5. Start Deliberation

🔧 Full Setup for All Features

📊 All Available Ports

🎨 Complete Feature List (v2.1.0)

Core Council Features

React UI Components (council-components/)

Server Features (council-server.js)

Additional Services

React App (council-app.tsx)

Documentation

🚀 Quick Command Reference

📊 Services & Ports