# Evey Setup

> 仓库地址：https://github.com/42-evey/evey-setup
> 作者/组织：42-evey
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
一个一键部署完整自主 AI agent 基础设施的安装器，5 分钟内搭建含 29 个插件的全栈环境，使用免费模型实现"日成本 $0"运行。

## 项目定位与架构
Evey Setup 解决的是 Hermes Agent 全栈部署的复杂性问题——从 agent 本体到 model proxy、向量数据库、搜索引擎、监控、工作流自动化，一条命令搞定。

分层架构：User Interface Layer (Telegram/CLI/Discord) → hermes-agent → Service Layer (LiteLLM proxy + Ollama + MQTT + SearXNG + Qdrant) → Model Providers (OpenRouter free tier + local Ollama)。所有服务绑定 `127.0.0.1`，不对外暴露。

三级服务层：Base（3 服务：agent + LiteLLM + Ollama）、Services（7 服务：+ MQTT + SearXNG + Qdrant + ntfy）、Full（12+ 服务：+ n8n + Langfuse + Uptime Kuma + PostgreSQL）。安装分四阶段独立执行：prerequisites → docker containers → plugins → wizard 配置。

## 关键技术特性
- **零成本运行**：默认 MiMo-V2-Pro + 7 个免费 fallback models via OpenRouter，日成本 $0
- **Model routing + fallbacks**：LiteLLM proxy 自动切换 provider，含 budget limit（默认 $10/天）
- **29 个社区插件**：分 core/observability/social/memory/quality/extra 六类
- **安全设计**：所有端口 localhost only、`openssl rand` 自动生成密钥、PII 脱敏、日志轮转（10MB max）
- **可选 GPU 推理**：NVIDIA GPU 通过 Ollama 运行 hermes3:8b 和 qwen3.5:4b
- **四阶段安装**：每阶段可独立运行和重试

## 设计亮点与创新
"免费模型 + 本地部署"的定位非常务实——解决了 AI agent 运营成本和数据隐私的双重顾虑。LiteLLM proxy 的 model routing + fallback chain 确保了服务可用性。29 个插件覆盖了从目标管理到习惯追踪的广泛场景。$69/月硬件成本的透明度也增加了项目可信度。

## 局限性与风险
限定单机本地部署，不适合分布式场景。MQTT 默认无认证（localhost 可接受，暴露则有风险）。依赖 OpenRouter 免费层（策略可能变更）。Docker + 5GB 存储的硬件要求对低配设备有门槛。不支持远程访问（需 SSH tunnel）。

## 与生态系统的关联
与 nix-hermes-agent（NixOS 声明式）、hermes-agent-docker（最小 Docker）、portainer-stack-hermes（Portainer 集成）同属部署工具链。Evey Setup 是其中最"全栈"的方案，集成了最多辅助服务。29 个插件来自 42-evey/hermes-plugins 仓库，扩展了 Hermes Agent 的能力边界。