A centralized control plane for managing distributed AI agent infrastructure.
Agenstra is a full-stack platform that enables you to manage multiple AI agent instances from a single web-based console. Connect to remote agent-manager services, interact with AI agents in real-time, edit code directly in containers, and automate server provisioning—all from one unified interface.
Agenstra provides a complete solution for managing distributed AI agent infrastructure:
- Centralized Management - Connect to and control multiple remote agent-manager services from a single console
- Real-time AI Interaction - WebSocket-based bidirectional communication with AI agents for instant responses
- Integrated Code Editor - Edit files directly in agent containers with Monaco Editor—read, write, and manage code in real-time
- Automated Server Provisioning - Provision cloud servers (Hetzner Cloud, DigitalOcean) with automated Docker and agent-manager deployment
- Version Control Integration - Full Git operations (status, branches, commit, push, pull, rebase) directly from the web interface
- Container Management - Monitor and interact with agent containers, view logs, and manage container lifecycle
- VNC Browser Access - Graphical browser access via VNC with XFCE4 desktop and Chromium browser
- CI/CD Pipeline Management - Configure, trigger, and monitor deployment pipelines from the console
Agenstra follows a three-tier distributed architecture:
┌─────────────────────┐
│ Frontend Console │ Angular application with NgRx state management
│ (Web-based IDE) │ Monaco Editor, Chat Interface, File Management
└──────────┬──────────┘
│ HTTP REST API
│ WebSocket (Socket.IO)
▼
┌─────────────────────┐
│ Agent Controller │ Centralized control plane
│ (Backend) │ Client management, event forwarding
└──────────┬──────────┘
│ HTTP REST API
│ WebSocket (Socket.IO)
▼
┌─────────────────────┐
│ Agent Manager │ Agent lifecycle management
│ (Backend) │ Container management, Docker integration
└─────────────────────┘
- Frontend Agent Console - Web-based IDE and chat interface built with Angular and NgRx
- Backend Agent Controller - Centralized control plane for managing multiple agent-manager instances
- Backend Agent Manager - Agent management system with HTTP REST API and WebSocket gateway
Connect to and manage multiple remote agent-manager services from a single console. Each client represents a remote agent-manager instance that can be provisioned automatically or connected manually.
WebSocket-based bidirectional communication with AI agents. Send messages, receive instant responses, and maintain chat history across reconnections.
Monaco Editor integration allows you to edit files directly in agent containers. Read, write, and manage code in real-time with syntax highlighting and code completion.
Provision cloud servers (Hetzner Cloud, DigitalOcean) with automated Docker installation and agent-manager deployment. Configure authentication, Git repositories, and agent settings during provisioning.
Full Git operations directly from the web interface:
- View git status and branches
- Stage, commit, and push changes
- Pull and rebase operations
- Resolve merge conflicts
Monitor agent containers, view logs, and manage container lifecycle. Real-time container statistics and health monitoring.
Access a Chromium browser running in a virtual workspace container via VNC. XFCE4 desktop environment with auto-started browser, accessible through a web-based noVNC client.
Configure CI/CD providers (GitHub Actions), trigger pipeline runs, monitor their status, and view logs directly from the Agenstra console.
- Set up your environment - Follow the Getting Started Guide to install and configure Agenstra
- Create your first client - Connect to an existing agent-manager or provision a new server
- Create an agent - Set up your first AI agent and start interacting
- Explore features - Use the integrated code editor, Git operations, and chat interface
- Getting Started Guide - Your entry point to Agenstra
- Local Development - Setting up for local development
- System Overview - High-level architecture and component relationships
- Components - Detailed breakdown of all system components
- Data Flow - Communication patterns and data flow
- Client Management - Managing remote agent-manager instances
- Agent Management - Agent lifecycle and container management
- Server Provisioning - Automated cloud server provisioning
- WebSocket Communication - Real-time bidirectional communication
- File Management - File system operations in agent containers
- Version Control - Git operations from the web interface
- Web IDE - Monaco Editor integration
- Chat Interface - AI chat functionality
- VNC Browser Access - Graphical browser access via VNC
- Docker Deployment - Containerized deployment guide
- Production Checklist - Production deployment guide
- Environment Configuration - Complete environment variables reference
- API Reference - Complete OpenAPI and AsyncAPI specifications
- Common Issues - Common problems and solutions
- Debugging Guide - Debugging strategies and tools
This project is licensed under the MIT License.
Copyright (c) 2025 IPvX UG (haftungsbeschränkt)
Portions of this software were originally Copyright (c) 2017-2025 Narwhal Technologies Inc.
This program is free software: you can redistribute it and/or modify it under the terms of the MIT License. See the LICENSE file for the full license text.
The following components are sublicensed under the GNU Affero General Public License v3.0 (AGPL-3.0):
apps/backend-agent-manager- Backend application for agent managementlibs/domains/framework/backend/feature-agent-manager- Agent management feature library
These components are licensed under AGPL-3.0, which means that any modifications or derivative works must also be licensed under AGPL-3.0 and made available to users, including when accessed over a network. See the respective backend-agent-manager application LICENSE and feature-agent-manager library LICENSE files for the full AGPL-3.0 license text.
The following components are sublicensed under the Business Source License 1.1 (BUSL-1.1):
apps/backend-agent-controller- Backend application for agent controllerlibs/domains/framework/backend/feature-agent-controller- Agent controller feature library
These components are licensed under BUSL-1.1, which permits non-production use and limited production use (subject to the Additional Use Grant terms). The license will convert to AGPL-3.0 after the Change Date (three years from release date). See the respective backend-agent-controller application LICENSE and feature-agent-controller library LICENSE files for the full BUSL-1.1 license text.
The following components are sublicensed under the Source-Available License:
apps/frontend-portal- Frontend application for the public landing pagelibs/domains/framework/frontend/feature-portal- Portal feature libraryapps/frontend-docs- Frontend application for documentationlibs/domains/framework/frontend/feature-docs- Documentation feature library
These components are licensed under a source-available license that grants only the right to view the source code. No other rights are granted, including copying, modifying, distributing, or using the software for any purpose. See the respective frontend-portal application LICENSE, feature-portal library LICENSE, frontend-docs application LICENSE, and feature-docs library LICENSE files for the full license text.
We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation, your input helps make Agenstra better for everyone.
For detailed information on how to contribute, please see our Contributing Guide.
Built with ❤️ for developers who want to manage AI agents at scale.