Requisitos del sistema — AiHummer Documentos

AiHummer es un producto nativo del host: se ejecuta como un tarball de lanzamiento bajo systemd, por lo que los requisitos son deliberadamente pequeños. La única dependencia estricta es un host Linux con PostgreSQL. Todo lo demás — sidecars, un modelo real, un almacén de vectores — es opcional y se puede agregar más tarde desde la interfaz de administración.

[!NOTE] AiHummer es nativo del host, no Docker. Se despliega como un archivo tar que se ejecuta bajo systemd desde ~/.aihummer (el directorio principal del usuario que ejecutó la instalador). No necesitas un runtime de contenedor, Kubernetes ni nada orquestador.

Sistema operativo

AiHummer funciona con Solo Linux. No hay una versión servidor para Windows o macOS: la puerta de enlace y sus sidecars se empaquetan como artefactos Linux por arquitectura y se despliegan con systemd. (El cliente es una aplicación móvil y de escritorio separada; eso es un canal, no el servidor.)

Una distribución moderna de Linux de 64 bits con systemd.
x86_64 (amd64) o arm64 — el instalador descarga el paquete correspondiente por arquitectura.
sudo/el acceso root es no estrictamente requerido: una instalación normal se ejecuta a través de sudo, pero ejecutar el instalador sin root instala AiHummer sin privilegios de root modo bajo systemd --user — ver Instalación.

Base de datos

PostgreSQL es el solo dependencia estricta y la única fuente de verdad para todo el estado. El pgcrypto la extensión es requerido — respalda el depósito de credenciales cifradas. Sin una base de datos, la puerta de enlace se inicia en un modo reducido solo salud y no sirve nada útil.

[!IMPORTANT] Habilitar pgcrypto en la base de datos de destino antes de la primera ejecución:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

La puerta de enlace se conecta a través de un DSN en AIHUMMER_DATABASE_URL. Para el aislamiento multitenant, también puede apuntar AIHUMMER_DB_APP_URL en una zona restringida aihummer_app rol para activar la seguridad a nivel de fila de Postgres; las instalaciones locales configuran esto automáticamente. Las migraciones de la base de datos son seguras hacia adelante y se aplican automáticamente bajo un bloqueo asesor en el grupo propietario.

Hardware

Estas cifras son una orientación para una implementación de un solo host del gateway más PostgreSQL. Los sidecars (STT/TTS, navegador, almacén vectorial) añaden su propia huella y generalmente se colocan en el mismo host solo para implementaciones pequeñas.

Perfil	CPU	RAM	Disco	Notas
Mínimo (eval)	2 vCPU	2 GB	10 GB	Gateway + Postgres, modelo simulado, sin sidecars
recomendada	4 vCPU	8 GB	SSD de 40 GB	Gateway + Postgres + un par de sidecars
Voz / modelos locales	8+ vCPU (GPU opcional)	16+ GB	SSD de 80+ GB	STT/TTS, incrustador, punto final local de LLM

El uso de disco crece con el historial de conversaciones, el directorio de blobs de medios (AIHUMMER_BLOB_DIR), ingestión de conocimientos y retención de auditorías. Planifique las copias de seguridad de PostgreSQL (pg_dump + WAL/PITR) en consecuencia.

Sidecares (opcionales)

Los sidecares son servicios HTTP separados, cada uno bajo su propia unidad systemd. La puerta de enlace los alcanza mediante URL, por lo que un sidecar puede ejecutarse en el mismo host, en otro host, o puedes apuntar a una instancia existente. Todos son gratuitos/locales y nunca se requieren para una implementación básica.

Sidecar	Puerto predeterminado	Habilita
STT (susurro más rápido)	8001	Reconocimiento de voz para turnos de habla
TTS (edge-tts)	8002	Texto a voz para turnos de voz
Video (ffmpeg)	8005	Comprensión de video
SearXNG	8888	la `web_search` herramienta
Chrome/CDP	9222	la `browser` / `computer` herramientas

STT, TTS, video, la búsqueda web (SearXNG) y el navegador (CloakBrowser) se instalan todos de fábrica por el instalador. Las cargas de búsqueda y navegador viajan dentro del paquete firmado del instalador y se instalan sin conexión: desactívalas con --no-search / --no-browser, o adjunta una instancia que ya ejecutes con --external-search=URL / --external-browser=URL en lugar de una instalación local. Omite los sidecars de voz con las variables AIHUMMER_SKIP_*. El incrustador semántico es optar por participar (--with-embedder): descarga PyTorch (cientos de MB), y sin él la memoria vuelve a la búsqueda léxica. Ver Instalación.

[!NOTE] Node.js (versión 20 o más reciente) también viaja dentro del paquete del instalador y se instala sin conexión, por lo que los complementos de Node.js — la aplicación AiHummer, pocket-agent y los conectores de canales — funcionan de fábrica incluso en distribuciones cuyo propio Node.js es demasiado antiguo.

Proveedores de LLM

AiHummer nunca requiere un modelo de pago. Funciona directamente con modelos gratuitos/locales y un transporte con suscripción de Codex/ChatGPT; las claves BYOK por inquilino son estrictamente opcionales.

Proveedores compatibles:

Antrópico.
OpenAI.
Cualquier endpoint estándar de la API de OpenAI — servidores de modelos locales, OpenRouter, o El endpoint compatible con OpenAI de Gemini, por ejemplo.
Transporte de suscripción Codex / ChatGPT — conducir un modelo a través de un ChatGPT suscripción en lugar de una clave API facturada.

[!TIP] Si empiezas la puerta de enlace sin un modelo conectado (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), las respuestas provienen de un determinista burlarse para que puedas validar canales y enrutamiento antes de conectar un modelo real.

[!NOTE] AiHummer expone solo lo compatible con OpenAI POST /v1/chat/completions punto final. Hay no /v1/models o /v1/embeddings punto de enlace HTTP, y la observabilidad es OTLP-push (sin Prometheus /metrics).

¿A dónde vamos ahora?

¿Listo para desplegar? Ve a Instalación.
¿Quieres caminar la primera carrera paso a paso? Mira el Inicio rápido.
¿Quieres el modelo mental primero? Lee el Introducción.