Warp-Five

A self-hosted, pure TypeScript AI orchestrator built on @openai/agents.

Warp-Five replaces the legacy Python-based orchestration engine with a blazing-fast, strictly typed Node.js/TypeScript orchestrator. Powered natively by the highly robust @openai/agents framework, Warp-Five manages parallel reasoning threads, execution boundaries, and state memory synchronization up to 10x faster than legacy pipelines.

---

🏗 Architecture V5

The V5 stack shifts the orchestrator's central loop to Node, pairing it dynamically with the FastAPI chat interface for lightning-fast SSE event routing.

┌─────────────────────────────────────────────────────────┐
│                    Chat UI (FastAPI)                     │
│       Frontend Routing · SSE Streaming · Artifact UI     │
└────────────────────┬────────────────────────────────────┘
                     │ Redis Pub/Sub
┌────────────────────▼────────────────────────────────────┐
│                  TS Orchestrator                         │
│                                                         │
│  Conductor (Runner.ts)                                  │
│    → Distributes jobs via `transfer_to_Fast`            │
│    → Deep-hooks into `@openai/agents` event loops       │
│                                                         │
│  Code Pipeline & Agent Mesh                             │
│    → Deep reasoning with native Docker tools            │
│    → Parallel artifact synchronizers (`read_artifact`)  │
│    → Zero-latency context resolution (`utilities.ts`)   │
│                                                         │
│  Redis A (sessions) · Redis B (jobs/signals)            │
│  ChromaDB (semantic persistence)                        │
└─────────────────────────────────────────────────────────┘

---

🛠 Active TypeScript Tools

All agentic capabilities have been rebuilt as high-performance TypeScript tool closures in Configs/orchestrator-ts/src/tools/.

Core Module	Exposed Schema Callables	Purpose
sandbox.ts	execute_code	Spawns sandboxed Docker containers to evaluate raw Python/JS strings.
artifacts.ts	read_artifact, update_artifact	Synchronize generated files physically between the AI context and user chat UI.
search.ts	web_search_with_summary	Direct semantic search augmentation API.
memory.ts	memory_search, save_user_fact	Embedded user vectors directly inside ChromaDB.
utilities.ts	read_file, summarize_text, current_datetime	System IO wrappers. Includes integrated fuzzy-search fallback mechanisms.
clarify.ts	ask_user	Suspends execution and natively polls the user UI for mid-thought clarifications.

---

🚀 Quick Start

1. Zero-Friction Clone

git clone https://github.com/josephang/warp-five.git
cd warp-five

2. Environment Configurations

Configure your model keys and domains.

cp Configs/.env.example Configs/.env
# Drop your LITELLM / OpenAI keys inside .env

3. Spin Up Docker

Warp-Five handles all Node.js and Python environments in composed isolation.

cd Configs
docker compose up -d --build

Note: chat-ui handles web rendering at http://localhost:2830, while orchestrator powers the active Node execution bus.

---

🧹 Legacy Migration

If you are moving from Warp-One or Warp-Four, be aware that smolagents and the Python multi-agent pipeline have been fully archived! The new structure prioritizes deterministic strict-typing over Python reflection loops.