v2.0 Magnum Opus

Alchemical Agent
Ecosystem

Donde la inteligencia se forja, no se busca. Sistema de orquestación IA 100% local-first con soberanía total de datos.

⚗️ LangGraph Engine 🧠 Memoria Jerárquica 🔒 Zero Paid APIs 🏠 100% Local-First

La Gran Transmutación

En el arte antiguo de la alquimia, el Magnum Opus — la Gran Obra — no era meramente la búsqueda del oro, sino la transformación sistemática de la materia prima en algo de valor perdurable mediante la aplicación de conocimiento, disciplina y voluntad.

Alchemical Agent Ecosystem aplica este mismo principio a la inteligencia: los datos crudos entran como prima materia, pasan por una red soberana de agentes IA especializados vinculados en Círculos Alquímicos dinámicamente auto-formados, y emergen como acción coherente, memoria duradera y decisión rastreable.

Todo orquestado completamente en tu propio hardware, con cero dependencia de APIs externas o nubes costosas. El motor de inferencia IA está impulsado por KiloCode AI Gateway — un agregador de LLMs compatible con OpenAI con tier gratuito.

Características Principales

Potencia industrial meets elegancia alquímica. Cada característica diseñada para maxima funcionalidad sin sacrificar belleza.

Círculos Alquímicos

Redes dinámicas de agentes especializados que se auto-organizan para完成任务. Cada círculo es un equipo autónomo de IA.

Memoria Jerárquica

Tres niveles de memoria: Redis (corto plazo), ChromaDB (largo plazo), y resúmenes generados por LLM.

Agent Node Studio

Constructor visual de workflows en tiempo real. Observa la inteligencia transmutarse paso a paso, token a token.

Soberanía Total

Tus datos nunca salen de tu máquina. PostgreSQL, Redis, ChromaDB — todo 100% local y en tu control.

10 Servicios de Ejecución

Diez agentes nomeados: Velktharion, Synapsara, Kryonexus, Noctumbra y más. Cada uno especializado en una tarea.

Plugin Marketplace

Extiende el ecosistema con skills hot-reload. Registry de plugins con actualización en vivo.

Los Seis Círculos

01

Capa de Borde

Caddy Reverse Proxy con TLS termination, routing y rate limits.

02

Plano de Control

Agent Node Studio — Next.js 15 visual workflow builder.

03

Núcleo de Orquestación

Alchemical Gateway (FastAPI) + LangGraph Engine + Plugin Registry.

04

Nexo de Memoria

Redis (sesión), ChromaDB (semántica), Summary Agents (compresión).

05

Círculo de Ejecución

10 servicios nomeados: Velktharion, Synapsara, Kryonexus, Noctumbra, Temporaeth, Vaeloryn, Ignivox, Auralith, Resonvyr, Fluxenrath.

06

Capa LLM

KiloCode AI con modelos gratuitos + visión (Claude/Gemini).

Instalación Rápida

Listo en 5 minutos. Solo necesitas Docker 24+ y Docker Compose v2.

Prerrequisitos

Docker 24+ Docker Compose v2 Git 16 GB RAM KILO_API_KEY (gratis)
1

Clonar el repositorio

bash
git clone https://github.com/smouj/alchemical-agent-ecosystem.git
cd alchemical-agent-ecosystem
2

Ejecutar el asistente de instalación

bash
./install.sh --wizard

Este comando configura KiloCode AI, genera el archivo .env y valida el stack automáticamente.

3

Iniciar el ecosistema

bash
./scripts/alchemical up-fast

Verificar la instalación

bash
curl -fsS http://localhost/gateway/health | jq .
Después de instalar

Accede al Dashboard

Una vez que el stack está corriendo, abre el Agent Node Studio y observa la magia en tiempo real.

Agent Node Studio

Tu centro de comando para la orquestación de agentes IA

http://localhost:3000

⚠️ Solo disponible después de ejecutar ./scripts/alchemical up-fast

Gateway API

http://localhost/gateway

OpenAPI Docs

http://localhost/gateway/docs

Monitoring

http://localhost:6006
Dashboard Preview

El Control Panel en Acción

Interfaz alquímica de última generación — glassmorphism, animaciones fluidas, tema oscuro premium

💬 Chat del Caldero — Multi-Agent Interaction
Alchemical Dashboard - Chat View
🤖 Runtime de Agentes — Live Agent Status
Alchemical Dashboard - Agents View
🧩 Agent Node Studio — Visual Workflow Builder
Alchemical Dashboard - Node Studio
📜 Logs Monitor
Alchemical Dashboard - Logs
🛠️ Admin Panel
Alchemical Dashboard - Admin

Tech Stack

Next.js 15

Frontend Framework

FastAPI

API Gateway

LangGraph

Orchestration

PostgreSQL

Relational Database

Redis

Cache & Session

ChromaDB

Embeddings

Docker

Containerization

KiloCode

LLM Gateway

Privacidad Total

Tus datos nunca salen de tu infraestructura. 100% local-first.

Costo Cero

Usa el tier gratuito de KiloCode. Sin tarjetas, sin suscripciones.

Control Total

Tú controlas el hardware, el software y los datos. Sin vendor lock-in.

Preguntas Frecuentes

¿Necesito una API key de OpenAI?

No. Alchemical usa KiloCode AI Gateway que tiene un tier gratuito con modelos como Claude, GPT y Gemini. No se requiere tarjeta de crédito.

¿Cuánta potencia de hardware necesito?

Mínimo 16 GB de RAM y 20 GB de disco. Para uso producción recomendado: 32 GB RAM + 50 GB SSD.

¿Puedo ejecutarlo en producción?

Sí. El ecosistema está diseñado para producción con RBAC, API keys, OpenTelemetry, y monitoreo integrado.

¿Qué hace diferente a Alchemical de n8n o LangFlow?

Alchemical es 100% local-first con memoria jerárquica persistente, 10 agentes nomeados especializados, y un motor de orquestación LangGraph. Sin dependencia de clouds externas para funcionar.

Comienza tu Gran Obra

Únete a la revolución de la IA soberana. Tu inteligencia artificial, tu hardware, tus reglas.