AgentSea - Unite and Orchestrate AI Agents

Prerequisites

Before installing AgentSea, ensure you have the following:

Node.js: Version 18.0.0 or higher
Package Manager: npm, pnpm, or yarn
TypeScript: Version 5.0.0 or higher (recommended)

Core Package

Install the core AgentSea package using your preferred package manager:

bash

# Using pnpm (recommended)
pnpm add @lov3kaizen/agentsea-core

# Using npm
npm install @lov3kaizen/agentsea-core

# Using yarn
yarn add @lov3kaizen/agentsea-core

Types Package

Types are re-exported from @lov3kaizen/agentsea-core, but you can also install the dedicated types package for direct imports: pnpm add @lov3kaizen/agentsea-types

NestJS Integration

If you're using NestJS, install the NestJS integration package:

bash

# Install core and NestJS packages
pnpm add @lov3kaizen/agentsea-core @lov3kaizen/agentsea-nestjs

# Install peer dependencies
pnpm add @nestjs/common @nestjs/core reflect-metadata rxjs

Add-on Packages

AgentSea is a modular monorepo. Install only the packages you need — each is published under the @lov3kaizen/agentsea-* scope and is framework-agnostic:

bash

# Orchestration & routing
pnpm add @lov3kaizen/agentsea-crews      # Multi-agent crews
pnpm add @lov3kaizen/agentsea-gateway    # LLM gateway & routing

# Data & retrieval
pnpm add @lov3kaizen/agentsea-memory     # Advanced memory stores
pnpm add @lov3kaizen/agentsea-embeddings # Vector embeddings
pnpm add @lov3kaizen/agentsea-cache      # Semantic response cache
pnpm add @lov3kaizen/agentsea-structured # Zod structured output
pnpm add @lov3kaizen/agentsea-ingest     # Document ingestion
pnpm add @lov3kaizen/agentsea-prompts    # Prompt management

# Safety & evaluation
pnpm add @lov3kaizen/agentsea-guardrails # Safety & validation
pnpm add @lov3kaizen/agentsea-evaluate   # LLM evaluation
pnpm add @lov3kaizen/agentsea-redteam    # Red teaming

# Observability & operations
pnpm add @lov3kaizen/agentsea-analytics  # Conversation analytics
pnpm add @lov3kaizen/agentsea-costs      # Cost tracking
pnpm add @lov3kaizen/agentsea-debugger   # Agent debugger

# Automation & UI
pnpm add @lov3kaizen/agentsea-surf       # Computer-use agent
pnpm add @lov3kaizen/agentsea-react      # React components

Prefer the CLI? Install it globally with npm install -g @lov3kaizen/agentsea-cli and run sea code to start an agentic coding session.

API Keys

You'll need API keys from your chosen LLM provider:

Anthropic Claude

Sign up at console.anthropic.com
Navigate to API Keys section
Create a new API key
Set the environment variable:

bash

export ANTHROPIC_API_KEY=your_api_key_here

OpenAI

Sign up at platform.openai.com
Navigate to API Keys section
Create a new API key
Set the environment variable:

bash

export OPENAI_API_KEY=your_api_key_here

Environment Variables

Create a .env file in your project root:

env

# LLM Provider API Keys
ANTHROPIC_API_KEY=your_anthropic_key
OPENAI_API_KEY=your_openai_key

# Optional: Redis for persistent memory
REDIS_URL=redis://localhost:6379

# Optional: Observability
LOG_LEVEL=info
ENABLE_TRACING=true

Verify Installation

Create a simple test file to verify your installation:

typescript

import { Agent, AnthropicProvider, ToolRegistry } from '@lov3kaizen/agentsea-core';
import type { AgentConfig, AgentContext } from '@lov3kaizen/agentsea-types';

const agent = new Agent(
  {
    name: 'test-agent',
    model: 'claude-sonnet-4-20250514',
    provider: 'anthropic',
    systemPrompt: 'You are a helpful assistant.',
  },
  new AnthropicProvider(process.env.ANTHROPIC_API_KEY),
  new ToolRegistry(),
);

const response = await agent.execute('Hello!', {
  conversationId: 'test-123',
  sessionData: {},
  history: [],
});

console.log(response.content);

Run the file:

bash

# If using TypeScript
tsx test.ts

# If using Node.js with ES modules
node test.js

TypeScript Configuration

For TypeScript projects, update your tsconfig.json:

json

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true,
    "skipLibCheck": true,
    "resolveJsonModule": true
  }
}

Next Steps

Important

Never commit API keys to version control. Always use environment variables and add .env to your .gitignore file.