瓦尔戈斯
自托管代理操作系统。 在您的硬件上提供任何LLM持久内存、多通道存在、工具、调度和子代理编排。
它的作用
- 任何 LLM --Anthropic、OpenAI、谷歌、OpenRouter、Ollama、LM Studio、Groq、Together、DeepSeek、Mistral、烟花、困惑
- 多渠道存在 --连接WhatsApp和Telegram机器人，将消息路由到代理
- 自动工具发现 --每个服务功能都可以作为代理工具使用
- MCP集成 --将代理的工具暴露给其他应用程序，连接外部工具服务器
- 持久内存 --跨工作区文件和对话历史的矢量+关键字搜索
- 预定任务 --按计划运行代理任务，将结果发送到通道
- 网络钩子 --从外部系统（GitHub、监控等）触发代理任务
- 次级代理代表团 --代理可以为并行或分层工作生成子代理
- 媒介智讯 --自动处理图像和音频（视觉、转录）
快速开始
# npx (no install)
npx @chozzz/vargos
# or clone + run
git clone https://github.com/chozzz/vargos.git
cd vargos
pnpm install
pnpm start首次运行启动交互式设置向导（提供程序、模型、API键）。配置已保存到 ~/.vargos/.
设置后： vargos start 启动服务器， vargos onboard 重新运行向导， vargos config 显示当前设置。
建筑
┌──────────────────────────────────────┐
│ Gateway (EventEmitterBus + TCP) │
└────────────┬─────────────────────────┘
│
┌───────────────────────┼────────────────────────┐
│ │ │
↓ ↓ ↓
┌─────────┐ ┌──────────┐ ┌────────────┐
│ Config │ │ Agent │ │ CLI │
│ Log │ │ Channels │ │ External │
│ Memory │ │ Cron │ │ Clients │
└─────────┘ └──────────┘ └────────────┘服务是隔离的——没有共享状态，只能通过内部API进行通信。这使得Vargos可靠且易于扩展。
关键概念
- 代理 --一个读取指令、查看可用工具并决定如何帮助你的人工智能系统
- 频道 --一个消息平台（WhatsApp、Telegram），用户可以在其中与代理交谈
- 系统提示 --告诉代理如何行为的指令（合并自
AGENTS.md,SOUL.md,TOOLS.md在您的工作区+每个频道的角色文件中） - 会话 --与一个用户的对话线程；Vargos记得以前的消息
- 工具 --代理可以使用的功能（读取文件、运行代码、获取URL、发送消息）
- 工作区 --Vargos存储指令、技能和对话历史的项目文件夹
消息处理
消息通过一个简单的管道： 接收→ 过程→ 执行→ 回应。代理可以访问所有Vargos工具和您的工作区上下文。看 频道 了解详情。
文档
| 文档 | 描述 |
|---|---|
| 入门指南 | 安装、首次运行、配置向导 |
| 配置 | 完整配置参考 |
| 频道 | WhatsApp和Telegram设置 |
| 主控程序 | MCP服务器和客户端集成 |
| 会话 | 会话类型和生命周期 |
| 运行时 | 代理商如何执行 |
| 工作区文件 | AGENTS.md、SOUL.md、TOOLS.md参考 |
| 故障排除 | 常见问题和修复 |
| 路线图 | 计划功能 |
示例
用法
vargos # First-run wizard or help
vargos start # Boot the server (gateway + all services)
vargos onboard # Re-run setup wizard
vargos config # Show current configuration发展
pnpm install # Install deps
pnpm start # Start gateway + all services (alias: vargos start)
pnpm chat # Pi SDK interactive REPL bound to ~/.vargos/agent
pnpm seed # Re-seed .templates/vargos/ → ~/.vargos/ (idempotent)
pnpm cli # Run the CLI entrypoint directly (tsx cli.ts)
pnpm test # Tests (watch mode)
pnpm run test:run # Tests (single run)
pnpm run typecheck # TypeScript check
pnpm lint # ESLint + typecheck
pnpm build # Clean + compile + copy templates → dist/
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for architecture details, event reference, and development guidelines.
## License
[Apache-2.0](./LICENSE)