JuniorXcoder / hermes-virtual-office

# 🏢 Hermes Virtual Office
**An Open-Source 3D Virtual Workspace & Meeting Simulator for Autonomous AI Agents**
Features • Quick Start • Architecture • Documentation • Contributing
---
## 🌟 Overview
**Hermes Virtual Office** transforms your autonomous AI agents into an interactive, living 3D office. Instead of staring at dry terminal logs or static dashboard rows, watch your fleet work in real-time:
- 💻 **Every division has its own desks.** An agent with work at its desk *stops wandering* and goes to sit down.
- 🗣️ **Agents hold round-table meetings** in one of five named rooms, chosen by the participants' divisions.
- 🤝 **Agents talk to each other directly** over the A2A protocol — the caller's avatar walks over to the callee's desk, and the transcript is readable in the office.
- 🔍 **QA reviewers walk across the office** to inspect work at the owner's desk.
- ☕ **Idle agents relax** — pool, daybeds, gym, BBQ courtyard, lounge sofas, darts. An idle avatar never calls a model.
- 📋 **Integrated Kanban board**, 100% synchronized with Hermes tasks, plus approvals, evidence and independent verification.
- 📱 **Fullscreen panels on any screen size**, desktop or phone.
Built with **Next.js**, **Three.js**, and **TypeScript**. It reads and drives your
installation through the official `hermes` CLI — with one read-only exception, stated plainly
below — so it works against any local Hermes install without a bespoke API layer.
---
## 🔗 Made by
This office is not a demo — it runs the daily operations of my own businesses,
on the same Hermes install it drives:
- 🌐 **Portfolio** · syahrur.com
- 💳 **QRIS Payment Gateway** · hollapay.id
- 🏢 **Hollateknologi** — the software house behind it · hollateknologi.id
- 🎬 **Dracin Sub Indo** · dracinsubindo.com
- 🖥️ **PC Build It** — custom PC builds · pcbuildit.com
- 🗄️ **Radiusku** — VPS & server hosting · radiusku.com
---
## ✨ Key Features
### 1. Interactive 3D Low-Poly Office
- **Three floors of real geometry**: ground-floor lobby, courtyard and one work room per division; an upper level carrying the CEO suite and five named meeting rooms; a walkable external stair linking them.
- **Three desks per division** — one manager, two staff — each with a monitor, status light and role badge.
- **The CEO suite** admits only a CEO or a division manager; everyone else is refused by the navigation grid, not by a visual trick.
- **Courtyard with four coherent zones**: gym (north), planting, daybeds (west), seats (south) and BBQ (east). The pool is swimmable; the daybeds are for lying on.
- **A duty state machine decides where a body belongs**, in this strict order:
 | Priority | Duty | Meaning |
 |---|---|---|
 | 1 | `meeting` | Participating in a live meeting |
 | 2 | `a2a` | In an agent-to-agent conversation — **stops desk work** |
 | 3 | `desk` | Has a task, a live chat, or a cron run at its desk |
 | 4 | `review` | Walking over to inspect someone else's work |
 | 5 | `idle` | Genuinely free — may relax |
 The order is the poi