https://github.com/forepath/agenstra
Centralized management platform for distributed AI agent infrastructure with real-time interaction, code editing, and automated provisioning.
https://github.com/forepath/agenstra
angular bootstrap clarity forepath framework ionic keycloak nestjs tsef typescript
Last synced: 2 days ago
JSON representation
Centralized management platform for distributed AI agent infrastructure with real-time interaction, code editing, and automated provisioning.
- Host: GitHub
- URL: https://github.com/forepath/agenstra
- Owner: forepath
- License: other
- Created: 2025-09-24T22:34:48.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-29T13:49:27.000Z (5 days ago)
- Last Synced: 2026-03-29T14:09:57.349Z (5 days ago)
- Topics: angular, bootstrap, clarity, forepath, framework, ionic, keycloak, nestjs, tsef, typescript
- Language: TypeScript
- Homepage: https://agenstra.com
- Size: 6.86 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
[](LICENSE)
[](https://nx.dev)
[](https://www.cursor.so)
[](https://www.typescriptlang.org/)
[](https://angular.io)
[](https://nestjs.com/)
# Agenstra
**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.
## What is Agenstra?
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
## Architecture
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
└─────────────────────┘
```
### Components
- **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
## Key Features
### ✅ Distributed Agent Management
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.
### ✅ Real-time AI Chat
WebSocket-based bidirectional communication with AI agents. Send messages, receive instant responses, and maintain chat history across reconnections.
### ✅ Integrated Code Editor
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.
### ✅ Automated Server Provisioning
Provision cloud servers (Hetzner Cloud, DigitalOcean) with automated Docker installation and agent-manager deployment. Configure authentication, Git repositories, and agent settings during provisioning.
### ✅ Version Control Integration
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
### ✅ Container Management
Monitor agent containers, view logs, and manage container lifecycle. Real-time container statistics and health monitoring.
### ✅ VNC Browser Access
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.
### ✅ CI/CD Pipeline Management
Configure CI/CD providers (GitHub Actions), trigger pipeline runs, monitor their status, and view logs directly from the Agenstra console.
## Quick Start
### Getting Started
1. **Set up your environment** - Follow the [Getting Started Guide](./docs/agenstra/getting-started.md) to install and configure Agenstra
2. **Create your first client** - Connect to an existing agent-manager or provision a new server
3. **Create an agent** - Set up your first AI agent and start interacting
4. **Explore features** - Use the integrated code editor, Git operations, and chat interface
## Documentation
### Getting Started
- [Getting Started Guide](./docs/agenstra/getting-started.md) - Your entry point to Agenstra
- [Local Development](./docs/agenstra/deployment/local-development.md) - Setting up for local development
### Architecture
- [System Overview](./docs/agenstra/architecture/system-overview.md) - High-level architecture and component relationships
- [Components](./docs/agenstra/architecture/components.md) - Detailed breakdown of all system components
- [Data Flow](./docs/agenstra/architecture/data-flow.md) - Communication patterns and data flow
### Features
- [Client Management](./docs/agenstra/features/client-management.md) - Managing remote agent-manager instances
- [Agent Management](./docs/agenstra/features/agent-management.md) - Agent lifecycle and container management
- [Server Provisioning](./docs/agenstra/features/server-provisioning.md) - Automated cloud server provisioning
- [WebSocket Communication](./docs/agenstra/features/websocket-communication.md) - Real-time bidirectional communication
- [File Management](./docs/agenstra/features/file-management.md) - File system operations in agent containers
- [Version Control](./docs/agenstra/features/version-control.md) - Git operations from the web interface
- [Web IDE](./docs/agenstra/features/web-ide.md) - Monaco Editor integration
- [Chat Interface](./docs/agenstra/features/chat-interface.md) - AI chat functionality
- [VNC Browser Access](./docs/agenstra/features/vnc-browser-access.md) - Graphical browser access via VNC
### Deployment
- [Docker Deployment](./docs/agenstra/deployment/docker-deployment.md) - Containerized deployment guide
- [Production Checklist](./docs/agenstra/deployment/production-checklist.md) - Production deployment guide
- [Environment Configuration](./docs/agenstra/deployment/environment-configuration.md) - Complete environment variables reference
### API Reference
- [API Reference](./docs/agenstra/api-reference/README.md) - Complete OpenAPI and AsyncAPI specifications
### Troubleshooting
- [Common Issues](./docs/agenstra/troubleshooting/common-issues.md) - Common problems and solutions
- [Debugging Guide](./docs/agenstra/troubleshooting/debugging-guide.md) - Debugging strategies and tools
## License
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](./LICENSE) file for the full license text.
### Sublicensed Components
The following components are sublicensed under the **GNU Affero General Public License v3.0 (AGPL-3.0)**:
- [`apps/backend-agent-manager`](./apps/backend-agent-manager/) - Backend application for agent management
- [`libs/domains/framework/backend/feature-agent-manager`](./libs/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](./apps/backend-agent-manager/LICENSE) and [feature-agent-manager library LICENSE](./libs/domains/framework/backend/feature-agent-manager/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`](./apps/backend-agent-controller/) - Backend application for agent controller
- [`libs/domains/framework/backend/feature-agent-controller`](./libs/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](./apps/backend-agent-controller/LICENSE) and [feature-agent-controller library LICENSE](./libs/domains/framework/backend/feature-agent-controller/LICENSE) files for the full BUSL-1.1 license text.
The following components are sublicensed under the **Source-Available License**:
- [`apps/frontend-portal`](./apps/frontend-portal/) - Frontend application for the public landing page
- [`libs/domains/framework/frontend/feature-portal`](./libs/domains/framework/frontend/feature-portal/) - Portal feature library
- [`apps/frontend-docs`](./apps/frontend-docs/) - Frontend application for documentation
- [`libs/domains/framework/frontend/feature-docs`](./libs/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](./apps/frontend-portal/LICENSE), [feature-portal library LICENSE](./libs/domains/framework/frontend/feature-portal/LICENSE), [frontend-docs application LICENSE](./apps/frontend-docs/LICENSE), and [feature-docs library LICENSE](./libs/domains/framework/frontend/feature-docs/LICENSE) files for the full license text.
## Contribution
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](./CONTRIBUTING.md).
---
_Built with ❤️ for developers who want to manage AI agents at scale._