PulseStack

Prerequisites

Before getting started, ensure the following tools are installed:

• 📦 Node.js 20+
• ⚡ pnpm
• 🐳 Docker

---

2️⃣ Install Dependencies

pnpm install

Environment Setup

Create a .env file from the example file:

Docker services not starting

Ensure Docker Desktop is running before executing:

docker compose -f infra/docker/docker-compose.yml up -d

Docker command not found

Ensure Docker Desktop is installed and running before starting infrastructure services.

📝 Example Workflow Payload

The following example demonstrates a simple AI workflow consisting of an Agent → Tool → LLM execution chain.

 id="qomqyi"
Plan Agent
    │
    ▼
Fetch Logs
    │
    ▼
Summarize with LLM

 id="y2wcfb"
{
  "workflow": {
    "id": "wf_agent_ops",
    "name": "Agent Ops",
    "version": "1.0.0",
    "tenantId": "local",
    "correlationId": "corr_agent_ops",
    "metadata": {},
    "steps": [
      {
        "id": "s1",
        "name": "Plan",
        "kind": "agent",
        "dependsOn": [],
        "input": {
          "objective": "inspect queue health"
        }
      },
      {
        "id": "s2",
        "name": "FetchLogs",
        "kind": "tool",
        "dependsOn": ["s1"],
        "retry": {
          "maxAttempts": 3,
          "backoffMs": 250,
          "maxBackoffMs": 2000,
          "exponential": true
        },
        "input": {
          "tool": "logs.query",
          "range": "15m"
        }
      },
      {
        "id": "s3",
        "name": "Summarize",
        "kind": "llm",
        "dependsOn": ["s2"],
        "input": {
          "model": "gpt-4.1",
          "prompt": "Summarize anomalies"
        }
      }
    ]
  },
  "input": {
    "environment": "prod"
  },
  "initiatedBy": "operator"
}

3️⃣ Start Development Environment

```bash pnpm dev

Environment Variables

A sample .env.example file is included with default local development values.

Troubleshooting