Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
096f53b
refactor: update hero component text and structure for clarity
necatiozmen Jan 2, 2026
74502c1
refactor: enhance hero component styling and text for improved readab…
necatiozmen Jan 2, 2026
3570523
refactor: update hero component styling for improved visual consistency
necatiozmen Jan 2, 2026
48e9d19
refactor: clean up footer links and enhance hero component layout
necatiozmen Jan 6, 2026
9d6d1a4
refactor: update README for improved clarity and detail on VoltAgent …
necatiozmen Jan 6, 2026
f1c615d
refactor: update README to enhance clarity and detail on VoltAgent fe…
necatiozmen Jan 6, 2026
c88faa2
refactor: update examples section in README for improved clarity and …
necatiozmen Jan 6, 2026
e195c09
refactor: remove outdated use cases section from README for improved …
necatiozmen Jan 6, 2026
260be7e
Update README with images and performance metrics
necatiozmen Jan 6, 2026
6d7af76
Enhance Dashboard section with additional images
necatiozmen Jan 6, 2026
aa310f5
refactor: update README for improved clarity and organization of Volt…
necatiozmen Jan 6, 2026
3d75712
refactor: update README with demo images
necatiozmen Jan 6, 2026
a293aba
refactor: replace demo image with video for enhanced user guidance
necatiozmen Jan 6, 2026
5d6ac73
refactor: update expense approval workflow section with thumbnail for…
necatiozmen Jan 6, 2026
f7aa045
Update expense approval workflow link in README
necatiozmen Jan 6, 2026
5f74833
refactor: remove unused images and clean up README for better readabi…
necatiozmen Jan 6, 2026
14ea16d
refactor: update examples section in README for clarity and consistency
necatiozmen Jan 6, 2026
213a0d1
Update website/src/components/hero/index.tsx
necatiozmen Jan 6, 2026
7cf8fb0
Update README.md
necatiozmen Jan 6, 2026
2ed7d0a
Update README.md
necatiozmen Jan 7, 2026
ab5a554
refactor: simplify className in Hero component for improved readability
necatiozmen Jan 7, 2026
ce9efdb
Merge branch 'update-naming' of https://github.com/VoltAgent/voltagen…
necatiozmen Jan 7, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
171 changes: 50 additions & 121 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,6 @@ English | <a href="i18n/README-cn-traditional.md">繁體中文</a> | <a href="i1

<div align="center">

