TDForge App
🚀
TDForge App is a complete Super Agent application built on top of TDForge Harness. It packages the runtime capabilities into a ready-to-deploy product with a web UI, API gateway, and operational tooling.
TDForge App is the reference implementation of what a production TDForge experience looks like. It assembles the Harness runtime, a web-based conversation workspace, an API gateway, and a reverse proxy into a single deployable system.
What the App provides
| Capability | Description |
|---|---|
| Web workspace | Browser-based conversation UI with support for threads, artifacts, file uploads, and skill selection |
| Custom agents | Create and manage named agents with different models, skills, and tool sets |
| Thread management | Persistent conversation threads with checkpointing and history |
| Streaming responses | Real-time token streaming with thinking steps and tool call visibility |
| Artifact viewer | In-browser preview and download of files and outputs produced by the agent |
| Extensions UI | Enable/disable MCP servers and skills without editing config files |
| Gateway API | FastAPI-based REST API with the embedded LangGraph-compatible agent runtime |
Architecture
The TDForge App runs behind a single nginx reverse proxy:
┌──────────────────┐
Browser → │ nginx :2026 │
└──────────────────┘
│ │
┌────────┘ └────────┐
▼ ▼
┌──────────────────┐ ┌──────────────────────┐
│ Frontend :3000 │ │ Gateway API :8001 │
│ (Next.js) │ │ (FastAPI) │
└──────────────────┘ └──────────────────────┘- nginx: routes requests —
/api/*and/api/langgraph/*to Gateway, and everything else to the frontend. - Frontend (Next.js + React): the browser UI. Communicates with Gateway.
- Gateway (FastAPI): handles API operations and the embedded LangGraph-compatible runtime for thread state, agent execution, and streaming.
Technology stack
| Layer | Technology |
|---|---|
| Frontend | Next.js 16, React 19, TypeScript, pnpm |
| Gateway | FastAPI, Python 3.12, uvicorn |
| Agent runtime | LangGraph, LangChain, TDForge Harness |
| Reverse proxy | nginx |
| State persistence | Gateway runtime + optional SQLite/PostgreSQL checkpointer |