Open source · Self-hosted

El agente de IA que conoce tu comunidad de Discord

Hivly indexa la documentación, los archivos y las fuentes de tu servidor, y responde a tus miembros en lenguaje natural — citando siempre de dónde viene cada respuesta.

En tu infraestructura Anthropic u OpenAI Un solo servidor
tres comandos para levantarlo
$ git clone https://github.com/hivly/hivly
$ cd hivly && cp .env.example .env
# Discord IDs · DATABASE_URL · API key
$ docker compose up -d
✓ hivly listo en http://localhost:3000

// qué hace

Conocimiento disperso, respuestas con fuente

Indexa tu conocimiento

Conecta enlaces, documentos y archivos. Hivly los divide en fragmentos y construye una base de búsqueda semántica con pgvector.

Responde con fuentes

Cada respuesta basada en tu conocimiento cita su procedencia. Verificable por diseño: nada de afirmaciones sin respaldo.

Tú tienes el control

Eliges el modelo, el prompt y qué tools puede usar el agente. Los permisos viven en tu runtime, no en el modelo.

// cómo funciona

Un runtime de agente, no un bot de respuestas fijas

El corazón de Hivly es un bucle de ejecución implementado con LangChain.js: razona, actúa y observa hasta resolver la consulta.

Paso 01 · razonar

Razonar

El runtime arma el contexto —system prompt, tools disponibles, historial y fragmentos recuperados— y llama al modelo, que decide el siguiente paso.

# LangChain.js · AgentExecutor
await runtime.buildContext({
systemPrompt, tools, history, chunks
});

Toda la potencia y todo el control de seguridad viven en el runtime, no en el modelo. El modelo solo razona; el runtime actúa.

// casos de uso

Para qué lo usan las comunidades

Preguntas recurrentes

Las dudas que se repiten cada semana se responden solas, con la fuente exacta.

Onboarding de miembros

Los nuevos encuentran reglas, guías y recursos sin esperar a un moderador.

Soporte técnico

Respuestas precisas sobre tu producto o tus docs, citando el fragmento de origen.

Buscar en el histórico

Recupera lo dicho en hilos y documentos sin recordar las palabras exactas.

// instalación

Un comando para levantarlo

El paquete trae el backend, la app, el panel de admin y una base Postgres con pgvector. Lo descargas y lo corres en tu propia infraestructura.

Clona el repositorio

$ git clone github.com/hivly/hivly
$ cd hivly

Configura el entorno

$ cp .env.example .env
# DISCORD_GUILD_ID, DATABASE_URL…

Levanta la instancia

$ docker compose up -d
✓ app + postgres + redis

// documentación

Documentación navegable

Todo lo que necesitas para desplegar y operar tu instancia, organizado por secciones.

// stack tecnológico

Construido sobre piezas sólidas

TypeScript / Node.js
Backend y runtime
LangChain.js
Orquestación del agente
Postgres + pgvector
Datos y búsqueda vectorial
Redis Streams
Cola de eventos · outbox
React + TypeScript
App y panel de admin
Docker Compose
Empaquetado en un comando
Sentry · Pino · Prometheus
Observabilidad
Astro
Landing estática

Clean Architecture

Separación en capas con dependencias hacia adentro.

Interface Controllers · UI React
Application Use cases · runtime
Domain Entidades · eventos
Infrastructure Postgres · LangChain · Redis

Domain no depende de nada; las capas externas implementan sus puertos.

Event-Driven

La indexación pesada se desacopla del runtime con Redis Streams y el patrón Outbox.

knowledge.source.added reindex.requested

Despliega tu propio agente hoy

Open source, self-hosted y verificable. Tu conocimiento nunca sale de tu infraestructura.