A web-based platform for deepagentsjs — an opinionated harness for building deep agents with filesystem capabilities, planning, and subagent delegation.
Caution
openwork gives AI agents direct access to your filesystem and the ability to execute shell commands. Always review tool calls before approving them, and only run in workspaces you trust.
Get Started
< 969D a id="user-content-get-started" class="anchor" aria-label="Permalink: Get Started" href="#get-started">- Node.js 18+
- pnpm (recommended) or npm
git clone https://github.com/langchain-ai/openwork.git
cd openwork
pnpm installStart the server and web client:
# Terminal 1: Start the backend server
cd packages/server
pnpm dev
# Terminal 2: Start the web frontend
cd packages/web
pnpm devThe server runs on http://localhost:3001 and the web app on http://localhost:5173.
Create a .env file in packages/server/:
# Required: At least one AI provider API key
ANTHROPIC_API_KEY=your-anthropic-key
OPENAI_API_KEY=your-openai-key
GOOGLE_API_KEY=your-google-key
# Optional: JWT secret for authentication (auto-generated if not set)
JWT_SECRET=your-secret-key- AI Agents - Create and manage AI agents with customizable system prompts
- App Connections - Connect external apps like WhatsApp for automated responses
- Health Monitoring - Real-time connection health status and alerts
- Webhooks - Integrate with external services via webhook events
| Provider | Models |
|---|---|
| Anthropic | Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.1, Claude Sonnet 4 |
| OpenAI | GPT-5.2, GPT-5.1, o3, o3 Mini, o4 Mini, o1, GPT-4.1, GPT-4o |
| Gemini 3 Pro Preview, Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash Lite |
- App Connection Guide - Connect WhatsApp and other apps
- Developer Integration - REST API and WebSocket events
- Adding New Apps - Build custom app adapters
- Webhook Integration - Set up webhook notifications
OpenWork is also available as a standalone desktop application:
# Run directly with npx
npx openwork
# Or install globally
npm install -g openwork
openworkTo run the Electron app from source:
cd openwork
pnpm install
pnpm run dev:electronWe welcome contributions! See CONTRIBUTING.md for guidelines.
Report bugs via GitHub Issues.
MIT — see LICENSE for details.