# Viberia

> Viberia is a 4X simulation engine for managing AI agent teams. Think SimCity, but for AI teams. Plan, staff, and scale your AI city — Dev, Design, Ops on one map. Local-first desktop app with BYO API keys.

Viberia lets you visually manage multiple AI coding agents on an isometric map. Each agent runs in its own building (CodeForge, KnowledgeBase, AwesomeForge, etc.) and can be assigned tasks, collaborate with other agents, and notify you when they need input. It's built with a Rust backend (event-sourced domain model, plugin system) and a React + PixiJS frontend, packaged as a Tauri desktop app.

## Key Features

- **4X Overview**: Bird's-eye view of all AI agents — see which teams are active, blocked, or waiting for input
- **Multi-Agent Workflows**: Teams of agents collaborate automatically — one drafts, another reviews, the third implements
- **Live Document Editing**: Edit documents directly while chatting with agents
- **Notification System**: Agents notify you when done or when they need input
- **Git Worktrees**: Each task gets its own branch and worktree, managed by an AwesomeForge building
- **MCP Tools**: Agents have access to MCP-based tools for file operations, web browsing, and more
- **Local-First**: Your data stays on your machine. BYO API keys for Claude, GPT, and other LLMs

## Architecture

- **Backend**: Rust, event-sourced with append-only journal, WASM plugin hooks, SQLite persistence
- **Frontend**: React 18, PixiJS for isometric rendering, Tailwind CSS
- **Desktop**: Tauri 2.x for cross-platform packaging
- **Message Bus**: Multi-lane QoS routing with capability-based authorization

## Links

- [Download](https://github.com/get-viberia/viberia-releases/releases/latest): macOS desktop app installer
- [Discord](https://discord.gg/sDxtXn4zq7): Community server
- [GitHub Releases](https://github.com/get-viberia/viberia-releases): Official release artifacts