Skip to content

Commit 0a064a7

Browse files
omeraplakomeraplak
committed
Merge branch 'main' into blog/data-aware-chatbot-voltagent-peaka
2 parents 0008e58 + d68a827 commit 0a064a7

124 files changed

Lines changed: 6142 additions & 490 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/FUNDING.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# These are supported funding model platforms
2+
3+
github: voltagent

‎.github/pull_request_template.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
## PR Checklist
2+
3+
Please check if your PR fulfills the following requirements:
4+
5+
- [ ] The commit message follows our guidelines: https://voltagent.dev/docs/community/contributing/#commit-convention
6+
7+
## Bugs / Features
8+
9+
- [ ] Related issue(s) linked
10+
- [ ] Tests for the changes have been added
11+
- [ ] Docs have been added / updated
12+
- [ ] Changesets have been added https://voltagent.dev/docs/community/contributing/#creating-a-changeset
13+
14+
## What is the current behavior?
15+
16+
## What is the new behavior?
17+
18+
fixes (issue)
19+
20+
## Notes for reviewers
21+
22+
<!-- Add any notes/questions you may have for reviewers -->

‎CHANGELOG.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,32 @@ VoltAgent aims to fix that by providing the building blocks you need:
1414
We're combining the flexibility of code with the clarity of visual tools (like our **currently live [VoltAgent Console](https://console.voltagent.dev/)**) to make AI development easier, clearer, and more powerful. Join us as we build the future of AI in JavaScript!
1515

