Command Palette

Search for a command to run...

Page Inspect

https://voltagent.dev/
Internal Links
35
External Links
9
Images
5
Headings
15

Page Content

Title:VoltAgent - Open Source TypeScript AI Agent Framework
Description:VoltAgent is an observability-first TypeScript AI Agent framework.
HTML Size:678 KB
Markdown Size:16 KB
Fetched At:November 17, 2025

Page Structure

h2Open Source
h1TypeScript AI AgentFramework
h2Used and Tested by Developers at
h2Enterprise-level AI agents
h2Fast Growing Community
h2Intelligent Coordination
h2Workflow Chain API
h2RAG
h2INTEGRATIONS
h2Easily connect with 40+ apps in no time
h2Blog
h3Building Google Drive Chatbot with Composio MCP
h3Vercel AI LLM Observability
h3TypeScript AI Agent Framework
h2Community

Markdown Content

VoltAgent - Open Source TypeScript AI Agent Framework

Skip to main content

šŸš€ Launch Week 2 is live – New features dropping daily

voltagent

Products

VoltAgent Core Framework

VoltOps LLM Observability

Marketplace

Deployment

Soon

Agentic App Builder

Soon

VoltAgent DocsVoltOps DocsCustomers

Use Cases

HR Agent

Customer Support Agent

Sales Teams

Finance Agent

Development Agent

Marketing Agent

Legal Agent

Insurance Agent

Industrial Agent

Education Agent

Government Agent

Documentation Agent

Resources

5 Steps Tutorial

Learn AI agent development in 5 steps

Examples

Explore sample projects and code

MCP Directory

Browse Model Context Protocol services

Blog

Read the technical blog

About Us

Learn more about VoltAgent

Launch Week #2

Explore our product launch updates

GitHub Logo

✨

Decorative dot pattern background

## Open Source
# TypeScript AI AgentFramework

Escape no-code limits and scratch-built overhead. Build, customize, and orchestrate AI agents with full control, speed, and a great DevEx.

Get Started$npm create voltagent-app@latest

Prompts

API Calls

Webhooks

Context

VoltAgent

AI Resp.

Automations

API Resp.

Webhooks

Workflow

LLM

Memory

RAG

Tools

## Used and Tested by Developers at

SamsungSamsung

Tata MotorsTata

InfosysInfosys

Cognizant

Wells FargoWells Fargo

BayerBayer

OracleOracle

HuaweiHuawei

Microsoft

SamsungSamsung

Tata MotorsTata

InfosysInfosys

Cognizant

Wells FargoWells Fargo

BayerBayer

OracleOracle

HuaweiHuawei

Microsoft

SamsungSamsung

Tata MotorsTata

InfosysInfosys

Cognizant

Wells FargoWells Fargo

BayerBayer

OracleOracle

HuaweiHuawei

Microsoft

ABBABB

AmazonAmazon

Stellantis

VerizonVerizon

CarrefourCarrefour

GoDaddyGoDaddy

BroadcomBroadcom

AccentureAccenture

NissanNissan

Adobe

FiverrFiverr

ABBABB

AmazonAmazon

Stellantis

VerizonVerizon

CarrefourCarrefour

GoDaddyGoDaddy

BroadcomBroadcom

AccentureAccenture

NissanNissan

Adobe

FiverrFiverr

ABBABB

AmazonAmazon

Stellantis

VerizonVerizon

CarrefourCarrefour

GoDaddyGoDaddy

BroadcomBroadcom

AccentureAccenture

NissanNissan

Adobe

FiverrFiverr

DEVELOPMENT & ORCHESTRATION

Build agents with VoltAgent

VoltAgent Framework

open-source

A TypeScript framework for building and AI agents with enterprise-grade capabilities and seamless integrations.

LLMsMemoryToolsWorkflowsMCP

TypeScriptBuilt with TypeScript

Explore VoltAgent

LLM OBSERVABILITY PLATFORM

Gain visibility with VoltOps

VoltOps LLM Observability

Framework-agnostic observability platform for tracing, debugging, and monitoring AI agents across tech stacks.

VoltAgent

TypeScript

Python

Vercel

LangChain

CrewAI

LlamaIndex

OpenTelemetry

Pydantic

Autogen

VoltAgent

TypeScript

Python

Vercel

LangChain

CrewAI

LlamaIndex

OpenTelemetry

Pydantic

Autogen

See VoltOps in action

VoltAgent FrameworkVoltOps LLM Observability

Directorytools

Fileindex.ts

Fileindex.tsFilepackage.json

index.ts

tools/index.ts

package.json

