Complete Technology Stack

Frontend

Framework Next.js 15+ (App Router)
Language TypeScript 5+
UI Library shadcn/ui components
Icons Remix Icons (react-icons/ri)
State Management React Query, Zustand
Styling Tailwind CSS
Forms React Hook Form + Zod
Real-time Server-Sent Events (SSE)

Backend

Framework FastAPI 0.115+
Language Python 3.11+
Async Processing Dramatiq 1.18+
Database Client Supabase Python Client 2.17+
Validation Pydantic 2.x
LLM Gateway LiteLLM 1.72+
HTTP Client httpx (async)

Infrastructure

Database Supabase (PostgreSQL)
Cache/Queue Redis 8+
Storage Supabase Storage / S3/R2
Containerization Docker, Docker Compose
Monitoring Sentry (error tracking)
Tracing Langfuse (LLM observability)

External Services

LLM Providers OpenAI, Anthropic, Google
Payments Stripe
Search Tavily, Firecrawl
Email Transactional email service

Communication Patterns

REST API

Protocol: HTTP/HTTPS
Methods: GET, POST, PUT, PATCH, DELETE
Authentication: JWT tokens (Bearer)
Content Type: JSON
Use Cases: CRUD operations, file uploads, configuration

Server-Sent Events (SSE)

Protocol: HTTP with text/event-stream
Use Cases: Real-time agent responses, live updates
Endpoint: /agent-run/{id}/stream
Features: Automatic reconnection, event-based messaging

Background Jobs

Protocol: Redis-based message queue
Use Cases: Long-running agents, file processing
Pattern: Producer-Consumer with Redis broker
Features: Retry logic, job prioritization, distributed execution

Real-time Subscriptions

Protocol: Supabase Realtime (WebSocket)
Use Cases: Live database updates, collaborative features
Features: Row-level subscriptions, channel-based messaging