Skip to main content

alphaswarm-api

Catalog date: 2026-06-24.

alphaswarm-api is the consolidated API Gateway for the AlphaSwarm platform. it serves as the unified entrypoint for cross-service routing, schema discovery, and edge authentication.

Role​

  • Unified Entrypoint: Provides a single host for all platform REST and WebSocket APIs.
  • Service Routing: Proxies requests to internal microservices (FinOps, KB, Graph, Controller) based on path prefixes.
  • Schema Discovery: Aggregates OpenAPI specs from all registered services into a central catalog.
  • Auth Enforcement: Validates Bearer tokens and injects tenancy/identity headers before forwarding requests to internal services.

Architecture​

The gateway is built on FastAPI and uses httpx for high-performance async proxying. It integrates with the tenant_router for edge-auth and uses alphaswarm_core for IAM scope resolution.

Repository​