PengBao AI App

🚀

PengBao AI App is a complete Super Agent application built on top of PengBao AI Harness. It packages the runtime capabilities into a ready-to-deploy product with a web UI, API gateway, and operational tooling.

PengBao AI App is the reference implementation of what a production PengBao AI 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 that bridges the frontend and the LangGraph runtime

Architecture

The PengBao AI App runs as four services behind a single nginx reverse proxy:


                ┌──────────────────┐
     Browser → │  nginx :2026      │
                └──────────────────┘
                  │          │
         ┌────────┘          └────────┐
         ▼                            ▼
┌──────────────────┐       ┌──────────────────────┐
│  Frontend :3000  │       │  Gateway API :8001    │
│  (Next.js)       │       │  (FastAPI)            │
└──────────────────┘       └──────────────────────┘
                                      │
                            ┌─────────┘
                            ▼
                  ┌──────────────────────┐
                  │  LangGraph :2024     │
                  │  (PengBao AI Harness)  │
                  └──────────────────────┘

nginx: routes requests — /api/* to the Gateway, LangGraph streaming endpoints to LangGraph directly, and everything else to the frontend.
Frontend (Next.js + React): the browser UI. Communicates with both the Gateway and LangGraph.
Gateway (FastAPI): handles API operations — model listing, agent CRUD, memory, extensions management, file uploads.
LangGraph: the PengBao AI Harness runtime. Manages 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, PengBao AI Harness
Reverse proxy	nginx
State persistence	LangGraph Server (default) + optional SQLite/PostgreSQL checkpointer

Quick Start Deployment Guide