Skip to content
Agent SDK

Installation

Installation

Section titled “Installation”

Prerequisites

Section titled “Prerequisites”
  • Node.js >= 20
  • pnpm >= 9 (or npm/yarn)

Install from Monorepo

Section titled “Install from Monorepo”

If you’re working in the agent-sdk monorepo:

Terminal window
pnpm install
pnpm build
pnpm test

Environment Setup

Section titled “Environment Setup”

Set your API key to get started:

Terminal window
# Recommended: OpenRouter (routes to any model)
export OPENROUTER_API_KEY=sk-or-...


# Or use OpenAI directly
export OPENAI_API_KEY=sk-...


# For local models via Ollama
export OLLAMA_ENABLED=true

Project Structure

Section titled “Project Structure”
agent-sdk/
├── packages/
│   ├── sdk/           # @agntk/core — Core agent factory
│   ├── cli/           # @agntk/cli — CLI agent
│   ├── sdk-server/    # @agntk/server — HTTP server
│   ├── sdk-client/    # @agntk/client — Client library
│   ├── logger/        # @agntk/logger — Structured logging
│   └── agntk/         # agntk — npx wrapper
├── apps/
│   └── docs/          # Documentation site
└── tests/
    └── integration/   # Integration tests (156 tests)

Optional Dependencies

Section titled “Optional Dependencies”

Temporal (for Durable Workflows)

Section titled “Temporal (for Durable Workflows)”

For production durable workflows, set up a Temporal server. See the Durable Agents guide for details.

Next Steps

Section titled “Next Steps”