框架

在 VAF 上构建您自己的智能体。

驱动桌面应用的同一引擎，以 Python 库的形式交付。一次 pip install、不绑定供应商的 Agent、您自己的工具，以及允许发行的许可证。

快速上手

三行代码，智能体跑起来。

Agent 类是框架的稳定接口。同一份代码既能跑完全本地的 GGUF 模型（什么都不离开电脑），也能跑任意受支持的 API 供应商：veyllo、openai、anthropic、google、deepseek、openrouter。

✓

流式输出内置。 传入 on_token，增量在生成时即刻到达。

✓

对话可持久化。 save_session() 写入标准会话存储；把 id 传回来，记忆完好地接着聊。

✓

您的工具，自动识别。 继承 BaseTool，或把您的工具作为独立 pip 包发布，智能体启动时自动识别。MCP 服务器以同样方式接入。

阅读嵌入指南可运行示例

quickstart.py

from vaf import Agent

# a local GGUF model, or any API provider
agent = Agent(config={"provider": "local"})

answer = agent.run("Summarize my inbox.")
print(answer)

# stream tokens as they arrive
agent.run("Explain async/await.",
    on_token=lambda s: print(s, end=""))

# persist and resume a conversation
sid = agent.save_session()
agent = Agent(config={"provider": "local"}, session=sid)

默认精简

只装您的智能体需要的。

基础安装是核心运行时加供应商 SDK。重型功能是可选组件；缺少组件的工具保持未加载，智能体照常运行。

vaf[server]HTTP 与 WebSocket API

vaf[desktop]桌面窗口与托盘

vaf[memory]长期 RAG 记忆（pgvector）

vaf[speech]离线语音转写

vaf[browser]浏览器自动化工具

vaf[pdf]PDF 提取与 OCR

vaf[docs]Office 文档工具

vaf[all]全部组件，与完整产品对齐

许可

您的工具归您。

VAF 以 AGPL-3.0 开源，另加一条明确授权：通过公开接口与 VAF 通信的插件、工具与工作流，可按您选择的许可证发布，专有条款亦可。若要把 VAF 本身嵌入闭源产品或 SaaS，可购买商业许可证。

pip install，然后开始构建。

嵌入指南逐步讲解工具、会话、异步用法与打包。

阅读嵌入指南 Get an API key