@lov3kaizen/agentsea-core

Unite and orchestrate AI agents - Framework-agnostic core library for building agentic AI applications in Node.js.

Features

• Multi-Provider Support - Anthropic Claude, OpenAI GPT, Google Gemini
• Local & Open Source Models - Ollama, LM Studio, LocalAI, Text Generation WebUI, vLLM
• Voice Support (TTS/STT) - OpenAI Whisper, ElevenLabs, Piper TTS
• MCP Protocol - First-class Model Context Protocol integration
• ACP Protocol - Agentic Commerce Protocol for e-commerce integration
• Multi-Agent Workflows - Sequential, parallel, and supervisor orchestration
• Conversation Schemas - Structured conversational experiences with validation
• Advanced Memory - Buffer, Redis, and summary-based memory stores
• Built-in Tools - 8 production-ready tools + custom tool support
• Full Observability - Logging, metrics, and distributed tracing

Installation

npm install @lov3kaizen/agentsea-core
# or
pnpm add @lov3kaizen/agentsea-core
# or
yarn add @lov3kaizen/agentsea-core

Quick Start

import {
  Agent,
  AnthropicProvider,
  ToolRegistry,
  BufferMemory,
  calculatorTool,
} from '@lov3kaizen/agentsea-core';

// Create agent
const agent = new Agent(
  {
    name: 'assistant',
    model: 'claude-sonnet-4-20250514',
    provider: 'anthropic',
    systemPrompt: 'You are a helpful assistant.',
    tools: [calculatorTool],
  },
  new AnthropicProvider(process.env.ANTHROPIC_API_KEY),
  new ToolRegistry(),
  new BufferMemory(50),
);

// Execute
const response = await agent.execute('What is 42 * 58?', {
  conversationId: 'user-123',
  sessionData: {},
  history: [],
});

console.log(response.content);

Multi-Provider Support

import {
  GeminiProvider,
  OpenAIProvider,
  AnthropicProvider,
  OllamaProvider,
} from '@lov3kaizen/agentsea-core';

// Use any provider
const geminiAgent = new Agent(config, new GeminiProvider(apiKey), toolRegistry);
const openaiAgent = new Agent(config, new OpenAIProvider(apiKey), toolRegistry);
const claudeAgent = new Agent(
  config,
  new AnthropicProvider(apiKey),
  toolRegistry,
);
const ollamaAgent = new Agent(config, new OllamaProvider(), toolRegistry);

Documentation

Full documentation available at agentsea.dev

• Quick Start
• Agents
• Tools
• Workflows
• Memory
• MCP Integration
• API Reference

Related Packages

• @lov3kaizen/agentsea-cli - Command-line interface
• @lov3kaizen/agentsea-nestjs - NestJS integration
• @lov3kaizen/agentsea-react - React components

License

MIT License - see LICENSE for details