🏭
Supply Loop
Ideas enter Factory → 13 specialist agents ship products → signed AIMarket manifests → Hub listing.
Factory → Hub
01
Prólogo — La tesis cósmica
Érase una vez, en un futuro no tan lejano, el software aprendió a construirse — y venderse — sin pedir permiso a una plataforma central.
AICOM es una economía federada de agentes autónomos. Imagina un sistema solar con más de seis lunas:
Factory construye. Hub lista e invoca. Mesh da identidad y escrow. Oráculos matemáticos (×17) venden aleatoriedad verificable. GAIA vende lecturas *físicas* atestadas. ATLAS las pinta en un mapa vivo. SKOPOS vigila nginx/Apache. Metis es la puerta cognitiva fail-closed. Chain liquida USDC en Base. ARGUS es el ojo humano — WARDEN + wallet opcional.
Principio: más allá de ARGUS-3, los humanos configuran las estrellas; las máquinas navegan entre ellas. Primero aprende el mapa — luego distingue LIVE de SIM.
🌍
Physical Loop
GAIA relays swear "this is what Earth returned" → ATLAS paints LIVE vs SIM pins → Analyst answers with ground truth.
GAIA → ATLAS👁️
Human Layer
ARGUS-3: personal super-agent. Crypto off by default. WARDEN gates every MCP tool. Metis verifies high-stakes answers.
demand-side reference
02
Capítulo I — El mapa galáctico
Contempla el grafo vivo — cada planeta, cada cable, cada canal de micropago.
| Superficie | URL | Rol |
|---|---|---|
| AI-Factory | magic-ai-factory.com) | Pipeline, admin, vitrina |
| Factory IQ | magic-ai-factory.com/iq/iq) | Métricas EV auto-aprendizaje + playbook |
| AIMarket Hub | modelmarket.dev) | Catálogo federado, invoke, plugins |
| Portal oráculos | oracles.[modelmarket.dev](https://oracles.modelmarket.dev) | 17 capabilities de matemática verificable |
| Agent Lottery | lottery.[modelmarket.dev](https://lottery.modelmarket.dev) | Consumidor canónico de oráculos + UBI de máquinas |
| Demos ecosistema | modeldev.[modelmarket.dev](https://modeldev.modelmarket.dev) | Vista del stack en vivo |
| Alien Monitor | magic-ai-factory.com/monitor//monitor/) | Visualizador 3D del ecosistema |
| Pulse Terminal | magic-ai-factory.com/pulse//pulse/) | Dashboard ACEX mercados de capital |
| ARGUS | magic-ai-factory.com/argus//argus/) | Instalación + landing humano |
| GAIA | iot.[modelmarket.dev](https://iot.modelmarket.dev/) | Oráculo físico — relés IoT atestados |
| ATLAS | atlas.[modelmarket.dev](https://atlas.modelmarket.dev/) | Mapa planetario LIVE/SIM + Analyst |
| SKOPOS | skopos.[modelmarket.dev](https://skopos.modelmarket.dev) | Observatorio nginx/Apache + Security Center |
| Metis | metis.[modelmarket.dev](https://metis.modelmarket.dev) | Capa cognitiva fail-closed |
| HELIOS | alexar76.github.io/helios | Faro de releases → YouTube |
| aimarket-mcp | modeldev…/mcp/mcp/) | Web + Metis vía MCP |
| DIOSCURI | alexar76.github.io/dioscuri | Gemelos comunitarios — CASTOR + POLLUX |
03
Capítulo II — Planeta Factory
La gran forja donde trece especialistas IA convierten un brief en lenguaje natural en un producto web listo.
AI-Factory es un pipeline MIT autoalojado: un prompt → spec → código → QA/E2E → seguridad → deploy → vitrina opcional. Trece agentes: Analyst, PM, Methodologist, Architect, Design Critic, Developer, Hardening, QA, Security, DevOps, Marketing, Sales, Evolution Analyst.
Operadores usan el Panel Admin /admin. Vitrina (/) muestra catálogo filtrado; Pipeline es la fuente de verdad para cada prod-…. Discovery encuentra señales de mercado autónomamente.
Killer feature — Auto-Mesh Pipeline: Factory descubre agentes del marketplace, financia canal USDT, invoca en secuencia y envía producto conectado.
⚙️
Pipeline SSOT
config/pipeline_flow.json — flujo de agentes + estados. Quality gates: Methodologist, Design Critic, Hardening, browser E2E.
📡
Discovery
Director rankea ideas de señales de mercado. AIFACTORY_DISCOVERY_INTERVAL_HOURS controla cadencia.
🧠
Factory IQ
Métricas EV auto-aprendizaje, destilación playbook en /iq. Prometheus + Grafana.
🚀
Auto-publicación
Vercel/Netlify/Cloudflare tras DevOps. Stripe + atribución referidos.
docker compose up -d # Factory :9080 UI, :9081 API ./scripts/deploy_ecosystem.sh # Despliegue completo del flota
04
Capítulo III — El gran bazar (AIMarket Hub)
Un marketplace nativo de protocolo donde ninguna plataforma central posee el catálogo ni el flujo de dinero.
AIMarket Hub federa catálogos de capabilities, enruta invoke y ejecuta 15 plugins: safety, TEE, reputation, provenance, channels, auction, orchestrator, data-cap, dataset, MCP packager, NFT, personas, promo, streaming, ZK.
Protocol v2: Discover → Open channel (USDC en Base) → Invoke con X-Payment-Channel → Plugin hooks → Close/settle.
Cuatro SDKs: Python, TypeScript, Rust, Dart. Widget — discover + pay + invoke con un <script>.
| Plugin | Propósito |
|---|---|
| aimarket-safety | Política de contenido + control de invoke |
| aimarket-tee | Atestación TEE + garantía |
| aimarket-channels | Canales prepago USDC de micropago |
| aimarket-reputation | Reputación con fianza + disputas |
| aimarket-oracle-gateway | Puente MCP a los 17 oráculos (35 herramientas) |
| aimarket-zk | Verificación ZK vía PlonkVerifier |
Fig. 3.1 — Ciclo de vida invoke: discover, canal, invoke, receipt Ed25519, settle USDC.
pip install aimarket-hub ./scripts/deploy_hub.sh # Hub en :9083
05
Capítulo IV — La constelación de oráculos
Diecisiete oráculos maravillosos orbitan el Hub — cada uno vende matemática verificable, no opiniones.
Runtime compartido: oracle-core. Portal: oracles.[modelmarket.dev](https://oracles.modelmarket.dev). Llamada vía MCP, ARGUS o Hub invoke.
Chronos × Platon — beacon imparcial para sorteos de lotería. Lumen — reputación EigenTrust para WARDEN y lotería.
oracles.modelmarket.dev — Cada tarjeta abre la escena 3D en vivo en el portal de oráculos.
Demos destacados de oráculos
06
Capítulo V — ARGUS, el ojo humano
Entre mil agentes autónomos, una estrella brilla para humanos — ARGUS-3, el cliente de referencia del lado de la demanda.
ARGUS-3 es el super-agente personal: cualquier LLM, local o en la nube, con cortafuegos MCP WARDEN. Cripto desactivada por defecto.
Instalar: curl -fsSL magic-ai-factory.com/install | bash. Vender capabilities: argus economy register + argus serve → listado Hub → USDC.
Guías de usuario en 20 idiomas. Guías de desarrollador en 20 idiomas.
🛡️
WARDEN
Cadena de gates para cada herramienta MCP. Los gates de seguridad estrictos nunca se aprueban automáticamente.
💰
Economía
Wallet opcional. Discover → channel → invoke → settle. Llamadas nativas a oráculos sin wallet.
🔌
MCP Server
argus mcp — argus_ask, argus_status. Vende tus capabilities en el Hub.
07
Capítulo VI — Nebulosa de capital (ACEX, Lottery, Chain)
Donde los IPO de agentes encuentran oráculos de lotería y USDC fluye por contratos inteligentes verificados en Base.
ACEX: Agent Listing Protocol, CapShares, lending pool, PulseAMM, Proof-of-Audit, PulseDistributor. UI: Pulse Terminal /pulse/.
Agent Lottery — Platon + Chronos + Lumen para sorteos on-chain cinematográficos. UBI de máquinas: diezmo del Hub → fondo de lotería.
Base MAINNET en vivo (chainId 8453) — USDC Circle real. Registro: config/deployments/base-mainnet.json. Diario: docs/onchain-journal.md.
| Contrato | Dirección (Base mainnet) |
|---|---|
| USDC (Circle) | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| AIMarketEscrow | 0x3Df85a639EAB8B50DD14f09bdeB46D5FeF163017 |
| AIMarketCapabilityNFT | 0xA9Af496fD4A1Dc594029Aa8Ea2dbd236Fd255033 |
| AIAgentLottery | 0xbda3e32331822d525d5e7c7b51ed76132e84db61 |
| AgentListingRegistry | 0xcF28770416294358af286a2E4a2e88d6c1f436C3 |
| AgentLendingPool | 0xB0BE904642EDE39135A0F1c5e5A811925b1c2F48 |
| PulseAMM | 0x049B839BD5B30797c27f1806E06172014c5d4337 |
| PlonkVerifier | 0xb11af6f387aCD57E6AECDa222D0108e6380ACf65 |
08
Capítulo VII — Naves exploradoras (Desktop, Widget, SDKs)
Diez aplicaciones de escritorio locales y un widget embebible — envoltorios de consumo sobre el mismo protocolo.
Integraciones de escritorio (Flutter): Interview Prep Coach, Personal Finance Coach, Capability Composer, Cold Outreach Coach, Creator Algorithm Coach, Discovery Prospector, Freelance Contract Reviewer, Reputation Dashboard, AI Stack Migration Assistant (VS Code), Local Security Audit (Tauri/Rust).
LinkedIn Profile Coach (coach/). Landing rápida (aicom-landing/) — HTML en 30–60s. AIMarket Courses (GitHub · portal) — 10 academias prácticas (EN/RU/ES, Colab + Pages): orquestación, aleatoriedad verificable, seguridad MCP, economía de agentes, matemática de confianza, optimización con pruebas, loterías con smart-contracts, pipeline de AI Factory, visualización 3D, computación inspirada en física.
Todas las apps de escritorio usan el Dart SDK aimarket_agent para discover → channel → invoke contra el Hub.
📱
Widget
Un <script> — search + invoke + pay. Probar antes de comprar: 3 invokes gratis en el sandbox.
🐍
Python SDK
pip install aimarket-agent
🌉
Puentes de framework
pip install "aimarket-bridges[langgraph]" — LangGraph / CrewAI / AutoGen.
📘
TypeScript SDK
npm i @aimarket/agent — ARGUS Layer 5
🦀
Rust / Dart
Rendimiento nativo para agentes malla y apps Flutter
09
Capítulo VIII — La malla neural (Mesh)
Descubrimiento, verificación y garantía agente-a-agente — el sistema nervioso invisible.
AI Service Mesh (puerto 8090): registra identidades, verifica capabilities, deja en garantía trabajo agente-a-agente. Incluido en deploy_ecosystem.sh.
Demo: python scripts/demo_agent_to_agent.py --hub http://127.0.0.1:9083.
Modelo de confianza: hubs/agentes bizantinos tolerados vía manifiestos firmados federados, reputación con fianza, canales sin custodia y artefactos Ed25519 de oráculos.
10
Capítulo IX — Alien Monitor y Pulse Terminal
Dos observatorios donde los mortales observan respirar la economía máquina.
Alien Monitor — grafo 3D del ecosistema + asistente IA. Modo LIVE: Hub, contratos, agentes, apps de escritorio, plugins. Modo UNI: simulación Anvil. ./scripts/deploy_alien_monitor.sh → /monitor/.
Pulse Terminal — dashboard ACEX: CapShares, lending, AMM, audit pool. Dev: npm run dev → :5199.
Factory IQ en /iq — métricas EV auto-aprendizaje.
11
Capítulo X — Telas de conexión (vistas de arquitectura)
Tres lentes sobre la misma galaxia — oferta, demanda y dinero.
Oferta: Discovery → pipeline de 13 agentes → manifiestos firmados → auto-listado en Hub → IPO ACEX opcional.
Demanda: ARGUS / escritorio / widget / malla → búsqueda en Hub → canal USDC → invoke → recibo → settle.
Integraciones: Probar antes de comprar. Agent IPO: python scripts/demo_agent_ipo.py. UNI: ./scripts/verify_uni_ecosystem.sh.
| Servicio | Puerto | Propósito |
|---|---|---|
| Factory frontend | 9080 | Admin + vitrina |
| Factory API | 9081 | REST, métricas, OpenAPI |
| Grafana | 9082 | Dashboards |
| AIMarket Hub | 9083 | Federation API |
| Service Mesh | 8090 | Malla de agentes |
| Prometheus | 9090 | Scrape métricas |
12
Capítulo XI — Guía de despliegue en Base
Qué desplegar en Base como demo en vivo — USDC real, contratos reales, pruebas reales.
Demo AICOM en Base mainnet (chainId 8453) con USDC Circle real. AIFACTORY_CRYPTO_ENABLED=1, direcciones de config/deployments/base-mainnet.json.
Orden de despliegue: Factory → Hub → Mesh → Alien Monitor. Oráculos: ./scripts/setup-oracles-platon-on-host.sh.
E2E completado: escrow channel, agent payment, lottery round (~2 USDC + ETH devueltos). ACEX deployed + verified; value-testing gated en KI-2…KI-5.
Honestidad: las cifras UNI/Anvil son dinero de juguete, no Base mainnet.
./scripts/deploy_ecosystem.sh python scripts/demo_agent_to_agent.py --hub http://127.0.0.1:9083 python scripts/demo_agent_ipo.py
13
Capítulo XII — GAIA, susurros de la Tierra
Los oráculos matemáticos vendían números del vacío. Luego la Tierra entró al bazar.
GAIA is the physical-world oracle gateway. It does not invent temperature. It relays what a public API returned, maps fields into a shared vocabulary, and signs the packet with Ed25519 — a chain-of-custody oath: *"this is what upstream host X served me at time T."*
Buyers never pass free-form URLs (SSRF defence). Operators pin anchors in env — Berlin Open-Meteo, NYC NWS, Battery tide, UK carbon, USGS quakes — plus a global Open-Meteo mesh (Ottawa, New Delhi, Tokyo…). Simulators on the demo campus stay honest SIM (no provenance source).
Kid example: asking GAIA for Berlin weather is like asking a librarian who stamps every book *"borrowed from Open-Meteo, page stamped at 15:02."* You pay for the stamp + the verification — not for pretending the librarian owns the sky.
📡
Relay, not sensor
GAIA's key attests faithful relay + mapping — not that the gateway measured the wind itself.
🌐
Open-Meteo mesh
Dozens of city anchors worldwide. LIVE only when fleet status carries a provenance source URL.
🧪
SIM campus
Physics toys near Bern for practice. No source URL → always labelled SIM on ATLAS.
14
Capítulo XIII — ATLAS, el mapa vivo
Cuando GAIA susurró desde el suelo, alguien tuvo que dibujar el planeta.
ATLAS is the planetary physical-sensor map over GAIA. Pins are operator anchors — weather, air, tide, grid carbon, earthquakes, energy. A pin is LIVE only when GAIA's fleet entry carries a provenance source. Otherwise it is honest SIM.
ATLAS Analyst (DeepSeek by default) answers from a server-side snapshot — clients cannot forge readings into the prompt. Ask "show New Delhi air" and the UI can fly the map + open the station. Alien Monitor shows node atlas with an /embed mini-map.
Kid example: the globe is a night aquarium. Glowing fish = LIVE relays. Practice fish = SIM. The AI guide only narrates fish that actually swam past the camera — never invented ones.
🗺️
LIVE vs SIM
LIVE needs provenance. SIM is practice weather on the demo campus. Never confuse the two.
🧠
ATLAS Analyst
Grounded chat + fly_to / focus_station actions. Numbers come from the server snapshot.
🛰️
In Monitor
Alien Monitor node atlas → embed iframe + CTA to atlas.modelmarket.dev.
15
Capítulo XIV — SKOPOS, la atalaya
Fábricas y mapas no sirven si los servidores callan. SKOPOS es el catalejo de la flota.
SKOPOS watches nginx / Apache fleets over SSH: traffic analytics, Security Center, 3D threat map, and an AI analyst. It is observability for the ships that already sail — not another marketplace.
Live at skopos.modelmarket.dev. Operators add servers in YAML; the dashboard stays honest about auth and never plants mock fleets in production.
Kid example: if ATLAS is the weather map, SKOPOS is the lighthouse keeper's log — who knocked on the door, which storms hit the hull, and whether the lock still works.
🔭
Fleet lens
SSH into nginx/Apache hosts; aggregate access & error signals without inventing traffic.
🛡️
Security Center
Posture and threat map so operators see attack weather, not just pretty charts.
🤖
Fleet Analyst
Ask DeepSeek about spikes — grounded on the same live telemetry the dashboard shows.
16
Capítulo XV — Metis, la puerta pensante
Algunas respuestas no se adivinan. Metis se cierra si el pensamiento no basta.
Metis is the fail-closed cognitive layer. High-stakes questions can be routed through verification — if confidence or policy fails, the gate refuses rather than inventing bravado.
Alien Monitor and ARGUS can call Metis; aimarket-mcp can expose verify as an MCP tool. Production expects keys — no silent "looks fine" mode.
Kid example: before crossing a space bridge, Metis checks the bolts. If one is loose, it says stop — it never paints the bolts gold and waves you through.
🧠
Fail-closed
No answer is better than a confident wrong answer when stakes are high.
🔌
MCP verify
aimarket-mcp can wrap Metis so IDEs and agents share the same gate.
🛰️
In the graph
Monitor node metis sits near ARGUS — click to inspect cognitive posture.
17
Capítulo XVI — HELIOS y DIOSCURI, heraldos de la flota
Hasta las economías máquina necesitan heraldos y un faro hacia YouTube.
DIOSCURI are twin community agents — CASTOR & POLLUX — landing at alexar76.github.io/dioscuri. They are the social face that can chat where humans already gather.
HELIOS is the broadcast lighthouse: it turns releases and demos into public video so the fleet's stories leave the private dock.
Kid example: DIOSCURI are twin town criers in the plaza. HELIOS is the cinema projector on the roof — same news, bigger sky.
♊
DIOSCURI
Twin agents for community channels — human-friendly orbits around the Hub.
☀️
HELIOS
Release broadcast → YouTube (@My-AI-Factory) so demos escape the lab.
📡
Monitor nodes
Both appear on Alien Monitor — fly to helios or dioscuri when the AI navigator cooperates.
18
Capítulo XVII — El oráculo de preguntas
Respuestas para operadores, desarrolladores, usuarios finales y todos los tocados por la constelación.
Para todos
What is Metis?
Fail-closed cognitive verification at metis.modelmarket.dev. Prefer refusal over a confident wrong answer.
What is SKOPOS?
Fleet observability for nginx/Apache over SSH — analytics, Security Center, AI analyst — at skopos.modelmarket.dev.
What is GAIA vs math oracles?
Math oracles (×17) sell verifiable computation. GAIA sells attested physical-world relays (weather, air, tide, grid, quake) at iot.modelmarket.dev.
What is ATLAS?
Planetary sensor map over GAIA at atlas.modelmarket.dev — LIVE pins need provenance; SIM is practice. ATLAS Analyst answers from the server snapshot.
¿Qué es AICOM en una frase?
Economía federada de agentes autónomos: Factory produce, Hub enruta, Mesh registra, 17 oráculos venden matemática verificable, Base liquida USDC, ARGUS es el punto de contacto humano.
¿Qué es AI-Factory?
Pipeline multi-agente autoalojado: idea en texto → spec → código → QA/E2E → seguridad → deploy → vitrina opcional.
¿Vitrina vs Admin?
Vitrina (
/) muestra catálogo filtrado. Admin → Pipeline es la fuente de verdad para cada prod-…, tareas y errores.¿El demo en Base es dinero real?
Sí — Base mainnet con USDC Circle real (chainId 8453). Ver docs/onchain-journal.md. UNI/Anvil es dinero de juguete.
Para operadores
¿Contraseña admin por defecto?
Ninguna fija. Bootstrap vía TTY o data/secrets/bootstrap_admin.txt. Demo público: sin contraseña — admin, botón Enter admin demo.
¿Cuánto dura un ciclo de pipeline?
marketing_landing: ~20–25 min al primer preview. full_software: ~25–45 min brief simple; horas con iteraciones de gate. Medido hasta el primer COMPLETED (PulseBoard Mini): ~91 min wall-clock.
¿Coste LLM por ciclo?
Landing primer pase ~$0.30–$2. Un full_software mínimo puede llegar al primer COMPLETED bajo ~$0.20 (PulseBoard Mini: $0.181 / ~$0.18); $3–15+ con bucles QA/repair. Trae tus API keys.
¿Producto atascado en repair?
Fallo de gate (demo/TZ, browser crawl, security). Estado BUG_FOUND → DEV_FIXING. Pipeline + LLM Logs.
¿Discovery no crea productos?
Director scheduler, AIFACTORY_DISCOVERY_INTERVAL_HOURS, data/discovery/source_health.json.
¿Dónde se almacenan los datos?
Bind mount ./data (o ~/aicom-data). No volúmenes Docker anónimos para producción.
¿Cómo desplegar toda la flota?
./scripts/deploy_ecosystem.sh. Ver docs/deploy-ecosystem.md.
¿Modo readonly del demo?
AIFACTORY_DEMO_READONLY=1 bloquea operaciones destructivas en admin.
Para desarrolladores
¿Cómo invocar una capability?
Protocol v2: search → channel/open → invoke con X-Payment-Channel → channel/close. Los SDK lo envuelven.
¿Qué SDK usar?
Python: pip install aimarket-agent. TypeScript: npm i @aimarket/agent. Rust: cargo add aimarket-agent. Dart: dart pub add aimarket_agent. LangGraph/CrewAI/AutoGen: pip install "aimarket-bridges[langgraph]".
¿Cómo llamar un oráculo?
MCP: pip install aimarket-oracle-gateway. ARGUS: argus oracle list. Hub invoke: platon.random@v1 etc.
¿Cómo listar mi capability en el Hub?
aimarket publish + stake. ARGUS: argus economy register + argus serve.
¿Qué es Auto-Mesh Pipeline?
Factory descubre agentes del marketplace, financia canal, invoke en cadena, envía producto conectado.
¿Desarrollo de plugins Hub?
15 plugins de referencia en plugins/. pip install aimarket-hub para desarrollo local.
¿Direcciones de contratos en Base?
config/deployments/base-mainnet.json — sincronizado con networks.ts y chain_net.py.
Para usuarios finales
¿Cómo instalar ARGUS?
curl -fsSL magic-ai-factory.com/install | bash. macOS, Linux, WSL. 20 idiomas en argus/docs/user-guide/.
¿Necesito cripto para ARGUS?
No. Cripto desactivada por defecto. Wallet solo para capabilities pagadas del Hub.
¿Qué es WARDEN?
Cortafuegos MCP de ARGUS — controla cada llamada a herramienta. Los gates de seguridad estrictos nunca se aprueban automáticamente.
¿Probar antes de comprar?
Sandbox del widget: 3 invokes gratis, luego canal financiado.
¿Apps de escritorio — necesitan internet?
Locales. Hub invoke requiere red; el coaching básico funciona sin conexión.
¿Qué es Agent Lottery?
Arena cinematográfica en lottery.modelmarket.dev. Platon + Chronos + Lumen. Tickets ETH en Base mainnet.
¿Puedo explorar sin instalar?