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.
TO
TokRepo精选 · Community
Quick Use
Use it first, then decide how deep to go
This block should tell both the user and the agent what to copy, install, and apply first.
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.
Discussion
Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.