Documentation

Get started with Talovi

npm install talovi

Quick start

import { createAgent } from "talovi";

const agent = createAgent({
  provider: "claude",
  apiKey: process.env.ANTHROPIC_API_KEY,
});

const result = await agent.run("Summarize this document", { input: doc });
console.log(result.output);

Model tiers

ProviderModelBest for
Claudeclaude-sonnet-4-6Reasoning, code, analysis
Geminigemini-2.0-flashSpeed, multimodal
Grokgrok-3Real-time web data
Ollamallama3.2Local, offline, private

Agents

Talovi ships five built-in agents. Each agent is provider-agnostic — swap the provider config without changing agent logic.

  • RoutingAgent — classifies intent and dispatches to the right specialist
  • ResearchAgent — multi-step web research with citation tracking
  • CodeAgent — code generation, review, and refactoring
  • SummaryAgent — long-document condensing with configurable detail level
  • ChatAgent — stateful conversational agent with memory

Provider switching

// Switch providers without changing agent code
const agent = createAgent({
  provider: process.env.AI_PROVIDER ?? "claude",
  apiKey: process.env.AI_API_KEY,
});