1616
Explore the [Docs](https://voltagent.dev/docs/) and join our [Discord community](https://s.voltagent.dev/discord)!
17+
18+
# Changelog
19+
20+
## 0.2.0
21+
22+
### Minor Changes
23+
24+
- [#29](https://github.com/VoltAgent/voltagent/pull/29) [`82e27c2`](https://github.com/VoltAgent/voltagent/commit/82e27c2bcd19fbf476d7812b91df3ab399a03357) Thanks [@foxy17](https://github.com/foxy17)! - feat(google-ai): Add initial Google AI provider package (`@voltagent/google-ai`) - #12
25+
26+
### Patch Changes
27+
28+
- [#41](https://github.com/VoltAgent/voltagent/pull/41) [`52d5fa9`](https://github.com/VoltAgent/voltagent/commit/52d5fa94045481dc43dc260a40b701606190585c) Thanks [@omeraplak](https://github.com/omeraplak)! - Introducing Toolkits and Reasoning Tools Helper for `@voltagent/core`.
29+
30+
- [#35](https://github.com/VoltAgent/voltagent/pull/35) [`9acbbb8`](https://github.com/VoltAgent/voltagent/commit/9acbbb898a517902cbdcb7ae7a8460e9d35f3dbe) Thanks [@omeraplak](https://github.com/omeraplak)! - fix: Prevent potential error when accessing debug option in LibSQLStorage (`@voltagent/core`) - #34
31+
32+
- [#27](https://github.com/VoltAgent/voltagent/pull/27) [`3c0829d`](https://github.com/VoltAgent/voltagent/commit/3c0829dcec4db9596147b583a9cf2d4448bc30f1) Thanks [@omeraplak](https://github.com/omeraplak)! - fix: improve sub-agent context sharing for sequential task execution (`@voltagent/core`) - #30
33+
34+
- [#33](https://github.com/VoltAgent/voltagent/pull/33) [`3ef2eaa`](https://github.com/VoltAgent/voltagent/commit/3ef2eaa9661e8ecfebf17af56b09af41285d0ca9) Thanks [@kwaa](https://github.com/kwaa)! - Update package.json files (removed `src` from `files`, added `exports`) for `@voltagent/cli`, `@voltagent/core`, `create-voltagent-app`, `@voltagent/google-ai`, `@voltagent/supabase`, `@voltagent/vercel-ai`, `@voltagent/voice`, `@voltagent/xsai`.
35+
36+
- [#21](https://github.com/VoltAgent/voltagent/pull/21) [`8c3506e`](https://github.com/VoltAgent/voltagent/commit/8c3506e27486ac371192ef9ffb6a997e8e1692e9) Thanks [@omeraplak](https://github.com/omeraplak)! - feat: Introduce Supabase Memory Provider (`@voltagent/supabase`) - #8
37+
38+
- Updated dependencies:
39+
- `@voltagent/google-ai` -> `@voltagent/core@0.1.6`
40+
- `@voltagent/supabase` -> `@voltagent/core@0.1.6`
41+
- `@voltagent/vercel-ai` -> `@voltagent/core@0.1.6`
42+
- `@voltagent/voice` -> `@voltagent/core@0.1.6`
43+
- `@voltagent/xsai` -> `@voltagent/core@0.1.6`
44+
45+
## 0.1.0 (Initial Release)

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ Instead of building everything from scratch, VoltAgent provides ready-made, modu
5353
- **Core Engine (`@voltagent/core`)**: The heart of VoltAgent, providing fundamental capabilities for your AI agents Define individual agents with specific roles, tools, and memory.
5454
- **Multi-Agent Systems**: Architect complex applications by coordinating multiple specialized agents using Supervisors.
5555
- **Extensible Packages**: Enhance functionality with packages like `@voltagent/voice` for voice interactions.
56-
- **Tooling & Integrations**: Equip agents with tools to connect to external APIs, databases, and services, enabling them to perform real-world tasks. **Supports the [Model Control Protocol (MCP)](https://modelcontextprotocol.io/) for standardized tool interactions.**
56+
- **Tooling & Integrations**: Equip agents with tools to connect to external APIs, databases, and services, enabling them to perform real-world tasks. **Supports the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) for standardized tool interactions.**
5757
- **Data Retrieval & RAG**: Implement specialized retriever agents for efficient information fetching and **Retrieval-Augmented Generation (RAG)**.
5858
- **Memory**: Enable agents to remember past interactions for more natural and context-aware conversations.
5959
- **LLM Compatibility**: Works with popular AI models from OpenAI, Google, Anthropic, and more, allowing easy switching.
@@ -152,7 +152,7 @@ Your agent is now running! To interact with it:
152152
- **Observability & Debugging:** Visually monitor agent states, interactions, logs, and performance via the [VoltAgent Console](https://console.voltagent.dev).
153153
- **Voice Interaction:** Build voice-enabled agents capable of speech recognition and synthesis using the `@voltagent/voice` package.
154154
- **Data Retrieval & RAG:** Integrate specialized retriever agents for efficient information fetching and **Retrieval-Augmented Generation (RAG)** from various sources.
155-
- **Model Control Protocol (MCP) Support:** Connect to external tool servers (HTTP/stdio) adhering to the [MCP standard](https://modelcontextprotocol.io/) for extended capabilities.
155+
- **Model Context Protocol (MCP) Support:** Connect to external tool servers (HTTP/stdio) adhering to the [MCP standard](https://modelcontextprotocol.io/) for extended capabilities.
156156
- **Prompt Engineering Tools:** Leverage utilities like `createPrompt` for crafting and managing effective prompts for your agents.
157157
- **Framework Compatibility:** Designed for easy integration into existing Node.js applications and popular frameworks.
158158

‎examples/base/package.json‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,15 @@
1111
"type": "module",
1212
"scripts": {
1313
"build": "tsc",
14-
"dev": "tsx watch --env-file=.env ./src -- --trace-warnings",
14+
"dev": "tsx watch --env-file=.env ./src",
1515
"start": "node dist/index.js",
1616
"volt": "volt"
1717
},
1818
"dependencies": {
1919
"@ai-sdk/openai": "^1.3.10",
20-
"@voltagent/cli": "^0.1.2",
21-
"@voltagent/core": "^0.1.4",
22-
"@voltagent/vercel-ai": "^0.1.2",
20+
"@voltagent/cli": "^0.1.3",
21+
"@voltagent/core": "^0.1.6",
22+
"@voltagent/vercel-ai": "^0.1.3",
2323
"zod": "^3.24.2"
2424
},
2525
"devDependencies": {

‎examples/base/src/index.ts‎

Lines changed: 18 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,26 @@
1-
import { VoltAgent, Agent } from "@voltagent/core";
1+
import { openai } from "@ai-sdk/openai";
2+
import { Agent, MCPConfiguration } from "@voltagent/core";
23
import { VercelAIProvider } from "@voltagent/vercel-ai";
34

4-
import { openai } from "@ai-sdk/openai";
5+
const mcpConfig = new MCPConfiguration({
6+
servers: {
7+
github: {
8+
type: "http",
9+
url: "https://mcp.composio.dev/github/mealy-few-wire-UfUhSQ?agent=cursor",
10+
},
11+
},
12+
});
513

614
const agent = new Agent({
7-
name: "Asistant",
8-
description: "A helpful assistant that answers questions without using tools",
15+
name: "GitHub Starrer Agent",
16+
description: "You help users star GitHub repositories",
917
llm: new VercelAIProvider(),
1018
model: openai("gpt-4o-mini"),
19+
tools: await mcpConfig.getTools(),
1120
});
1221

13-
new VoltAgent({
14-
agents: {
15-
agent,
16-
},
17-
});
22+
const result = await agent.streamText("Please star the repository 'composiohq/composio'");
23+
24+
for await (const chunk of result.textStream) {
25+
process.stdout.write(chunk);
26+
}

‎examples/github-repo-analyzer/package.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@
1111
"dependencies": {
1212
"@ai-sdk/openai": "^1.3.10",
1313
"@octokit/rest": "^21.0.0",
14-
"@voltagent/core": "^0.1.4",
15-
"@voltagent/vercel-ai": "^0.1.2",
14+
"@voltagent/core": "^0.1.6",
15+
"@voltagent/vercel-ai": "^0.1.3",
1616
"zod": "^3.24.2"
1717
},
1818
"devDependencies": {
1919
"@types/node": "^20.10.4",
20-
"@voltagent/cli": "^0.1.2",
20+
"@voltagent/cli": "^0.1.3",
2121
"tsx": "^4.6.2",
2222
"typescript": "^5.3.3"
2323
}

‎examples/with-google-ai/.env.example‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
GOOGLE_API_KEY=your_google_api_key

‎examples/with-google-ai/.gitignore‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
node_modules
2+
dist
3+
.DS_Store

‎examples/with-google-ai/README.md‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
<div align="center">
2+
<a href="https://voltagent.dev/">
3+
<img width="1800" alt="435380213-b6253409-8741-462b-a346-834cd18565a9" src="https://github.com/user-attachments/assets/452a03e7-eeda-4394-9ee7-0ffbcf37245c" />
4+
</a>
5+
6+
<br/>
7+
<br/>
8+
9+
<div align="center">
10+
<a href="https://voltagent.dev">Home Page</a> |
11+
<a href="https://voltagent.dev/docs/">Documentation</a> |
12+
<a href="https://github.com/voltagent/voltagent/tree/main/examples">Examples</a> |
13+
<a href="https://s.voltagent.dev/discord">Discord</a> |
14+
<a href="https://voltagent.dev/blog/">Blog</a>
15+
</div>
16+
</div>
17+
18+
<br/>
19+
20+
<div align="center">
21+
<strong>VoltAgent is an open source TypeScript framework for building and orchestrating AI agents.</strong><br>
22+
Escape the limitations of no-code builders and the complexity of starting from scratch.
23+
<br />
24+
<br />
25+
</div>
26+
27+
<div align="center">
28+
29+
[![npm version](https://img.shields.io/npm/v/@voltagent/core.svg)](https://www.npmjs.com/package/@voltagent/core)
30+
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg)](CODE_OF_CONDUCT.md)
31+
[![Discord](https://img.shields.io/discord/1361559153780195478.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://s.voltagent.dev/discord)
32+
[![Twitter Follow](https://img.shields.io/twitter/follow/voltagent_dev?style=social)](https://twitter.com/voltagent_dev)
33+
34+
</div>
35+
36+
<br/>
37+
38+
<div align="center">
39+
<a href="https://voltagent.dev/">
40+
<img width="896" alt="Screenshot 2025-04-20 at 22 44 38" src="https://github.com/user-attachments/assets/f0627868-6153-4f63-ba7f-bdfcc5dd603d" />
41+
</a>
42+
43+
</div>
44+
45+
## VoltAgent: Build AI Agents Fast and Flexibly
46+
47+
VoltAgent is an open-source TypeScript framework for creating and managing AI agents. It provides modular components to build, customize, and scale agents with ease. From connecting to APIs and memory management to supporting multiple LLMs, VoltAgent simplifies the process of creating sophisticated AI systems. It enables fast development, maintains clean code, and offers flexibility to switch between models and tools without vendor lock-in.
48+
49+
## Try Example
50+
51+
```bash
52+
npm create voltagent-app@latest -- --example with-google-ai
53+
```

0 commit comments

Comments
 (0)