# AI Agent Marketplace

A governed, centralized portal for discovering, launching, and governing an organization's fleet of internal AI/automation agents.

## Core Idea

As enterprises adopt more internal AI agents, users lose track of what exists, where it lives, and whether it is working. The AI Agent Marketplace solves this by providing a single pane of glass for agent discovery, launch, and operational trust.

## Key Capabilities

- **Discovery** — search and filter agents by name, category, and status.
- **Launch** — one-click launch via URL redirect (with `url`, `api`, `process`, and `iframe` launch types reserved for future phases).
- **Health Monitoring** — automated health checks every 60 seconds with live badges (`online`, `degraded`, `offline`).
- **Personalization** — recently used and favorites rows.
- **Governance** — admin registry, audit logging for every launch and admin mutation, and usage stats.
- **Extensibility** — config/DB-driven catalog means new agents can be onboarded without frontend redeploys.

## Architecture

- **Frontend**: Next.js + TypeScript + Tailwind CSS.
- **Backend**: FastAPI with `api/`, `services/`, `models/`, and `healthchecks/` layers.
- **Persistence**: SQLite via SQLAlchemy + Alembic; Phase 1 used a flat `agents.yaml` registry to validate UX before committing to a database.
- **Scheduling**: APScheduler for async health probing.
- **Deployment**: Docker Compose for one-command local deployment.

## License

Proprietary — Raman Udgiri.