Overview

TypeScript SDK for building AI applications. Works standalone or with the full AgenticWork platform.

---

Two ways to use it

Platform mode connects to AgenticWork's backend. You get auth, RBAC, 150+ MCP tools, Flowise workflows, and observability out of the box. Good for teams that want the full stack.

Direct mode talks straight to LLM providers. No platform overhead, just provider connections. Good for simpler use cases or when you want full control.

---

Install

npm install @agentic-work/sdk

Requires Node.js 20+.

---

Platform mode

import { AgenticWork } from '@agentic-work/sdk';

const aw = new AgenticWork({
  apiEndpoint: 'https://api.agenticwork.io',
  authToken: process.env.AGENTICWORK_TOKEN
});

await aw.init();

const response = await aw.complete({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }]
});

console.log(response.choices[0].message.content);

Direct mode

import { createProvider } from '@agentic-work/sdk/providers';

const provider = createProvider({
  type: 'openai',
  apiKey: process.env.OPENAI_API_KEY
});

const response = await provider.complete({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }]
});

Streaming

for await (const chunk of aw.streamComplete({
  model: 'claude-3-5-sonnet',
  messages: [{ role: 'user', content: 'Write a poem' }]
})) {
  if (chunk.type === 'text_delta') {
    process.stdout.write(chunk.text);
  }
}

Agents with tools

const agent = aw.createAgent({
  model: 'gpt-4o',
  tools: aw.getMCPTools(),
  maxIterations: 10
});

for await (const text of agent.run({
  prompt: 'Create a hello world app in Python'
})) {
  process.stdout.write(text);
}

---

Providers

Provider	Type	What you get
Anthropic	anthropic	Claude 3.5 Sonnet, Opus, Haiku
OpenAI	openai	GPT-4o, GPT-4 Turbo, o1
Google	google	Gemini 2.0, 1.5 Pro/Flash
Azure OpenAI	azure-openai	OpenAI models via Azure
AWS Bedrock	bedrock	Claude, Llama, Titan
Ollama	ollama	Local models

---

More docs

• Installation

• Quick Start

• API Reference

• Agents

• Providers

• Tools

• Streaming

• Platform Integration

• Types Reference