@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

``bash
npm install @lov3kaizen/agentsea-core


or

pnpm add @lov3kaizen/agentsea-core

or

yarn add @lov3kaizen/agentsea-core
`

Quick Start

`typescript
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

`typescript
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