import { VoltAgent, Agent, createTool, createHooks } from "@voltagent/core";
import { honoServer } from "@voltagent/server-hono";
import { openai } from "@ai-sdk/openai";
import { fetchRepoContributorsTool } from "./tools";
import { fetchRepoStarsTool } from "./tools";

// Create the stars fetcher agent
const starsFetcherAgent = new Agent({
name: "Stars Fetcher",
description: "Fetches the number of stars for a GitHub repository using the GitHub API",
model: openai("gpt-4o-mini"),
tools: [fetchRepoStarsTool],
});

// Create the contributors fetcher agent
const contributorsFetcherAgent = new Agent({
name: "Contributors Fetcher",
description: "Fetches the list of contributors for a GitHub repository using the GitHub API",
model: openai("gpt-4o-mini"),
tools: [fetchRepoContributorsTool],
});

// Create the analyzer agent
const analyzerAgent = new Agent({
name: "Repo Analyzer",
description: "Analyzes repository statistics and provides insights",
model: openai("gpt-4o-mini"),
});

// Create the supervisor agent that coordinates all the sub-agents
const supervisorAgent = new Agent({
name: "Supervisor",
description: `You are a GitHub repository analyzer. When given a GitHub repository URL or owner/repo format, you will:
1. Use the StarsFetcher agent to get the repository's star count
2. Use the ContributorsFetcher agent to get the repository's contributors
3. Use the RepoAnalyzer agent to analyze this data and provide insights

Example input: https://github.com/voltagent/voltagent or voltagent/voltagent
`,
model: openai("gpt-4o-mini"),
subAgents: [starsFetcherAgent, contributorsFetcherAgent, analyzerAgent],
});

// Initialize the VoltAgent with the agent hierarchy
new VoltAgent({
agents: {
supervisorAgent,
},
server: honoServer(),
});



Read-only

## Enterprise-level AI agents

Complete toolkit for enterprise level AI agents

Design production-ready agents with unified APIs, tools, and memory.

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

`import { Agent } from '@voltagent/core'   import { openai } from '@ai-sdk/openai'   import { anthropic } from '@ai-sdk/anthropic'         const agent = new Agent({    model: openai("gpt-4o-mini"),   });         const anthropicAgent = new Agent({    model: anthropic('claude-3-haiku-20240307'),   });`

Tool calling

Enable agents to invoke functions, interact with systems, and perform actions.

Unified API

Seamlessly switch between different AI providers with a simple code update.

Dynamic Prompting

Experiment, fine-tune, and iterate your AI prompts in an integrated environment.

Persistent Memory

Store and recall interactions to enhance your agents intelligence and context.

## Fast Growing Community

What are they saying?

## Intelligent Coordination

Supervisor agent orchestration

Build powerful multi-agent systems with a central Supervisor Agent that coordinates specialized agents.

User

Lead Agent

Supervisor

OpenAI logogpt-4o-mini

Team

AgentA

Claude Logoclaude-3.7

AgentB

OpenAI logogpt-4

AgentC

Custom LLM

Conversation-History

User-Lead Memory

Lead-Team Memory

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

`import { Agent } from "@voltagent/core";   import { openai } from "@ai-sdk/openai";      // Define supervisor agent   const supervisorAgent = new Agent({   name: "Supervisor Agent",   description: "You manage a workflow between specialized agents.",   llm: new(),   model: openai("gpt-4o-mini"),   subAgents: [storyAgent, translatorAgent]   });      // Define story agent   const storyAgent = new Agent({   name: "Story Agent",   description: "You are a creative story writer.",   llm: new(),   model: openai("gpt-4o-mini"),   });      // Define translator agent   const translatorAgent = new Agent({   name: "Translator Agent",   description: "Translate English text to German",   llm: new(),   model: openai("gpt-4o-mini"),   });      // Stream response from supervisor agent   const result = await supervisorAgent.streamText(   "Write a 100 word story in English."   );      for await (const chunk of result.textStream) {   console.log(chunk);   }`

Centralized Coordination

Supervisor Agent manages the workflow, delegates tasks to specialized agents, and maintains context across the entire process.

Specialized Agent Roles

Each agent in the workflow can be optimized for specific tasks, with custom tools, knowledge, and capabilities.

Shared Memory System

Maintain context and state across multiple agent interactions, enabling complex reasoning and multi-step problem solving.

Dynamic Agent Selection

Supervisor intelligently routes tasks to the most appropriate agents based on the current context and requirements.

## Workflow Chain API

Orchestrate your agents

Build complex agent workflows with a simple, declarative API

1

2

3

4

5

6

7

8

`createWorkflowChain()   .andAll({   id: "fetch-user-data-steps",   steps: [   andAgent(contentAgent),   andAgent(analysisAgent),   ],   })`

