Installation

Package Installation

Install the SDK using your preferred package manager:

# npm
npm install @agentic-work/sdk

# yarn
yarn add @agentic-work/sdk

# pnpm
pnpm add @agentic-work/sdk

Requirements

• Node.js: 20 or higher

• TypeScript: 4.7+ (optional, for type support)

Peer Dependencies

The SDK has optional peer dependencies for specific providers:

# For Anthropic Claude
npm install @anthropic-ai/sdk

# For OpenAI
npm install openai

# For Google Gemini
npm install @google/genai

# For AWS Bedrock
npm install @aws-sdk/client-bedrock-runtime

Install only the providers you plan to use.

Environment Setup

Platform Mode

For full platform integration, set your API credentials:

# .env file
AGENTICWORK_API_ENDPOINT=https://api.agenticwork.io
AGENTICWORK_TOKEN=your-api-token

Direct Provider Mode

For direct LLM access without the platform:

# OpenAI
OPENAI_API_KEY=sk-...

# Anthropic
ANTHROPIC_API_KEY=sk-ant-...

# Azure OpenAI
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
AZURE_OPENAI_API_KEY=...
AZURE_OPENAI_API_VERSION=2024-02-01

# AWS Bedrock
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...

# Google Vertex AI
GOOGLE_PROJECT_ID=your-project
GOOGLE_LOCATION=us-central1
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

# Ollama (local)
OLLAMA_BASE_URL=http://localhost:11434

TypeScript Configuration

For TypeScript projects, ensure your tsconfig.json includes:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
    "strict": true
  }
}

Verification

Verify installation:

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

const aw = new AgenticWork({
  apiEndpoint: process.env.AGENTICWORK_API_ENDPOINT!,
  authToken: process.env.AGENTICWORK_TOKEN
});

await aw.init();
console.log('SDK initialized successfully');
console.log('User:', aw.user?.email);

Next Steps

• Quick Start - Basic usage examples

• API Reference - Complete API documentation