Weavr

Starting the Server

Launch the Weavr server to access the web interface and API.

node weavr.mjs serve

Open http://localhost:3847 in your browser.

Build first: Make sure you've run npm run build:web before starting the server.

Dashboard

The dashboard provides a comprehensive overview of your Weavr instance:

Weavr Dashboard

Key Features

  • AI Model - Shows your configured AI provider, model, and authentication status
  • Token Usage - Tracks input/output tokens and API requests across all AI operations
  • Workflows - Displays active, paused, and total workflow counts with success rate
  • Active Workflows - Lists deployed workflows with status, triggers, and quick actions (Run Now, Pause, Resume)
  • Recent Runs - Shows latest workflow executions with status and duration
  • Quick Actions - One-click access to create workflows, view all workflows, or access settings
Real-time updates: The dashboard automatically refreshes when workflows run, showing live status via WebSocket connection.

Workflows

The Workflows page lets you manage your workflow definitions:

Viewing Workflows

Browse all workflows loaded from your workflows directory. Click a workflow to see its YAML definition and configuration.

Creating Workflows

Create new workflows directly in the web UI with the built-in YAML editor.

Running Workflows

Execute any workflow with optional input data. The UI shows real-time execution progress.

Run History

View the execution history of all workflows:

  • Status - Success, failed, or running
  • Duration - How long the run took
  • Step details - Individual step outputs and errors
  • Logs - Full execution logs for debugging

Chat Interface

Interact with an AI agent directly from the web UI. The chat interface supports multi-turn conversations and can execute workflows on your behalf.

Requires AI provider: Configure an Anthropic or OpenAI API key to use the chat feature.

REST API

The server exposes a REST API for programmatic access.

Endpoints

Method Endpoint Description
GET /api/workflows List all workflows
POST /api/workflows Create a workflow
GET /api/workflows/:name Get workflow details
POST /api/workflows/:name/run Execute a workflow
GET /api/runs List all runs
GET /api/runs/:id Get run details
GET /api/config/status Check configuration status
GET /api/stats Get dashboard stats (AI config, token usage, workflow counts)

Examples

List Workflows

curl http://localhost:3847/api/workflows

Run a Workflow

curl -X POST http://localhost:3847/api/workflows/hello-world/run \
  -H "Content-Type: application/json" \
  -d '{}'

Run with Input Data

curl -X POST http://localhost:3847/api/workflows/process-data/run \
  -H "Content-Type: application/json" \
  -d '{"input": {"file": "data.csv"}}'

Create a Workflow

curl -X POST http://localhost:3847/api/workflows \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-workflow",
    "yaml": "name: my-workflow\nsteps:\n  - id: greet\n    action: log\n    with:\n      message: Hello!"
  }'

Check Run Status

curl http://localhost:3847/api/runs/run_abc123