user

workflow

contentAgent

analysisAgent

Create complex workflows with Chain API

Build sophisticated multi agent workflows with our intuitive Chain API. Compose, branch, and orchestrate with ease.

Full TypeScript support with Zod schemas

Every workflow step is fully typed with Zod schemas. Get compile time safety and runtime validation for all agent inputs and outputs.

Pause/Resume for long running workflows

Optimized for long running workflows. Pause execution, save state, and seamlessly resume with human intervention when needed.

Real time observability with VoltOps

Monitor agent execution, debug workflows, and get real time insights with VoltOps observability platform.

## RAG

Accurate and context-aware responses

For advanced querying and dynamic analysis, integrate data into a knowledge base by syncing from diverse sources

.embed()

.query()

.rerank()

input

embeddingmodel

retrieval

llm

output

Voyage

Voyage

Cohere logo

Cohere

Pinecone

Pinecone

Custom

knowledgebase

embeddingmodel

vector stores

OpenAI logo

OpenAI

Cohere logo

Cohere

Voyage

Voyage

Pinecone

Pinecone

PostgreSQL Logo

Postgres

Supabase logo

Supabase

Integrated Vector Database

Seamlessly manage and query your vector data with a unified API, compatible with various providers.

Precise Data Filtering

Refine search results by filtering vectors based on metadata like source, date, or custom attributes.

AI Agent Integration

Empower AI agents to access and utilize your knowledge base through dedicated vector search tools.

Hybrid Search

Combine keyword and vector search techniques for enhanced accuracy and relevance in information retrieval.

## INTEGRATIONS
## Easily connect with 40+ apps in no time

Integrate your AI agents with your preferred tools and services effortlessly.

Lightning Bolt

OpenAI logo

OpenAI

Anthropic

Anthropic

Notion

Notion

Supabase logo

Supabase

Stripe Logo

Stripe

Slack

Slack

Dropbox

Dropbox

Gmail

Gmail

OneDrive

OneDrive

Google Sheets

Google Sheets

Google Drive

Google Drive

Google Calendar

Google Calendar

Microsoft Teams

Microsoft Teams

Mailchimp

Mailchimp

Salesforce

Salesforce

SendGrid

SendGrid

OpenAI logo

OpenAI

Anthropic

Anthropic

Notion

Notion

Supabase logo

Supabase

Stripe Logo

Stripe

Slack

Slack

Dropbox

Dropbox

Gmail

Gmail

OneDrive

OneDrive

Google Sheets

Google Sheets

Google Drive

Google Drive

Google Calendar

Google Calendar

Microsoft Teams

Microsoft Teams

Mailchimp

Mailchimp

Salesforce

Salesforce

SendGrid

SendGrid

OpenAI logo

OpenAI

Anthropic

Anthropic

Notion

Notion

Supabase logo

Supabase

Stripe Logo

Stripe

Slack

Slack

Dropbox

Dropbox

Gmail

Gmail

OneDrive

OneDrive

Google Sheets

Google Sheets

Google Drive

Google Drive

Google Calendar

Google Calendar

Microsoft Teams

Microsoft Teams

Mailchimp

Mailchimp

Salesforce

Salesforce

SendGrid

SendGrid

GitHub Logo

GitHub

YouTube Logo

YouTube

Zendesk Logo

Zendesk

Trello

Trello

Jira

Jira

Intercom

Intercom

HubSpot

Hubspot

Airtable

Airtable

Figma

Figma

Asana

Asana

Ahref

Ahref

Mixpanel

Mixpanel

Sentry

Sentry

Snowflake

Snowflake

GitHub Logo

GitHub

YouTube Logo

YouTube

Zendesk Logo

Zendesk

Trello

Trello

Jira

Jira

Intercom

Intercom

HubSpot

Hubspot

Airtable

Airtable

Figma

Figma

Asana

Asana

Ahref

Ahref

Mixpanel

Mixpanel

Sentry

Sentry

Snowflake

Snowflake

GitHub Logo

GitHub

YouTube Logo

YouTube

Zendesk Logo

Zendesk

Trello

Trello

Jira

Jira

Intercom

Intercom

HubSpot

Hubspot

Airtable

Airtable

Figma

Figma

Asana

Asana

Ahref

Ahref

Mixpanel

Mixpanel

Sentry

Sentry

Snowflake

Snowflake

Observability

Stay in control at every stage

From tracking deployments to debugging and live interaction, VoltAgent gives you full visibility into your AI agents.

Deployment

Deploy your Agents in seconds with VoltAgent Deployment.

Deployment Stages

Initializing build environment

