Brahmando logo
BrahmandoAI Marketplace

Documentation

Learn how to use Brahmando - deploy agents, connect MCP servers, build workflows.

Quick Start

  1. Clone the repo from GitHub
  2. Copy .env.example to apps/web/.env.local and fill in your API keys
  3. Run cd apps/web && npm install && npm run dev
  4. Open http://localhost:3000

Architecture Overview

Brahmando is split into three layers: the frontend (Next.js, static exportable), the agent layer (FastAPI MCP servers + agent registry), and the workflow layer (n8n + YAML pipelines).

Adding an Agent

  1. Add an entry to /agents/registry.json
  2. Create a YAML definition in /agents/examples/
  3. Optionally create an MCP server in /mcp-servers/
  4. The frontend automatically picks up new agents from the registry

Deploying MCP Servers

Each server in /mcp-servers/ is a FastAPI app. Deploy to Railway, Fly.io, or any container platform. Set NEXT_PUBLIC_API_BASE_URL to point the SDK to your live servers.

Brand & Design System

All brand tokens live in /packages/ui/branding.ts. To swap logos, add SVG/PNG files to /public/branding/ and update the paths in the branding config.