octarq
Octarq es un backend de operaciones auto-alojado en un único binario Go, que integra enlaces cortos con analítica, correo electrónico y automatización DNS como plugins. Habla MCP para ser controlado por agentes de IA (Claude Code, Cursor, Claude Desktop) sin necesidad de configuración inicial.
Ficha actualizada 29 sept 2026, 22:40 · upstream 29 sept 2026, 22:36 · release @octarq/plugin-sdk@0.16.0
Qué es octarq
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Octarq está diseñado para hackers independientes, empresas de una persona y equipos pequeños nativos de IA, funcionando como un 'back office' que reemplaza múltiples suscripciones SaaS. Incluye enlaces cortos con enrutamiento por geolocalización/dispositivo/OS/lenguaje, correo serverless vía Cloudflare Email Routing (sin puerto 25 ni daemons de spam), y automatización DNS para Cloudflare y DNSPod.
Todo el sistema se entrega en un solo binario sin CGO, con SQLite como base de datos por defecto y un dashboard embebido mediante go:embed. Los plugins (enlaces, correo, DNS) implementan una interfaz pública compartida y son inmediatamente accesibles para agentes de IA a través del protocolo MCP, sin tuberías adicionales.
La arquitectura sigue el modelo xcaddy: los plugins se componen en tiempo de compilación mediante variables de entorno OCTARQ_PLUGINS. Incluye autenticación, logs de auditoría, colas de trabajo, webhooks y copias de seguridad como funcionalidades core disponibles para cualquier plugin.
- Gestión centralizada de enlaces cortos con analítica de clics, detección de bots y enrutamiento geográfico
- Automatización de correo electrónico entrante/saliente sin servidor dedicado (Cloudflare Email Routing)
- Autogestión de registros DNS en Cloudflare o DNSPod con autenticación MX/SPF/DKIM
- Integración con agentes de IA para automatizar tareas operativas mediante MCP
- Despliegue self-hosted que elimina dependencia de múltiples servicios SaaS
- Extensibilidad mediante plugins escritos contra una interfaz pública Go + React
- Un único binario Go sin CGO, autocontenido con dashboard embebido
- Plugins intercambiables (enlaces, correo, DNS) como primera clase, no características bloqueadas
- Agent-native: todos los plugins expuestos como herramientas MCP para Claude Code/Cursor
- Modelo xcaddy: composición de plugins en tiempo de compilación sin editar código
- Base de datos SQLite por defecto con soporte opcional para PostgreSQL
- Licencia MIT y auto-alojamiento total (servidor, base de datos, dominio propio)
- Plugins escritos contra interfaz pública Go + React, sin importar internal/*
- Requiere configuración manual de variables de entorno para credenciales (OCTARQ_SECRET_KEY, OCTARQ_ADMIN_PASSWORD)
- Funcionalidades opcionales: correo, DNS y GeoIP deben configurarse después del arranque
- GeoIP requiere licencia MaxMind opcional (clave gratuita disponible)
- Base de datos SQLite por defecto; PostgreSQL requiere configuración adicional
- Dashboard embebido en binario principal (no separable sin recompilar)
- Dependencia de Cloudflare Email Routing para correo serverless (no SMTP nativo)
- MCP requiere configuración explícita en claude_desktop_config.json o similar
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue con Docker: docker run -p 8080:8080 -v octarq-data:/data ghcr.io/octarq-org/octarq:latest. Para desarrollo local sin variables de entorno, el sistema genera automáticamente clave secreta y contraseña admin en /data (visible en logs). Alternativa desde binario: make release y ejecutar con OCTARQ_SECRET_KEY=… OCTARQ_ADMIN_PASSWORD=… ./octarq. Backup completo del directorio /data (incluye base de datos y archivos secret). GeoIP: configurar OCTARQ_MAXMIND_LICENSE_KEY para descarga automática de GeoLite2.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.