Skip to content

RUNNING.md

Latest commit

 

History

History
96 lines (67 loc) · 1.75 KB

RUNNING.md

File metadata and controls

96 lines (67 loc) · 1.75 KB
Raw

Running WebPilot

Web App

npm install
cp .env.example .env.local
npm run dev

Open http://localhost:3000.

Desktop App

npm run desktop:dev

The desktop dev command starts Next.js on port 3210 by default and launches Electron against that local URL.

Desktop Packages

Build an unsigned package for the current OS:

npm run desktop:build
npm run desktop:smoke

Build a specific platform on a matching host or CI runner:

npm run desktop:build:win
npm run desktop:build:linux

Artifacts are written to desktop_dist/. Windows builds are unsigned and may show SmartScreen warnings. Linux builds are best verified on a native Linux runner or with the Package Desktop GitHub Actions workflow.

Production Server

npm run build
npm run start

Docker

docker compose up --build

The compose file mounts agent_runs/ and agent_threads/ so local history survives container restarts.

Environment

Required for cloud providers:

  • GEMINI_API_KEY for Gemini.
  • MODEL_API_KEY for OpenAI or compatible providers.
  • ANTHROPIC_API_KEY for Claude.

Optional:

  • MODEL_PROVIDER=gemini|openai|anthropic|ollama
  • MODEL_BASE_URL=...
  • MODEL_NAV_MODEL=...
  • MODEL_SYNTH_MODEL=...
  • MODEL_SYNTH_ENABLED=1
  • RUN_STORE_DIR=./agent_runs
  • THREAD_STORE_DIR=./agent_threads
  • MAX_STEPS=160
  • ALLOWED_DOMAINS=
  • CAPTURE_ARTIFACTS=1
  • BROWSER_HEADLESS=false
  • CDP_HTTP=http://127.0.0.1:9222

CLI

Run an agent task through the HTTP API:

npm run agent:cli -- "Go to https://example.com and summarize the page"

Use the local MCP test client:

npm run mcp:cli list_runs
npm run mcp:cli agent_state

Start the stdio MCP server:

npm run mcp:stdio