[![GitHub stars](https://img.shields.io/github/stars/voltagent/voltagent?style=social)](https://github.com/voltagent/voltagent)
[![GitHub issues](https://img.shields.io/github/issues/voltagent/voltagent)](https://github.com/voltagent/voltagent/issues)
[![GitHub pull requests](https://img.shields.io/github/issues-pr/voltagent/voltagent)](https://github.com/voltagent/voltagent/pulls)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
Expand All @@ -43,23 +42,24 @@ English | <a href="i18n/README-cn-traditional.md">繁體中文</a> | <a href="i1

<br/>

**VoltAgent** is an open source TypeScript framework for building and orchestrating AI agents.
You can build production-ready agents with memory, workflows, tools, and built-in LLM observability.
VoltAgent is an end-to-end AI Agent Engineering Platform. The open-source TypeScript framework handles Memory, RAG, tools, and agent runtime; VoltOps delivers observability, automation, and deployment for production. (This repository contains the core framework.)

Together, you can build agents with full code control and ship them with production-ready visibility and operations.

## Why VoltAgent?

- **End-to-End Development Platform**: Everything you need to build, observe, and deploy production-ready multi-agent systems in one place.
- **Production-Ready from Day One**: Ship agents with built-in memory, workflows, and observability instead of building infrastructure from scratch.
- **Code with Confidence**: Full TypeScript support with type-safe tools, automatic inference, and compile time safety across your entire agent system.
- **Code with Confidence**: Full TypeScript support with type-safe tools, automatic inference, and compile-time safety across your entire agent system.
- **Debug Like a Pro**: Built-in VoltOps observability lets you trace every decision, monitor performance, and optimize workflows in real-time without external tools.
- **Build Complex Systems Simply**: Orchestrate multi-agent teams with supervisor coordination, declarative workflows, and modular architecture that scales from prototypes to production.

## Agent Development Platform
- **Automate with Actions & Triggers**: Connect agents to external events like webhooks, schedules, or custom triggers to run workflows automatically without manual intervention.

VoltAgent provides a complete platform for developing and monitoring AI agents through two complementary tools.

### Core Framework

With the core framework, you can build intelligent agents with memory, tools, and multi-step workflows while connecting to any AI provider. Create sophisticated multi-agent systems where specialized agents work together under supervisor coordination.
With the open-source framework, you can build intelligent agents with memory, tools, and multi-step workflows while connecting to any AI provider. Create sophisticated multi-agent systems where specialized agents work together under supervisor coordination.

- **[Core Runtime](https://voltagent.dev/docs/agents/overview/) (`@voltagent/core`)**: Define agents with typed roles, tools, memory, and model providers in one place so everything stays organized.
- **[Workflow Engine](https://voltagent.dev/docs/workflows/overview/)**: Describe multi-step automations declaratively rather than stitching together custom control flow.
Expand All @@ -71,9 +71,11 @@ With the core framework, you can build intelligent agents with memory, tools, an
- **[VoltAgent Knowledge Base](https://voltagent.dev/docs/rag/voltagent/)**: Use the managed RAG service for document ingestion, chunking, embeddings, and search.
- **[Evals](https://voltagent.dev/docs/evals/overview/)**: Ship guardrails faster by running agent eval suites alongside your workflows.

### VoltOps LLM Observability Platform
### VoltOps Console: LLM Observability - Automation - Deployment

VoltAgent comes with built-in [VoltOps](#built-in-llm-observability-with-voltops) LLM observability to monitor and debug your agents in real-time with detailed execution traces, performance metrics, and visual dashboards. Inspect every decision your agents make, track tool usage, and optimize your workflows with built-in OpenTelemetry-based observability.
VoltOps provides observability, automation, and deployment so you can monitor and debug agents in real-time with detailed execution traces, performance metrics, and visual dashboards.

[More info](https://voltagent.dev/observability-docs/).

#### MCP Server (@voltagent/mcp-docs-server)

Expand Down Expand Up @@ -161,7 +163,7 @@ Your agent is now running! To interact with it:
4. Start Chatting: On the agent detail page, click the chat icon in the bottom right corner to open the chat window.
5. Send a Message: Type a message like "Hello" and press Enter.

![VoltAgent VoltOps Platform Demo](https://github.com/user-attachments/assets/0adbec33-1373-4cf4-b67d-825f7baf1cb4)
[![VoltAgent Demo](thumbnail.png)](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7)

### Running Your First Workflow

Expand Down Expand Up @@ -242,7 +244,7 @@ export const expenseApprovalWorkflow = createWorkflowChain({

You can test the pre-built `expenseApprovalWorkflow` directly from the VoltOps console:

![VoltOps Workflow Observability](https://github.com/user-attachments/assets/9b877c65-f095-407f-9237-d7879964c38a)
[![expense-approval](thumbnail.png)](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18)

1. **Go to the Workflows Page:** After starting your server, go directly to the [Workflows page](https://console.voltagent.dev/workflows).
2. **Select Your Project:** Use the project selector to choose your project (e.g., "my-agent-app").
Expand All @@ -258,9 +260,22 @@ You can test the pre-built `expenseApprovalWorkflow` directly from the VoltOps c
```
5. **View the Results:** After execution, you can inspect the detailed logs for each step and see the final output directly in the console.

## Built-in LLM Observability with VoltOps
## Examples

For more examples, visit our [examples repository](https://github.com/VoltAgent/voltagent/tree/main/examples).

- **[Airtable Agent](https://voltagent.dev/examples/guides/airtable-agent)** - React to new records and write updates back into Airtable with VoltOps actions.
- **[Slack Agent](https://voltagent.dev/examples/guides/slack-agent)** - Respond to channel messages and reply via VoltOps Slack actions.
- **[ChatGPT App With VoltAgent](https://voltagent.dev/examples/agents/chatgpt-app)** - Deploy VoltAgent over MCP and connect to ChatGPT Apps.
- **[WhatsApp Order Agent](https://voltagent.dev/examples/agents/whatsapp-ai-agent)** - Build a WhatsApp chatbot that handles food orders through natural conversation. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp))
- **[YouTube to Blog Agent](https://voltagent.dev/examples/agents/youtube-blog-agent)** - Convert YouTube videos into Markdown blog posts using a supervisor agent with MCP tools. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog))
- **[AI Ads Generator Agent](https://voltagent.dev/examples/agents/ai-instagram-ad-agent)** - Generate Instagram ads using BrowserBase Stagehand and Google Gemini AI. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator))
- **[AI Recipe Generator Agent](https://voltagent.dev/examples/agents/recipe-generator)** - Create personalized cooking suggestions based on ingredients and preferences. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) | [Video](https://youtu.be/KjV1c6AhlfY))
- **[AI Research Assistant Agent](https://voltagent.dev/examples/agents/research-assistant)** - Multi-agent research workflow for generating comprehensive reports. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) | [Video](https://youtu.be/j6KAUaoZMy4))

VoltAgent comes with VoltOps, a LLM observability platform built-in to help you monitor, debug, and optimize your agents in real-time.
## VoltOps Console

VoltOps Console is the platform side of VoltAgent where you get comprehensive observability, automation, and deployment for your agents in production.

🎬 [Try Live Demo](https://console.voltagent.dev/demo)

Expand All @@ -272,163 +287,79 @@ VoltAgent comes with VoltOps, a LLM observability platform built-in to help you

Deep dive into agent execution flow with detailed traces and performance metrics.

<br/>

![VoltOps Observability Overview](https://cdn.voltagent.dev/console/observability.png)
<img alt="1" src="https://github.com/user-attachments/assets/21c6d05d-f333-4c61-9218-8862d16110fd" />

### Dashboard

Get a comprehensive overview of all your agents, workflows, and system performance metrics.

<br/>

![VoltOps Dashboard](https://cdn.voltagent.dev/console/dashboard.png)
<img alt="dashboar" src="https://github.com/user-attachments/assets/c88a5543-219e-4cf0-8f41-14a68ca297fb" />

### Logs

Track detailed execution logs for every agent interaction and workflow step.
<br/>

![VoltOps Logs](https://cdn.voltagent.dev/console/logs.png)

### Memory Management

Inspect and manage agent memory, context, and conversation history.

<br/>

![VoltOps Memory Overview](https://cdn.voltagent.dev/console/memory.png)

### Traces

Analyze complete execution traces to understand agent behavior and optimize performance.

<br/>

![VoltOps Traces](https://cdn.voltagent.dev/console/traces.png)

### Prompt Builder

Design, test, and refine prompts directly in the console.

<br/>

![VoltOps Prompt Builder](https://cdn.voltagent.dev/console/prompt.png)
<img alt="prompts" src="https://github.com/user-attachments/assets/fb6d71eb-8f81-4443-a494-08c33ec9bcc4" />

### Deployment

Deploy your agents to production with one-click GitHub integration and managed infrastructure.

<br/>

![VoltOps Deploy](https://cdn.voltagent.dev/website/feature-showcase/deployment.png)
<img alt="deployment" src="https://github.com/user-attachments/assets/e329ab4b-7464-435a-96cc-90214e8a3cfa" />

📖 [VoltOps Deploy Documentation](https://voltagent.dev/docs/deployment/voltops/)

## Examples
### Triggers & Actions

Explore real-world implementations of VoltAgent with complete source code and video tutorials.
Automate agent workflows with webhooks, schedules, and custom triggers to react to external events.

For more examples and use cases, visit our [examples repository](https://github.com/VoltAgent/voltagent/tree/main/examples).
<img width="1277" alt="triggers" src="https://github.com/user-attachments/assets/67e36934-2eb5-4cf1-94f8-3057d805ef65" />

### WhatsApp Order Agent
### Monitoring

Build a WhatsApp chatbot that handles food orders through natural conversation, manages menu items from a database, and processes orders with full conversation context.
Monitor agent health, performance metrics, and resource usage across your entire system.

<br/>
<img alt="monitoring" src="https://github.com/user-attachments/assets/1fd1151f-5ee4-4c7c-8ec7-29874e37c48f" />

<img width="1111" height="347" alt="whatsapp" src="https://github.com/user-attachments/assets/dc9c4986-3e68-42f8-a450-ecd79b4dbd99" />
### Guardrails

<br/>
<br/>
Set up safety boundaries and content filters to ensure agents operate within defined parameters.

- 📖 [Tutorial](https://voltagent.dev/examples/agents/whatsapp-ai-agent)
- 💻 [Source Code](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp)
<img alt="guardrails" src="https://github.com/user-attachments/assets/52bd51f0-944e-4202-9f54-7bb2e0e2d1f6" />

### YouTube to Blog Agent
### Evals

Convert YouTube videos into Markdown blog posts using a supervisor agent that coordinates subagents with MCP tools, shared working memory, and VoltOps observability.
Run evaluation suites to test agent behavior, accuracy, and performance against benchmarks.

<br/>

<img width="1113" height="363" alt="youtube" src="https://github.com/user-attachments/assets/f9c944cf-8a9a-4ac5-a5f9-860ce08f058b" />
<img alt="evals" src="https://github.com/user-attachments/assets/510cc180-2661-4973-a48f-074d4703d90b" />

<br/>
<br/>
### RAG (Knowledge Base)

- 📖 [Tutorial](https://voltagent.dev/examples/agents/youtube-blog-agent)
- 💻 [Source Code](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog)
Connect your agents to knowledge sources with built-in retrieval-augmented generation capabilities.

### AI Ads Generator Agent

Implement an Instagram ad generator that uses BrowserBase Stagehand to analyze landing pages, extract brand data, and generate visuals through Google Gemini AI.

<br/>

<a href="https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator">
<img width="1115" height="363" alt="instagram" src="https://github.com/user-attachments/assets/973e79c7-34ec-4f8e-8a41-9273d44234c6" />
</a>

<br/>
<br/>

- 📖 [Tutorial](https://voltagent.dev/examples/agents/ai-instagram-ad-agent)
- 💻 [Source Code](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator)

### AI Recipe Generator Agent

Build an intelligent recipe recommendation system that creates personalized cooking suggestions based on available ingredients, dietary preferences, and time constraints.

<br/>

<a href="https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator">
<img width="1111" height="363" alt="cook" src="https://github.com/user-attachments/assets/dde6ce2f-c963-4075-9825-f216bc6e3467" />
</a>

<br/>
<br/>

- 📖 [Tutorial](https://voltagent.dev/examples/agents/recipe-generator)
- 📹 [Watch Video](https://youtu.be/KjV1c6AhlfY)
- 💻 [Source Code](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator)

### AI Research Assistant Agent

Create a multi-agent research workflow where different AI agents collaborate to research topics and generate comprehensive reports with type-safe data flow.

<br/>

<a href="https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant">
<img width="2228" height="678" alt="research" src="https://github.com/user-attachments/assets/8f459748-132e-4ff3-9afe-0561fa5075c2" />
</a>

<br/>
<br/>

- 📖 [Tutorial](https://voltagent.dev/examples/agents/research-assistant)
- 📹 [Watch Video](https://youtu.be/j6KAUaoZMy4)
- 💻 [Source Code](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant)

## Use Cases

Build AI agents for real-world business needs across different industries:

- **[HR Agent](https://voltagent.dev/use-cases/hr-agent/)** - Automate recruiting, employee onboarding, and HR support tasks.
- **[Customer Support Agent](https://voltagent.dev/use-cases/customer-support-agent/)** - Build support agents that handle customer questions and issues.
- **[Sales Teams](https://voltagent.dev/use-cases/sales-teams/)** - Qualify leads, gather customer data, and personalize sales outreach.
- **[Finance Agent](https://voltagent.dev/use-cases/finance-agent/)** - Manage invoices, track expenses, and generate financial reports.
- **[Development Agent](https://voltagent.dev/use-cases/development-agent/)** - Review code, manage deployments, and help development teams.
- **[Marketing Agent](https://voltagent.dev/use-cases/marketing-agent/)** - Plan campaigns, create content, and analyze marketing performance.
- **[Legal Agent](https://voltagent.dev/use-cases/legal-agent/)** - Review contracts, check compliance, and handle legal tasks.
- **[Insurance Agent](https://voltagent.dev/use-cases/insurance-agent/)** - Process claims, evaluate risks, and manage policies.
- **[Industrial Agent](https://voltagent.dev/use-cases/industrial-agent/)** - Monitor equipment, predict maintenance needs, and ensure safety.
- **[Education Agent](https://voltagent.dev/use-cases/education-agent/)** - Provide personalized tutoring, track student progress, and support learning.
- **[Government Agent](https://voltagent.dev/use-cases/government-agent/)** - Handle permit applications, process benefits, and serve citizens.
- **[Documentation Agent](https://voltagent.dev/use-cases/documentation-agent/)** - Create API docs, write changelogs, and generate tutorials from code.
<img alt="rag" src="https://github.com/user-attachments/assets/a6c2f668-7ad1-4fb6-b67f-654335285f1e" />

## Learning VoltAgent

- 📖 **[Start with interactive tutorial](https://voltagent.dev/tutorial/introduction/)** to learn the fundamentals building AI Agents.
- **[Start with interactive tutorial](https://voltagent.dev/tutorial/introduction/)** to learn the fundamentals building AI Agents.
- **[Documentation](https://voltagent.dev/docs/)**: Dive into guides, concepts, and tutorials.
- **[Examples](https://github.com/voltagent/voltagent/tree/main/examples)**: Explore practical implementations.
- **[Blog](https://voltagent.dev/blog/)**: Read more about technical insights, and best practices.
Expand All @@ -443,10 +374,8 @@ Big thanks to everyone who's been part of the VoltAgent journey, whether you've

VoltAgent is a community effort, and it keeps getting better because of people like you.

![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=100)

Your stars help us reach more developers! If you find VoltAgent useful, please consider giving us a star on GitHub to support the project and help others discover it.
![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=500&columns=20&anon=1)

## License

Licensed under the MIT License, Copyright © 2025-present VoltAgent.
Licensed under the MIT License, Copyright © 2026-present VoltAgent.
14 changes: 0 additions & 14 deletions website/src/components/footer/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -88,22 +88,11 @@ export function Footer() {
<li>
<FooterLink href="/docs/">Docs</FooterLink>
</li>
<li>
<FooterLink href="/mcp/">MCP Directory</FooterLink>
</li>
<li>
<FooterLink href="https://voltagent.dev/tutorial/introduction/" target="_blank">
Tutorial
</FooterLink>
</li>
<li>
<FooterLink
href="https://github.com/VoltAgent/awesome-claude-code-subagents"
target="_blank"
>
awesome-claude-subagents
</FooterLink>
</li>
<li>
<FooterLink href="https://voltagent.dev/llms.txt" target="_blank">
llms.txt
Expand Down Expand Up @@ -131,9 +120,6 @@ export function Footer() {
<li>
<FooterLink href="/about/">About us</FooterLink>
</li>
<li>
<FooterLink href="/customers/">Customers</FooterLink>
</li>
<li>
<FooterLink href="/oss-friends">OSS Friends</FooterLink>
</li>
Expand Down
Loading
Loading