系统要求
AiHummer 是一个原生主机产品：它以发布的 tar 包形式在 systemd 下运行，因此对环境的要求故意保持很小。唯一的硬性依赖是带有 PostgreSQL 的 Linux 主机。其他一切——sidecar、真实模型、向量存储——都是可选的，可以以后从管理界面添加。
[!NOTE] AiHummer 是 宿主机本地，而非 Docker。 它作为在……下运行的 tar 包部署 来自 systemd
~/.aihummer(运行该命令的用户的主目录 安装程序）。您不需要容器运行时、Kubernetes或任何 协调者。
操作系统
AiHummer 运行于 仅限 Linux没有 Windows 或 macOS 服务器 版本——网关及其侧车按架构的 Linux 构件打包，并通过 systemd 部署。（客户端是单独的移动和桌面应用；那是一个通道，而不是服务器。）
- 一个现代的64位Linux发行版，带有
systemd. x86_64(amd64) 或arm64— 安装程序会拉取匹配的每架构包。sudo/root 访问权限是 不是严格要求：正常安装通过sudo，但是不使用 root 运行安装程序会在无根模式下安装 AiHummer 模式下systemd --user— 参见 安装.
数据库
PostgreSQL 是 仅硬依赖 以及所有状态的唯一真实来源。 pgcrypto 扩展是 必需的 ——它支持加密凭证存储库。没有数据库，网关将以简化的仅健康模式启动，并且无法提供任何有用的服务。
[!IMPORTANT] 启用
pgcrypto在第一次运行之前的目标数据库中：CREATE EXTENSION IF NOT EXISTS pgcrypto;
网关通过 DSN 连接到 AIHUMMER_DATABASE_URL. 对于多租户隔离，您还可以指向 AIHUMMER_DB_APP_URL 在受限的 aihummer_app 角色用于激活 Postgres 行级安全；本地安装会自动设置此功能。数据库迁移是前向安全的，并在所有者池上的咨询锁下自动应用。
硬件
这些数据是针对网关加 PostgreSQL 的单主机部署的指导。Sidecars（STT/TTS、浏览器、向量存储）会增加自身的占用，通常仅在小型部署中才放置在同一主机上。
| 个人资料 | 中央处理器 | 随机存取存储器 | 磁盘 | 笔记 |
|---|---|---|---|---|
| 最小值（eval） | 2 核虚拟中央处理器 | 2 GB | 10 GB | 网关 + Postgres，模拟模型，无边车 |
| 推荐 | 4 核虚拟中央处理器 | 8 GB | 40 GB 固态硬盘 | 网关 + Postgres + 几个边车 |
| 语音 / 本地模型 | 8+ 个 vCPU（可选 GPU） | 16+ GB | 80+ GB SSD | 语音转文本/文本转语音，嵌入器，本地大语言模型端点 |
磁盘使用量会随着对话历史、媒体二进制目录增长AIHUMMER_BLOB_DIR）、知识摄取和审计保留。根据情况规划 PostgreSQL 备份（pg_dump + WAL/PITR）。
侧车（可选）
边车是 独立的 HTTP 服务每个都在自己的 systemd 单元下运行。网关通过 URL 访问它们，因此 sidecar 可以在同一主机、另一台主机上运行，或者你可以指向一个现有实例。它们都是免费的/本地的，并且对于基本部署从不必需。
| 边车 | 默认端口 | 启用 |
|---|---|---|
| STT（faster-whisper） | 8001 | 语音转文本 |
| TTS（edge-tts） | 8002 | 语音轮换的文本转语音 |
| 视频（ffmpeg） | 8005 | 视频理解 |
| SearXNG | 8888 | 这 web_search 工具 |
| Chrome/CDP | 9222 | 这 browser / computer 工具 |
STT、TTS、视频、网页搜索（SearXNG）和浏览器（CloakBrowser）全部由安装程序开箱即装。搜索和浏览器的载荷随签名的安装程序捆绑包一起提供并离线安装：用 --no-search / --no-browser 关闭它们，或用 --external-search=URL / --external-browser=URL 接入您已经运行的实例来替代本地安装。用 AIHUMMER_SKIP_* 变量跳过语音边车。语义嵌入器是 选择加入 (--with-embedder): 它会拉取 PyTorch（数百 MB），如果没有它，内存会回退到词汇搜索。参见 安装.
[!NOTE] Node.js（20 或更新版本）也随安装程序捆绑包一起提供并离线安装， 因此 Node.js 插件——AiHummer 应用、pocket-agent 和渠道连接器—— 即使在自带 Node.js 太旧的发行版上也能开箱即用。
大型语言模型提供商
AiHummer 从不需要付费模型。它可直接在免费/本地模型和 Codex/ChatGPT 订阅传输上使用；每个租户的 BYOK 密钥是完全可选的。
支持的提供商：
- 人类中心的
- OpenAI。
- 任何符合 OpenAI API 标准的端点 — 本地模型服务器、OpenRouter，或 例如，双子座的 OpenAI 兼容端点。
- Codex / ChatGPT 订阅传输 ——通过 ChatGPT 驱动一个模型 订阅而不是计费的 API 密钥。
[!TIP] 如果你在没有连接模型的情况下启动网关 (
AIHUMMER_LLM_PROVIDER/AIHUMMER_LLM_MODEL/AIHUMMER_LLM_GATEWAY_URL), 回复来自一个确定性的 嘲笑 这样你就可以验证频道并 在连接真实模型之前进行路由。
[!NOTE] AiHummer 仅暴露与 OpenAI 兼容的
POST /v1/chat/completions端点。那里有 不/v1/models或者/v1/embeddingsHTTP端点，以及 可观测性是 OTLP 推送（没有 Prometheus/metrics).