feat: add with-ollama example

Author: omeraplak

examples/with-ollama/.env.example

@@ -0,0 +1,2 @@
+# Ollama host configuration (default points to the local daemon)
+OLLAMA_HOST=http://localhost:11434/api

examples/with-ollama/README.md

@@ -0,0 +1,51 @@
+# VoltAgent + Ollama Example
+
+This sample shows how VoltAgent uses `ollama-ai-provider-v2` with a Zod-powered tool. The `get_current_weather` tool demonstrates that Ollama receives the JSON Schema definition and calls it with the correct arguments.
+
+## Requirements
+
+- [Ollama](https://ollama.com/download) must be installed and running.
+- Pull a tool-calling capable model such as `llama3.2`:
+
+```bash
+ollama pull llama3.2
+```
+
+- (Optional) Point to a custom Ollama host via `.env`:
+
+```env
+OLLAMA_HOST=http://localhost:11434/api
+```
+
+The example defaults to `http://localhost:11434/api`.
+
+## Install
+
+```bash
+pnpm install
+```
+
+> Inside the monorepo you can scope it with `pnpm install --filter voltagent-example-with-ollama...`.
+
+## Run
+
+```bash
+pnpm start
+```
+
+By default the HTTP server listens on port `3144`. Set the `PORT` environment variable if you need to change it.
+
+### Calling the Agent
+
+Send a request to VoltAgent’s REST API once the server is running:
+
+```bash
+curl -X POST http://localhost:3144/agents/ollama-tool-agent/text \
+  -H "Content-Type: application/json" \
+  -d '{"input":"What is the weather in Madrid right now?"}'
+```
+
+You should see:
+
+1. The server response containing the model’s answer.
+2. Logs in the console showing `Weather tool invoked`, which confirms that Ollama received the JSON Schema definition and triggered the tool with the expected parameters.

examples/with-ollama/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "voltagent-example-with-ollama",
+  "private": true,
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "agent",
+    "ai",
+    "voltagent",
+    "ollama"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch --env-file=.env ./src/index.ts",
+    "start": "tsx --env-file=.env ./src/index.ts",
+    "volt": "volt"
+  },
+  "dependencies": {
+    "@voltagent/cli": "^0.1.15",
+    "@voltagent/core": "^1.2.1",
+    "@voltagent/logger": "^1.0.4",
+    "@voltagent/server-hono": "^1.2.2",
+    "ai": "^5.0.76",
+    "ollama-ai-provider-v2": "^1.5.3",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.2.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2"
+  }
+}

examples/with-ollama/src/index.ts

@@ -0,0 +1,47 @@
+import { Agent, VoltAgent, createTool } from "@voltagent/core";
+import { createPinoLogger } from "@voltagent/logger";
+import { honoServer } from "@voltagent/server-hono";
+import { createOllama } from "ollama-ai-provider-v2";
+import { z } from "zod";
+
+const logger = createPinoLogger({
+  name: "with-ollama",
+  level: "info",
+});
+
+const ollama = createOllama({
+  baseURL: process.env.OLLAMA_HOST ?? "http://localhost:11434/api",
+});
+
+const getCurrentWeather = createTool({
+  name: "get_current_weather",
+  description: "Fetch the current weather conditions for a given city",
+  parameters: z.object({
+    location: z.string().describe("City or location to inspect"),
+    unit: z.enum(["celsius", "fahrenheit"]).default("celsius"),
+  }),
+  execute: async ({ location, unit }) => {
+    return {
+      location,
+      temperature: unit === "fahrenheit" ? 72 : 22,
+      condition: "Partly cloudy with light winds",
+      unit,
+    };
+  },
+});
+
+const agent = new Agent({
+  name: "ollama-tool-agent",
+  instructions: "You are a helpful assistant",
+  model: ollama("llama3.2:latest"),
+  tools: [getCurrentWeather],
+  logger,
+});
+
+new VoltAgent({
+  agents: {
+    agent,
+  },
+  logger,
+  server: honoServer(),
+});

examples/with-ollama/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "outDir": "dist",
+    "skipLibCheck": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}