genai-agentos
GenAI infrastructure
GenAI AgentOS is a comprehensive infrastructure platform for deploying and managing AI agents at scale. The system provides a full-stack environment including PostgreSQL database, Redis caching, Celery task queue, REST API backend, web frontend, and CLI tools. It supports three agent protocol types: native GenAI agents via the genai-protocol library, MCP (Model Context Protocol) servers, and A2A (Agent to Agent Protocol) servers. Developers can register custom agents, manage them through a web UI or CLI, and expose them via WebSocket endpoints for real-time communication.
Key Features
Use Cases
- 01Building and deploying custom GenAI agents that communicate via the genai-protocol library
- 02Integrating external MCP servers into a unified agent orchestration platform
- 03Creating agent-to-agent communication networks using A2A protocol servers
- 04Developing multi-agent systems with centralized management and monitoring
- 05Exposing local AI agents to external services via Ngrok WebSocket tunnels
- 06Prototyping agent workflows with Docker-based local development environment
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
genai-agentos — FAQ
What is GenAI AgentOS?+
GenAI AgentOS is a complete infrastructure platform for running and managing AI agents. It supports three agent types: native GenAI agents, MCP servers, and A2A protocol servers, all orchestrated through a unified backend with web UI and CLI tools.
How do I install and run GenAI AgentOS locally?+
Clone the repository, copy the .env-example file to .env, ensure Docker Desktop is running, then execute 'make up' or 'docker compose up'. The frontend will be available at localhost:3000 and the API at localhost:8000.
What prerequisites do I need to run this platform?+
You need Docker, Docker Compose, and optionally Make installed on your system. For AI model access, you'll need an OpenAI API key for GPT-4o. Ngrok is optional for exposing local agents publicly.
How do I add MCP servers to GenAI AgentOS?+
MCP servers can be added through the web UI by pasting their full URL (e.g., http://host.docker.internal:8000/mcp). The MCP server must support the streamable-http protocol and be remotely accessible.
Is GenAI AgentOS free to use?+
Yes, GenAI AgentOS is open source under the MIT license and free to use. However, you'll incur costs from third-party services like OpenAI API usage.
Can I connect this platform to Claude Desktop or other AI clients?+
GenAI AgentOS is a standalone agent infrastructure platform rather than an MCP server for AI clients like Claude Desktop. It serves as a host environment for managing multiple agents and MCP servers together.
How do I install genai-agentos?+
Open the source repository on GitHub and follow its README. genai-agentos is a agent — MCP Agents Market links you directly to the official repo.
Is genai-agentos free?+
genai-agentos is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.