Guaardvark 是一款自托管 AI 工作室，全部能力运行在用户自己的硬件上，通过 Ollama、ComfyUI 和 Guaardvark 自有 GPU 服务实现。它不要求云 API 密钥，没有按 token 或按分钟的费用，也不向外部发送数据；网络访问、发帖等所有出站路径默认关闭，直到用户主动开启，并且这些路径统一声明在 egress.json 文件中。
主要能力
-
本地 RAG 文件对话 基于 pgvector 的本地 RAG：每次查询融合关键词与向量搜索，使用交叉编码器重排序，提供来源引用，并展示答案背后的文本块和分数。PDF、DOCX、PPTX 按阅读顺序和章节标题解析，PDF 段落携带页码；代码使用 AST 感知的分块，保证函数完整。检索可显示实际使用的文本块与得分，并能返回查询轨迹。Autoresearch 可在夜间自动调整检索设置。
-
桌面与浏览器智能体 智能体控制一个真实的 Ubuntu 桌面（Xvfb 和 XFCE，display :99），通过视觉模型看屏幕、移动鼠标、点击、输入、浏览并检查自身工作。桌面与用户会话隔离，有独立的 XDG_DESKTOP_DIR 和 XDG_CONFIG_HOME。视觉模型在单次推理中返回点击坐标，采用闭环瞄准，移动后检查光标实际落点并纠正。每一步推理、动作、目标都实时流入聊天并保留历史。常见浏览器操作由确定性配方库即时执行。屏幕智能体仅支持 Linux；macOS 上会明确说明该工具不可用，不影响其他功能。
-
并行编码智能体（Swarm） 同时启动多个编码智能体，每个在独立的 git worktree 和分支上工作。结果按依赖顺序合并，冲突检测、可选测试验证和实时仪表盘。后端可使用 Claude Code，或通过 Ollama 在本地运行 Cline/OpenClaw。Flight Mode 保持离线，仅使用本地后端。默认同时运行 5 个智能体，仪表盘最多支持 20 个。
-
MCP 服务器、智能体技能与 Claude Code 插件 双向支持 Model Context Protocol：既可将工具暴露给任意 MCP 客户端，也可调用其他 MCP 服务器上的工具。python -m backend.mcp install 可自动发现并配置 Claude Code、Codex、Cursor、Grok、Antigravity、opencode、Claude Desktop、Zed、Gemini CLI 等客户端；python -m backend.mcp doctor 可诊断配置问题。Claude Code 插件可通过 /plugin marketplace add guaardvark/guaardvark 和 /plugin install guaardvark@guaardvark 安装。默认暴露 50 多个工具（RAG、文件、生成、记忆、代码搜索、Web），桌面控制、shell、浏览器自动化等默认隐藏，需要加入允许列表。
-
本地视频、图像、音乐与语音生成 视频：13 个本地视频模型，涵盖 Wan 2.2、LTX、HunyuanVideo、CogVideoX 和 MiniMax H3 五个家族。支持 512 至 1920px 分辨率、Fast/Standard/High/Maximum 质量档位、RIFE 帧插值、提示增强风格、低显存模式和批量队列。MiniMax H3 可一次生成画面与声音。视频生成通常需要 16GB 级别显卡，Wan 2.2 5B 可从 11GB 开始。 图像：Z-Image、FLUX.1、Krea 2、SDXL 和 Sana Sprint 生成，指令式照片编辑、修补与扩展、4K/8K 放大。 音乐与语音：完整带人声歌曲、音效、三种神经 TTS 引擎、经同意的语音克隆和免提语音聊天。
-
LoRA 训练与一致角色 可用少量参考照片在自己的 GPU 上训练角色、环境和道具 LoRA，也可导入在其他地方训练的 LoRA，并在图像、视频、音乐视频和 Film Crew 制作中保持同一角色。
-
导演功能 节拍同步的音乐视频导演、五角色 Film Crew（将一句话梗概变成完整视频）和内置视频编辑器。
-
自我改进与命令中心 Guaardvark 可测试自身、起草修复并在代码库锁后等待用户审查；系统地图根据真实导入关系绘制整个代码库。GPU 编排器、带实时 VRAM 预算的插件管理器、任务与调度、模式感知备份和多机 Interconnector。
-
终端与 API 提供 guaardvark CLI 交互式 REPL，以及 REST、GraphQL 和 Socket.IO 接口。
安装与使用 需要 Linux 和 NVIDIA GPU（视频 16GB，Wan 2.2 5B 为 12GB；聊天、RAG 和智能体所需更低）。全新 Ubuntu 桌面需先运行 sudo apt install -y curl git。安装脚本为仓库中的 install.sh，会克隆到 ~/guaardvark 并运行 ./start.sh，首次运行安装全部组件。之后打开 http://localhost:5173。也可先下载脚本阅读后再运行，或手动安装。其他方式包括 Docker、Apple Silicon 上的 macOS、PyPI 上的 CLI 和完整安装指南。
适用场景与限制 适合希望在本地 GPU 上统一运行 RAG、智能体、编码协作和媒体生成的用户，尤其是重视数据不出本地、无云费用的场景。限制包括：需要 Linux 和 NVIDIA GPU；屏幕智能体仅 Linux 可用；部分模型有显存要求和许可证要求（如 MiniMax H3 社区许可证涉及特定地区申请）；扫描文档的 OCR 默认未安装。具体硬件分级、完整能力列表见文档 CAPABILITIES.md 和 docs/HARDWARE.md。