Cloning git repository

Building application

Deploying to VoltAgent's global network

Deployment Logs

10:30:01

Cloning repository...

10:30:02

From https://github.com/your-org/your-app

10:30:02

\* branch main -> FETCH\_HEAD

10:30:02

HEAD is now at a1b2c3d feat: add new feature

10:30:02

Success: Finished cloning repository files

10:30:03

Using Node.js v20.19.0

10:30:03

Running \`npm install\`...

10:30:28

Installed 1450 packages in 25.3s

10:30:29

Running \`npm run build\`...

10:30:29

\> \[emailĀ protected\] build

10:30:29

\> tsc && node scripts/postbuild.js

10:30:35

Compiling TypeScript files...

10:30:36

\[VoltAgent\] Validating agent schemas...

10:30:38

Build successful! Artifacts generated.

10:30:38

\[VoltAgent\] Starting deployment process...

10:30:40

Uploading build artifacts (2.1MB)...

10:30:45

Upload complete. Verifying deployment...

10:30:46

\[VoltAgent\] Deployed! 'my-agent-v1.2' is live.

Debugging

Debug and analyze your VoltAgent-powered AI agent's behavior with visual flows.

User

Lead AgentThinking...

Supervisorgpt-4o-mini

Teamexecuting...

Agent Aclaude-3.7

executing...

Agent Bgpt-4

executing...

Agent CCustom LLM

Conversation-History

User-LeadMemory

Lead-TeamMemory

Press enter or space to select a node.You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Observability

Connect your VoltAgent-powered AI agents to popular observability platforms.

LangSmith

Langfuse

Braintrust logo

Dash0 logo

Signoz logo

LangWatch logo

New Relic logo

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

`import { VoltAgent } from "@voltagent/core"   import { LangfuseExporter } from "langfuse-vercel"      export const volt = new VoltAgent({     telemetry: {       serviceName: "ai",       enabled: true,       export: {         type: "custom",         exporter: new LangfuseExporter({           publicKey: process.env.LANGFUSE_PUBLIC_KEY,           secretKey: process.env.LANGFUSE_SECRET_KEY,           baseUrl: process.env.LANGFUSE_BASEURL,         }),       },     },   });`

AI Chat

Interact with your AI agent through natural language chat interface.

Model

OpenAI logogpt-4-mini

Tools

Social Analysis, Trend Detection, Content Calendar, Performance Metrics, Competitor Analysis

Instructions

You are a marketing assistant specialized in campaign analysis, content strategy, and social media optimization. Analyze data to provide actionable insights and automate routine marketing tasks.

Agent, analyze last month's social media campaign performance and provide recommendations for improvement.

Analysis complete. Last month's campaign reached 45% more users but had 12% lower conversion rate compared to previous campaigns. Key findings: 1) Video content performed 3x better than static images. 2) Posts published between 6-8pm had highest engagement. 3) Product demonstration posts generated most conversions. Recommendation: Increase video content by 40%, focus on product demonstrations, and schedule more posts during evening hours.

Create a content calendar for next month based on these insights. Include optimal posting times and content types.

Content calendar created. I've scheduled 15 posts across platforms with 60% video content focused on product demos. Primary posting times are Tuesdays and Thursdays 6-8pm, with additional posts Monday and Friday mornings based on secondary engagement peaks. I've included hooks for upcoming product launch and integrated seasonal marketing themes. Calendar has been added to your Marketing Projects workspace and synced with team collaboration tools.

## Blog

All about AI Agents

We are sharing our knowledge about AI Agents.

Necati Ozmen•Apr 28, 2025

### Building Google Drive Chatbot with Composio MCP

Learn how to build a powerful Google Drive chatbot using...

Omer Aplak•Jun 3, 2025

### Vercel AI LLM Observability

Deep dive into LLM observability tools for Vercel AI applications,...

VoltAgent Team•Jul 29, 2025

### TypeScript AI Agent Framework

Build powerful AI agents with TypeScript using our comprehensive framework...

Read all posts

## Community

Join the movement

Our growing open source community building the future of AI agents.

Discord logo

Ask for help

Share ideas

Learn together

Find teammates

Get feedback

Join events

Solve problems

Build together

Join the Server

GitHub Logo

See the Repo

docs

See Docs

voltagent

GitHub LogoDiscord logoX logoReddit logoLinkedIn logoYouTube Logo

\[emailĀ protected\]

VoltAgent Inc. Ā© 2025

Resources

- Getting Started
- Blog
- Changelog
- Docs
- MCP Directory
- Tutorial
- awesome-claude-subagents
- llms.txt

Community

- Contributing
- About us
- Customers
- OSS Friends