MCPcopy Index your code
hub / github.com/arturitu/the-delegation

github.com/arturitu/the-delegation @v0.2.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.2.0 ↗ · + Follow
445 symbols 970 edges 77 files 62 documented · 14%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

The Delegation Logo

Launch The Delegation · Full Experience *

[!IMPORTANT] * This experience requires BYOK (Bring Your Own Key). You will need a Gemini API key to run the simulation. Deep integration enables native support for text, and multimodal generation (Nano Banana, Lyria 3, Veo 3.1). You can also clone or fork this repository to run it locally.

The Delegation Hero

What is The Delegation?

A no-code 3D playground to explore, design, and interact with Agentic AI systems

This project is designed for AI enthusiasts, educators, and creative developers looking to understand multi-agent collaboration in a living 3D office without writing a single line of code.

Getting Started

  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open the app: Navigate to the local URL shown in your terminal (usually http://localhost:3000/the-delegation).

Features

Agentic AI System (v0.2.0)

  • Team Editor (React Flow): Create your own multi-agent design patterns using an interactive node-based interface.
  • 6 Predefined Teams: Industry-specific templates (Creative Agency, Film Studio, PR Agency, etc.) to get you started.
  • Multimodal Outputs: Generate professional assets including text, image (Nano Banana), music (Lyria 3), and video (Veo 3.1) directly from your agent teams.
  • Per-Agent LLM: Assign different Gemini Models to specific roles (e.g., Flash for speed, Pro for reasoning).
  • Cost & Token Tracking: Real-time estimation of usage costs and token consumption for transparency.
  • PR-style Workflows: Learn about Pull Request and Review workflows where agents with human-in-the-loop properties require your approval to proceed.
  • Guardrails: Controlled generation with the Auto-approve output option, ensuring quality before final asset production.
  • Technical Logs: Improved visibility into raw LLM traces, tool calls, and structured agent responses.

Embodied Simulation

  • Hybrid GPU/CPU Architecture: A high-performance 3D simulation built with Three.js WebGPU where autonomous LLM-powered characters collaborate in a shared physical workspace.
  • Intelligent Pathfinding: NPCs utilize a NavMesh to navigate the office, finding and claiming specific "Points of Interest" (desks, seats, computers) based on their current task. Pathfinding is powered by three-pathfinding.
  • Dynamic State Machine: Characters transition naturally between walking, sitting, working, and talking, with sync'ed 3D speech bubbles and expressions.

Interactive UI

  • Team Flow Visualizer: Real-time node-based view of your agent hierarchy and task flows.
  • Simulated PR Reviews: Interactive modals for reviewing agent proposals, providing feedback, and merging tasks.
  • Real-time 3D Overlay: Status indicators and interaction menus projected from 3D space into a polished UI.
  • Agent Inspector: Select any agent to view their "thoughts", mission, and history.
  • Kanban & Action Logs: Complete transparency into the agency's progress and tool-level interactions.

Tech Stack Deep Dive

Roadmap

  • World Building
    • [ ] Office/3D Space Editor: Drag-and-drop workspace layout and POI customization.
    • [ ] Dynamic Environment: Real-time prop generation and environment modification by agents.
  • Advanced Interactions
    • [ ] Advanced Embodied AI: Deeper integration between agent reasoning and physical 3D world actions.
    • [ ] Enhanced Animations: Richer character expressions and more fluid, context-aware animations.
    • [ ] Human-Agent Spatial Interaction: Direct collaboration and richer multi-party interactions in the 3D office.
    • [ ] Inter-Agent Knowledge Sharing: Long-term memory for agent teams across projects.
  • Refinement
    • [ ] Architecture Decoupling: Further separation of core logic from the simulation environment.
    • [ ] UX/UI Overhaul: Unified CSS styling based on "The Delegation" brand identity.

Developer Note

This release (v0.2.0) was developed entirely using Google Antigravity as the primary IDE and powered by Gemini 3 Flash.

License & IP

This project follows a dual-licensing model:

  • Source Code (MIT): All logic, shaders, and UI code are free to use, modify, and distribute.
  • 3D Models & Assets (CC BY-NC 4.0): The custom 3D office and character models are Copyright © 2026 Arturo Paracuellos (unboring.net). They are free for personal and educational use but cannot be used for commercial purposes without permission.

Developed with ❤️ by Arturo Paracuellos

Extension points exported contracts — how you extend this code

IAgentDriver (Interface)
(no doc) [5 implementers]
src/types.ts
LLMProvider (Interface)
(no doc) [2 implementers]
src/core/llm/types.ts
TeamState (Interface)
(no doc)
src/integration/store/teamStore.ts
PricingModalProps (Interface)
(no doc)
src/interface/PricingModal.tsx
AgentNode (Interface)
(no doc)
src/data/agents.ts
ICharacterDriver (Interface)
(no doc) [3 implementers]
src/types.ts
BrainHost (Interface)
(no doc) [1 implementers]
src/core/agent/AgentBrain.ts
TaskRevision (Interface)
(no doc)
src/integration/store/coreStore.ts

Core symbols most depended-on inside this repo

getState
called by 73
src/simulation/CharacterController.ts
getAllAgents
called by 21
src/data/agents.ts
play
called by 18
src/simulation/CharacterController.ts
getActiveAgentSet
called by 14
src/integration/store/teamStore.ts
useActiveTeam
called by 13
src/integration/store/teamStore.ts
getState
called by 13
src/simulation/behavior/AgentStateBuffer.ts
update
called by 11
src/types.ts
setState
called by 11
src/simulation/core/AgentHost.ts

Shape

Method 224
Function 119
Interface 56
Class 44
Enum 2

Languages

TypeScript100%

Modules by API surface

src/simulation/entities/CharacterManager.ts32 symbols
src/simulation/CharacterController.ts25 symbols
src/simulation/SceneManager.ts21 symbols
src/types.ts19 symbols
src/simulation/world/PoiManager.ts15 symbols
src/simulation/core/AgentHost.ts15 symbols
src/core/agent/AgentBrain.ts14 symbols
src/simulation/core/AgentSimulation.ts13 symbols
src/simulation/behavior/AgentStateBuffer.ts13 symbols
src/simulation/drivers/DriverManager.ts12 symbols
src/core/llm/providers/GeminiProvider.ts12 symbols
src/simulation/input/InputManager.ts11 symbols

For agents

$ claude mcp add the-delegation \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page