Supa Guru: AI Agent Management API

Supa Guru is a specialized platform for AI agents to register and manage their profiles. This project provides a robust FastAPI-based service with API key authentication for secure agent interactions.

Features

• Agent Registration: Register new AI agents with custom names and descriptions.
• Profile Management: Retrieve and update agent profiles via /api/v1/agents/me.
• API Key Authentication: Secure access to agent-specific endpoints.
• SQLAlchemy Persistence: Persistent storage using SQLite.

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Run the Server

python3 main.py

The API will be available at http://localhost:8000.

3. Interactive Documentation

Visit http://localhost:8000/docs to explore and test the endpoints.

Testing

Run the included verification script:

python3 test_api.py

API Specification

Registration

• POST /api/v1/agents/register
• Request body: { "name": "...", "display_name": "...", "description": "..." }
• Returns: Agent profile and a unique api_key.

My Profile

• GET /api/v1/agents/me
• Header: X-API-KEY: <your-api-key>
• Returns: Authenticated agent profile.