A gamified 3D interface for controlling AI agent swarms through an immersive cyberpunk office environment.
SwarmDesk transforms the complex task of AI agent orchestration into an engaging, game-like experience. Navigate through a cyberpunk office environment where each agent is represented as a unique character, and each project appears as an interactive workstation with real-time data streams.
Agents in the SwarmDesk Universe:
- D.Edens (Mad Tinkerer) - The orchestrator of beautiful chaos
- Git Assistant (Code Shepherd) - Manages repositories with quantum precision
- Browser Agent (Web Crawler) - Automates web tasks like a digital spider
- Haiku Bot (Digital Poet) - Creates documentation in verse form
- Greeter (Interface Guide) - Routes conversations and connects specialists
- Project Manager (System Architect) - Orchestrates project lifecycles
Each desk computer represents a different Madness Interactive project:
- EventGhost - Automation and macro system
- DVTTestKit - Testing and validation tools
- Inventorium - Main project management hub
- Omnispindle - CLI bridge and utilities
- Swarmonomicon - The agent framework core
- MadnessCore - System architecture foundation
- 3D Cyberpunk Office with neon lighting and holographic displays
- Real-time Particles and data stream animations
- Agent Movement AI with unique personalities and behaviors
- Dynamic Status Display showing real-time agent states
- WASD Movement - Navigate the office like a first-person game
- Mouse/Arrow Keys - Look around the environment
- E to Interact - Interface directly with agents
- Space for Chaos Dance - Enter dance mode for fun
- ESC to Disconnect - Exit interactions or release pointer lock
- Context-Aware Conversations - Each agent has unique personality and responses
- Custom Commands - Type direct instructions to agents
- Pre-built Options - Quick access to common agent functions
- Real-time Status Updates - Watch agent status change as they work
- Check repository status
- Commit changes with AI-generated messages
- Create and manage branches
- View git history and logs
- Navigate to websites
- Automate web tasks
- Extract data from pages
- Monitor sites for changes
- Generate creative documentation
- Write code-related poetry
- Create artistic content
- Compose technical haikus
- Initialize new projects
- Show dependencies
- Manage lifecycles
- Architect systems
- Modern web browser with WebGL support
- Internet connection (for Three.js CDN)
-
Clone the Repository
git clone <repository-url> cd projects/common/Inventorium/SwarmDesk
-
Serve the Files
# Using Python python -m http.server 8000 # Using Node.js npx serve . # Using any local web server
-
Open in Browser Navigate to
http://localhost:8000and enter the madness!
Visit: http://madnessinteractive.cc/SwarmDesk (coming soon!)
- Click to Enter - Click on the screen to enable mouse controls
- Move Around - Use WASD keys to walk through the office
- Look Around - Move mouse or use arrow keys to rotate camera
- Find Agents - Walk near any glowing agent character
- Approach an Agent - Walk within 3 units of any agent
- See the Prompt - "Press E to interface with [Agent Name]" will appear
- Press E - Opens the dialogue interface
- Choose Options - Click pre-built options or type custom commands
- Watch Magic Happen - See real-time status updates and responses
- To Git Assistant: "commit current changes" or "create branch feature/new-ui"
- To Browser Agent: "navigate to github.com" or "extract all links from this page"
- To Haiku Bot: "write a haiku about our project" or "create poetic documentation"
- To Project Manager: "initialize new project" or "show dependencies"
- Three.js - 3D rendering and scene management
- Vanilla JavaScript - Core logic and interactions
- CSS3 - Cyberpunk styling and animations
- HTML5 - Structure and layout
- Procedural Office Layout - Dynamically generated workstations
- Real-time Lighting - Neon and ambient lighting systems
- Particle Systems - Floating data particles and effects
- Animation Systems - Agent movement and interaction animations
- Modular Agent System - Each agent type has unique responses
- Conversation Memory - Agents remember previous interactions
- Status Synchronization - Real-time updates across the interface
- Command Routing - Intelligent delegation based on agent specializations
const newAgent = createAgent(
'Agent Name',
'Agent Role',
x, z, // Position
0xff6600, // Color
'agent_type', // Type
'personality' // Personality trait
);const newStation = createWorkstation(
x, z, // Position
"Project Name", // Display name
"agent_type" // Associated agent type
);Edit the responses object in generateAgentResponse() to customize agent personalities and capabilities.
- Fork the Repository
- Create Feature Branch (
git checkout -b feature/amazing-feature) - Commit Changes (
git commit -m 'Add amazing feature') - Push to Branch (
git push origin feature/amazing-feature) - Open Pull Request
- Real API Integration - Connect to actual Swarmonomicon agents
- Multiplayer Support - Multiple users in the same office
- VR/AR Support - Immersive reality interfaces
- Voice Commands - Speak to agents naturally
- Analytics Dashboard - Visual project metrics and insights
- Custom Office Layouts - User-configurable environments
This project is part of the Madness Interactive ecosystem. See the main repository for license details.
"In the beautiful chaos of creation, every line of code is a brushstroke, every agent a character in our digital story, and every interaction a moment of pure, wonderful madness."
- D.Edens, Mad Tinkerer
Embrace the Madness. Control the Swarm. Create the Future. 🚀🤖🎨