# VoltAgent — TypeScript AI Agent Framework

> Open-source TypeScript framework for building AI agents with built-in Memory, RAG, Guardrails, MCP, Voice, and Workflow support. Includes LLM observability console for debugging.

## Install

Save as a script file and run:

## Quick Use

1. Create a new VoltAgent project:
   ```bash
   npm create voltagent-app@latest
   ```
2. Follow the prompts to select your template and LLM provider.
3. Start the development server:
   ```bash
   npm run dev
   ```
4. Open the VoltOps Console at `http://localhost:3141` to monitor your agents in real-time.

---

## Intro

VoltAgent is an open-source TypeScript AI Agent Engineering Platform with 7,200+ GitHub stars. It provides a complete framework for building intelligent agents with typed tools, persistent memory, RAG retrieval, guardrails, multi-agent orchestration, voice support, and MCP integration — plus a built-in observability console (VoltOps) for tracing, debugging, and monitoring agent behavior in production. Think of it as the "Next.js of AI agents" — batteries included, TypeScript-first.

Best for: TypeScript developers building production AI agents with observability requirements.
Works with: OpenAI, Anthropic, Google, and any AI SDK-compatible provider.
Setup time: under 2 minutes.

---

## VoltAgent — Complete Feature Guide

### Architecture Overview

VoltAgent consists of two main components:

1. **Open-Source Framework** (`@voltagent/core`) — The agent runtime
2. **VoltOps Console** (Cloud & Self-Hosted) — Observability dashboard

### Core Framework Features

#### Agent Definition
```typescript
import { Agent } from "@voltagent/core";
import { openai } from "@ai-sdk/openai";

const agent = new Agent({
  name: "my-agent",
  instructions: "A helpful assistant",
  model: openai("gpt-4o-mini"),
});
```

#### Typed Tools with Zod
```typescript
import { createTool } from "@voltagent/core";
import { z } from "zod";

const weatherTool = createTool({
  name: "get_weather",
  description: "Get current weather for a city",
  parameters: z.object({ city: z.string() }),
  execute: async ({ city }) => {
    // Your weather API logic
    return { temp: 72, condition: "sunny" };
  },
});
```

#### Memory System
Attach durable memory adapters (LibSQL, SQLite, custom) for persistent context across agent runs. Each conversation maintains full history and can be resumed.

#### Multi-Agent Orchestration
```typescript
const supervisor = new Agent({
  name: "supervisor",
  subAgents: [researchAgent, writerAgent, reviewerAgent],
  instructions: "Coordinate the team to produce high-quality content",
});
```

#### Workflow Engine
Declare multi-step automations with suspend/resume capabilities. Workflows can pause, wait for external input, and continue execution.

#### RAG & Retrieval
Plug in retriever agents for fact-grounding before responses. Supports any vector database or document source.

#### Guardrails
Intercept and validate agent input/output at runtime — content filtering, format validation, safety checks.

#### Voice Support
Add text-to-speech and speech-to-text capabilities to your agents.

#### MCP Integration
Connect to any MCP server as a tool source. VoltAgent also provides `@voltagent/mcp-docs-server` for teaching LLMs how to use the framework.

### VoltOps Console

The built-in observability dashboard provides:
- **Real-time tracing** — See every tool call, LLM request, and agent decision
- **Memory management** — Browse and edit agent memory
- **Performance metrics** — Token usage, latency, error rates
- **Deployment** — Deploy agents to production
- **Evals** — Run evaluation suites to measure agent behavior

### Packages

| Package | Purpose |
|---------|---------|
| `@voltagent/core` | Agent runtime, tools, memory |
| `@voltagent/server-hono` | Hono-based HTTP server |
| `@voltagent/logger` | Pino-based structured logging |
| `@voltagent/libsql` | LibSQL memory adapter |
| `@voltagent/mcp-docs-server` | MCP docs for LLMs |

### FAQ

**Q: What is VoltAgent?**
A: An open-source TypeScript framework for building AI agents with built-in memory, RAG, guardrails, multi-agent orchestration, and an observability console. It supports OpenAI, Anthropic, Google, and any AI SDK provider.

**Q: Is VoltAgent free?**
A: The framework is fully open-source under MIT license. VoltOps Console has both free self-hosted and cloud options.

**Q: How is VoltAgent different from LangChain or CrewAI?**
A: VoltAgent is TypeScript-first (vs Python), has built-in observability (VoltOps Console), and uses Zod for type-safe tool definitions. It's designed for production use with streaming, resume, and deployment features.

---

## Source & Thanks

> Created by [VoltAgent](https://github.com/VoltAgent). Licensed under MIT.
>
> [voltagent](https://github.com/VoltAgent/voltagent) — ⭐ 7,200+

Thank you to the VoltAgent team for building a TypeScript-first AI agent platform with first-class observability.

---

<!-- ZH -->

## 快速使用

1. 创建新的 VoltAgent 项目：
   ```bash
   npm create voltagent-app@latest
   ```
2. 按提示选择模板和 LLM 提供商。
3. 启动开发服务器：
   ```bash
   npm run dev
   ```
4. 打开 VoltOps Console `http://localhost:3141` 实时监控你的 Agent。

---

## 简介

VoltAgent 是一个开源 TypeScript AI Agent 工程平台，拥有 7,200+ GitHub Star。提供完整的 Agent 构建框架，包括类型化工具、持久化记忆、RAG 检索、安全护栏、多 Agent 协作、语音支持和 MCP 集成——还内置了可观测性控制台（VoltOps）用于追踪、调试和监控 Agent 行为。可以理解为"AI Agent 的 Next.js"——开箱即用，TypeScript 优先。

适合人群：构建生产级 AI Agent 并需要可观测性的 TypeScript 开发者。
兼容模型：OpenAI、Anthropic、Google 及任何 AI SDK 兼容的提供商。
安装时间：2 分钟以内。

---

## VoltAgent — 完整功能指南

### 核心功能
- **Agent 定义**：用 TypeScript 定义 Agent 的角色、工具、记忆和模型
- **Zod 类型工具**：类型安全的工具定义和参数验证
- **持久化记忆**：LibSQL/SQLite 适配器，跨对话保持上下文
- **多 Agent 协作**：Supervisor 模式协调专业 Agent 团队
- **工作流引擎**：多步自动化，支持暂停/恢复
- **RAG 检索**：接入任何向量数据库进行知识检索
- **安全护栏**：运行时拦截和验证 Agent 输入输出
- **语音支持**：TTS 和 STT 能力
- **MCP 集成**：连接任何 MCP 服务器作为工具源

### VoltOps 控制台
- 实时追踪每个工具调用和 LLM 请求
- 记忆管理、性能指标、部署和评估

### FAQ

**Q: VoltAgent 是什么？**
A: 一个开源 TypeScript 框架，用于构建具有记忆、RAG、护栏、多 Agent 协作和可观测性控制台的 AI Agent。

**Q: 免费吗？**
A: 框架完全开源（MIT），VoltOps Console 有免费自托管和云端选项。

---

## 来源与感谢

> Created by [VoltAgent](https://github.com/VoltAgent). Licensed under MIT.
>
> [voltagent](https://github.com/VoltAgent/voltagent) — ⭐ 7,200+

---
Source: https://tokrepo.com/en/workflows/30ccfe29-3c1d-4e86-bce4-e49c637a8581
Author: TokRepo精选