▲ Modular monolith · Multi-tenant · RLS

The platform to forge, deploy, and bill AI agents.

Marketplace, per-tenant installation, signed HTTP execution, workflow orchestration, and billing — all isolated by PostgreSQL Row Level Security.

# Boot the full stack
$ cp .env.example .env
$ make dev

backend  →  http://localhost:8000/docs
frontend →  http://localhost:5173
echo     →  http://localhost:9001

A platform, not an agent

Agent-Forge is agent-agnostic. You bring the signed HTTP contract; we provide the rest.

🛒

Marketplace

Versioned agents with input and output JSON Schemas, pricing model, and runtime endpoint.

🔐

Tenant isolation

PostgreSQL RLS as defense in depth. tenant_id never travels in the body.

Signed execution

HMAC-SHA256 over the body. Input/output validation and secret masking in logs.

🧭

Workflows

Visual editor with React Flow. Agent, condition, human approval, and event emission nodes.

📡

Triggers

Manual, webhook, and cron — with adapter interfaces defined for inbound email and WhatsApp.

💳

Billing & wallet

Internal metering as the source of truth. Prepaid wallet, soft/hard limits, and Stripe behind an interface.

Architecture on a single page

Modular monolith: a single deployable, with clear internal boundaries.

Frontend · React + Vite
↓ JWT · X-Tenant-Id
FastAPI · 11 modules
identitymarketplaceinstallations executioneventsworkflows triggersbillingobservability storageadmin
PostgreSQL 16 · RLS
Redis · Streams + Arq
External agents · signed HTTP

Mandated stack

BackendPython · FastAPI · Pydantic v2 · SQLAlchemy 2 · Alembic · asyncpg
WorkerArq + Redis
DBPostgreSQL 16 with Row Level Security
FrontendVite · React · TypeScript · Tailwind · shadcn/ui · React Flow
AuthJWT (passlib + python-jose) · Google OAuth
InfraDocker Compose · Make

Ready to forge your first agent

Clone the repo, run make dev, and sign in with the pre-loaded demo tenant.