# Veyllo (VAF)

> Veyllo is a local-first AI agent framework and harness (VAF), plus a hosted, OpenAI-compatible API. Run the agent on your own machine, self-host it, or build on the open-source framework. The Veyllo API supplies the models it runs on, so you can skip the infrastructure.

VAF turns a language model into a working agent: an orchestration loop with tool use, a persistent vector memory, delegable sub-agents, and sandboxed code execution. It is open-source (AGPL-3.0, with a commercial license available) and runs as a desktop app, a headless server, or a terminal on macOS, Windows, and Linux. The Veyllo API is a first-party, OpenAI-compatible gateway: one key for every model the agent needs, covering chat, vision, and speech-to-text transcription (processed in the EU).

## Product
- [Home](https://veyllo.app): What VAF is and the three ways to run it (desktop app, self-hosted, or the open-source framework)
- [Install](https://veyllo.app/download): Clone the repo and run one installer on macOS, Windows, or Linux
- [Self-host](https://veyllo.app/self-host): One VAF host on your own server; the whole team connects over HTTPS with separate accounts, no per-seat subscription
- [Framework](https://veyllo.app/framework): Build your own agents in Python: pip install vaf, a provider-agnostic Agent class, your own tools via BaseTool or MCP
- [For companies](https://veyllo.app/for-companies): Rolling VAF out to a team, the roles the agent can take over, and hands-on services (rollout, care, customization, custom tools)
- [Pricing](https://veyllo.app/pricing): Pay-as-you-go API pricing (per token; transcription metered per second), prepaid credits, no subscriptions or minimums

## Concepts
- [Local-first AI agents](https://veyllo.app/local-first-ai-agents): What a local-first AI agent is, how it compares to cloud and self-hosted agents, and why it matters for privacy, cost, and control

## API
- [Veyllo API preview](https://veyllo.app/api-preview): OpenAI-compatible endpoint at https://api.veyllo.app/v1, one key for chat, vision, and transcription

## Source
- [VAF on GitHub](https://github.com/Veyllo-Labs/VAF): Open-source agent framework (Python and TypeScript)
- [Documentation](https://github.com/Veyllo-Labs/VAF/tree/main/docs): Architecture, memory, tools, agents, and setup

## Languages
- The full site is available in German under the /de prefix, same structure per page: [Startseite (Deutsch)](https://veyllo.app/de), [Für Unternehmen](https://veyllo.app/de/for-companies), [Local-first KI-Agenten](https://veyllo.app/de/local-first-ai-agents)

## News
- [News index](https://veyllo.app/news): Articles on local-first AI agents and release notes for every VAF version
- [VAF 0.1.0a26: lower cost per request through prompt caching](https://veyllo.app/news/vaf-0-1-0a26): Release notes, VAF 0.1.0a26, 2026-08-25. VAF's daily spend limit stopped too late because the cached share went uncounted on Anthropic; 0.1.0a26 counts it.
- [VAF 0.1.0a24 and 0.1.0a25: hands-on control of the browser](https://veyllo.app/news/vaf-0-1-0a24-a25): Release notes, VAF 0.1.0a25, 2026-08-24. A fresh install of 0.1.0a24 never gets past the splash screen; 0.1.0a25 builds the interface and frees the next update too.
- [VAF 0.1.0a23: joining a room without a VAF install](https://veyllo.app/news/vaf-0-1-0a23): Release notes, VAF 0.1.0a23, 2026-08-16. In 0.1.0a23 a foreign client joins with one standard-library file; the sha256 and CA fingerprint in the invitation are what verify it.
- [VAF 0.1.0a22: agent rooms for working with other agents](https://veyllo.app/news/vaf-0-1-0a22): Release notes, VAF 0.1.0a22, 2026-08-16. In 0.1.0a22, vaf a2a create opens a room where a VAF agent works alongside others. By default it asks before anything on the machine changes.
- [VAF 0.1.0a21: sessions and models move to the terminal app](https://veyllo.app/news/vaf-0-1-0a21): Release notes, VAF 0.1.0a21, 2026-08-08. In 0.1.0a21, vaf run --web no longer starts the background service: the dashboard ends with the session, and vaf tray starts the persistent one.
- [VAF 0.1.0a20: vaf run opens a full-screen terminal app](https://veyllo.app/news/vaf-0-1-0a20): Release notes, VAF 0.1.0a20, 2026-08-05. In 0.1.0a20 the per-account tool selection is enforced for the first time: where a selection is set, only those tools run, admins excepted.
- [VAF 0.1.0a19: a built-in client replaces the mail dashboard](https://veyllo.app/news/vaf-0-1-0a19): Release notes, VAF 0.1.0a19, 2026-07-27. In 0.1.0a19, devices on the network have to sign in: with network access on, any of them used to reach pages and APIs without a token.
- [VAF 0.1.0a18: the logs window opens on a protection overview](https://veyllo.app/news/vaf-0-1-0a18): Release notes, VAF 0.1.0a18, 2026-07-23. In 0.1.0a18, VAF re-scans installed skills and takes high-risk ones out of the agent's reach until an admin deletes or restores them.
- [VAF 0.1.0a17: VAF is on PyPI](https://veyllo.app/news/vaf-0-1-0a17): Release notes, VAF 0.1.0a17, 2026-07-22. In 0.1.0a17, pip install --pre vaf installs the framework as a library; desktop and server still come from the installers.

## Optional
- [Terms of Service](https://veyllo.app/legal/terms)
- [Privacy Policy](https://veyllo.app/legal/privacy)
- [Imprint](https://veyllo.app/legal/imprint)