FS Labs API Architecture

System Overview

Monorepo where each root folder is a product. Products are independently runnable Node.js (and related) applications.

Architecture Diagram

graph TB
    MonorepoRoot["fs-labs-api monorepo<br/>root"]
    SipsageProduct["sipsage / cocktailBot"]
    PizzaBotProduct["pizza-bot"]
    MultiAgentProduct["multiAgentSystem"]
    OtherLabsProducts["other labs products"]

    MonorepoRoot -->|"contains product folder"| SipsageProduct
    MonorepoRoot -->|"contains product folder"| PizzaBotProduct
    MonorepoRoot -->|"contains product folder"| MultiAgentProduct
    MonorepoRoot -->|"contains product folder"| OtherLabsProducts

How to read this diagram

Arrows mean flow / dependency / "talks to", not button clicks. Each arrow label says what happens on that step.

Design Decisions

• Product isolation by folder (own dependencies)
• Experiments can differ in stack (Node vs Python services) inside the labs umbrella

Technology Stack

Layer	Technology
Monorepo layout	Product folders at root
Typical app	Node.js / TypeScript
Highlighted API	Sipsage (FastAPI + Swagger + HF hosting per KT notes)

Next Steps

• API Reference
• Getting Started
• Overview