Quickstart

Prerequisites

Before you begin, make sure you have the following installed:

Python 3.10+

Required for backend agent runtime

Node.js 18+

Required for dashboard and CLI tools

You’ll also need:

A MINDBLIX account (sign up here)
An API key (available from your dashboard)

Step 1: Clone the Repository

git clone https://github.com/Dolphin-Syndrom/Multi-AI-Agent-System.git
cd Multi-AI-Agent-System

Step 2: Set Up the Backend

Navigate to Backend

cd backend

Install Dependencies

We use uv for fast Python dependency management:

pip install uv
uv sync

Configure Environment

Copy the example environment file and add your API keys:

cp .env.example .env

Edit .env with your configuration:

GEMINI_API_KEY=your_gemini_api_key
DATABASE_URL=your_database_url
JWT_SECRET=your_jwt_secret

Start the Server

uv run uvicorn app.main:app --reload --port 8000

You should see: Uvicorn running on http://127.0.0.1:8000

Step 3: Set Up the Dashboard

Navigate to Dashboard

cd ../frontend-dashboard

Install Dependencies

npm install

Start the Dashboard

npm run dev

Dashboard available at http://localhost:3000

Step 4: Deploy Your First Agent

Once both backend and dashboard are running, you can deploy your first agent:

Via Dashboard
Via API
Via Python SDK

Open http://localhost:3000 in your browser
Navigate to Agents → Create New
Select a template (e.g., Research Agent)
Configure the agent parameters
Click Deploy

curl -X POST http://localhost:8000/api/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Research Agent",
    "template": "research",
    "config": {
      "model": "gemini-1.5-flash",
      "max_iterations": 5
    }
  }'

from mindblix import MindBlix

client = MindBlix(api_key="YOUR_API_KEY")

agent = client.agents.create(
    name="My Research Agent",
    template="research",
    config={
        "model": "gemini-1.5-flash",
        "max_iterations": 5
    }
)

print(f"Agent deployed: {agent.id}")

What’s Next?

Architecture Overview

Deep dive into how MINDBLIX works under the hood.

Core Concepts

Learn about agents, workflows, and orchestration patterns.

Create Custom Agents

Build your own specialized agents from scratch.

API Reference

Explore the full API documentation.

Getting Started

Core Concepts

Guides

Agent Catalog

Prerequisites

Python 3.10+

Node.js 18+

Step 1: Clone the Repository

Step 2: Set Up the Backend

Step 3: Set Up the Dashboard

Step 4: Deploy Your First Agent

What’s Next?

Architecture Overview

Core Concepts

Create Custom Agents

API Reference

​Prerequisites

Python 3.10+

Node.js 18+

​Step 1: Clone the Repository

​Step 2: Set Up the Backend

​Step 3: Set Up the Dashboard

​Step 4: Deploy Your First Agent

​What’s Next?

Architecture Overview

Core Concepts

Create Custom Agents

API Reference

Prerequisites

Step 1: Clone the Repository

Step 2: Set Up the Backend

Step 3: Set Up the Dashboard

Step 4: Deploy Your First Agent

What’s Next?