Quick Start Guide

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

import { Agent, AnthropicProvider, ToolRegistry, BufferMemory, calculatorTool } from '@lov3kaizen/agentsea-core';
const provider = new AnthropicProvider(process.env.ANTHROPIC_API_KEY);
const toolRegistry = new ToolRegistry();
toolRegistry.register(calculatorTool);
const agent = new Agent({
  name: 'my-assistant',
  model: 'claude-sonnet-4-20250514',
  provider: 'anthropic',
  systemPrompt: 'You are a helpful assistant.',
  tools: [calculatorTool],
}, provider, toolRegistry, new BufferMemory(50));
const response = await agent.execute('What is 42 * 58?', context);

import { Agent, OllamaProvider, ToolRegistry, BufferMemory } from '@lov3kaizen/agentsea-core';
// No API key needed - runs 100% locally!
const provider = new OllamaProvider({
  baseUrl: 'http://localhost:11434',
  model: 'llama3.2' // or mistral, gemma2, qwen2.5, etc.
});
const agent = new Agent({
  name: 'local-assistant',
  model: 'llama3.2',
  provider: 'ollama',
  systemPrompt: 'You are a helpful assistant running locally.',
}, provider, new ToolRegistry(), new BufferMemory(50));
const response = await agent.execute('Hello!', context);

import { Agent, AnthropicProvider, ToolRegistry, MCPRegistry } from '@lov3kaizen/agentsea-core';
const mcpRegistry = new MCPRegistry();
await mcpRegistry.addServer({
  name: 'filesystem',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'],
});
const mcpTools = mcpRegistry.getTools();
const toolRegistry = new ToolRegistry();
toolRegistry.registerMany(mcpTools);
const agent = new Agent(config, new AnthropicProvider(), toolRegistry);
const response = await agent.execute('List the files in /tmp', context);

import { WorkflowFactory, AnthropicProvider, ToolRegistry } from '@lov3kaizen/agentsea-core';
const workflow = WorkflowFactory.create({
  name: 'research-workflow',
  type: 'sequential',
  agents: [
    { name: 'researcher', systemPrompt: 'Research information.' },
    { name: 'writer', systemPrompt: 'Write a summary.' },
  ],
}, new AnthropicProvider(), new ToolRegistry());
const result = await workflow.execute('Research AI agents', context);