FAQ
Frequently asked questions about OpenVesper.
General
What is OpenVesper?
An open-source AI agent framework that runs on your own machine. You bring an LLM provider key (Anthropic, OpenAI, Groq, Ollama, etc.), and OpenVesper handles agent personas, tool execution, memory, and scheduling. See Getting Started.
How is this different from a chatbot?
Chatbots respond to messages. Agents take actions. OpenVesper agents can call tools (47 plugins shipped) to fetch data, send messages, write files, schedule jobs, and more.
Is OpenVesper hosted somewhere?
No. There are no OpenVesper servers. The framework runs entirely on your machine. You can self-host it on a VPS if you want it always-on.
Privacy & security
Where does my data go?
Your prompts go to your chosen LLM provider (Anthropic, OpenAI, etc.) according to their privacy policy. Tool calls go to the external APIs you've configured (Telegram, GitHub, etc.). Nothing is sent to us because we have no servers. See Security policy.
Does OpenVesper ask for wallet keys?
No. Never. No plugin, agent, or skill in this repository asks for a wallet private key or seed phrase. The framework cannot move funds.
Is my memory or conversation history sent anywhere?
No. Memory, conversation persistence, and heartbeat state all live on your disk at ~/.openvesper/. They are also disabled by default — you have to opt in.
Setup
Why pnpm and not npm?
OpenVesper is a monorepo with 56 packages. pnpm's workspace support is significantly faster and handles internal package linking correctly. npm install in this repo will produce broken dependencies.
Which LLM provider should I use?
- Anthropic Claude — highest quality, paid
- Groq — fast, free tier available
- Gemini — Google, free tier available
- OpenAI — quality, paid
- Ollama — fully local, free, slower
You can mix providers — different agents can use different models.
Can I run OpenVesper fully offline?
Yes, with Ollama. Set OLLAMA_HOST=http://localhost:11434 in your env. Some plugins (crypto prices, news) still need internet for external APIs, but the LLM itself runs locally.
Plugins & agents
Can I write my own plugin?
Yes. A plugin is a TypeScript file with a few exports. See Plugins for the SDK reference and a minimal example.
Can I write my own agent?
Yes, and you don't need to write code. An agent is six markdown files in a directory. Copy an existing one and edit. See Agents.
Does the LLM see all tools, or just the agent's?
All loaded tools, by default. OpenVesper uses a single global tool registry — agents don't have per-agent whitelists. The agent's TOOLS.md documents intent, not a runtime gate. Mutating operations are gated by tool-level permissions instead.
Trading & crypto
Does OpenVesper trade crypto?
No. OpenVesper is for research, analysis, and orchestration. Trading execution on perpetual DEXes (Hyperliquid, Lighter, Drift) is not bundled. We provide read-only analytics only.
Can I add my own trading plugin?
That's your choice in a fork. We don't bundle it because key management for trading is a separate, security-critical concern that doesn't belong in an LLM-driven framework.