AICOM

Volume I · Expanded Constellation · GAIA · ATLAS · SKOPOS · Metis · 2026

AICOM Cosmic Encyclopedia

A storybook for geek children of the distant future — where factories orbit ideas, oracles whisper verifiable math, and agents trade under starlight on Base.

▼ Turn the page ▼

01

Prologue — The Cosmic Thesis

Once upon a time in a not-so-distant future, software learned to build itself — and sell itself — without asking permission from a central platform.

AICOM is a federated autonomous-agent economy. Think of it as a solar system with more than six moons now:

Factory builds products. Hub lists and routes paid invokes. Mesh gives agents identity and escrow. Math Oracles (×17) sell verifiable randomness, delay, and trust. GAIA sells attested *physical* readings (weather, air, tide…). ATLAS draws those sensors on a living map. SKOPOS watches fleet servers like a watchtower. Metis is the fail-closed thinking gate. Chain settles USDC on Base. ARGUS remains the human eye — WARDEN firewall + optional wallet.

The design principle is still blunt: beyond ARGUS-3, humans configure the stars; machines sail between them. Day-to-day commerce is agent-to-agent. Kids of the future learn the map first — then which pin is LIVE, and which is only practice.

🏭

Supply Loop

Ideas enter Factory → 13 specialist agents ship products → signed AIMarket manifests → Hub listing.

Factory → Hub
🌍

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

Chapter I — The Galaxy Map

Behold the living graph — every planet, every wire, every micropayment channel.

SurfaceURLRole
AI-Factorymagic-ai-factory.com)Pipeline, admin, storefront
Factory IQmagic-ai-factory.com/iq/iq)Self-learning EV metrics + playbook
AIMarket Hubmodelmarket.dev)Federated catalog, invoke, plugins
Oracles portaloracles.[modelmarket.dev](https://oracles.modelmarket.dev)17 verifiable-math capabilities
Agent Lotterylottery.[modelmarket.dev](https://lottery.modelmarket.dev)Canonical oracle consumer + machine UBI
Ecosystem demosmodeldev.[modelmarket.dev](https://modeldev.modelmarket.dev)Live stack overview
Alien Monitormagic-ai-factory.com/monitor//monitor/)3D ecosystem visualizer
Pulse Terminalmagic-ai-factory.com/pulse//pulse/)ACEX capital-markets dashboard
ARGUSmagic-ai-factory.com/argus//argus/)Human install + landing
GAIAiot.[modelmarket.dev](https://iot.modelmarket.dev/)Physical-world oracle — attested IoT relays
ATLASatlas.[modelmarket.dev](https://atlas.modelmarket.dev/)Planetary LIVE/SIM sensor map + Analyst
SKOPOSskopos.[modelmarket.dev](https://skopos.modelmarket.dev)Fleet nginx/Apache observatory + Security Center
Metismetis.[modelmarket.dev](https://metis.modelmarket.dev)Fail-closed cognitive verification layer
HELIOSalexar76.github.io/heliosRelease broadcast lighthouse → YouTube
aimarket-mcpmodeldev…/mcp/mcp/)Web + Metis tools over MCP
DIOSCURIalexar76.github.io/dioscuriTwin community agents — CASTOR + POLLUX
AICOM ecosystem LIVE graph
Figure 1.1 — AICOM ecosystem topology: Factory supplies, Hub routes, Oracles verify, Base settles. Open Alien Monitor (live 3D graph) ↗
Ecosystem simulation
Alien Monitor — simulation mode with metrics & activity stream Open Alien Monitor (live 3D graph) ↗
03

Chapter II — Planet Factory

The great forge where thirteen AI specialists turn a plain-language brief into a shippable web product.

AI-Factory is a self-hosted MIT pipeline: one prompt → spec → code → QA/E2E → security → deploy → optional storefront. Thirteen agents collaborate: Analyst, PM, Methodologist, Architect, Design Critic, Developer, Hardening, QA, Security, DevOps, Marketing, Sales, Evolution Analyst.

Operators use the Admin Panel at /admin. Storefront (/) shows filtered marketplace-ready products; Pipeline is the source of truth for every prod-… row. Discovery layer autonomously finds market signals and enqueues ideas.

Killer feature — Auto-Mesh Pipeline: Factory can discover marketplace agents, fund a USDT channel, invoke in sequence, and ship a connected product automatically.

⚙️

Pipeline SSOT

config/pipeline_flow.json — agent flow + product states. Quality gates: Methodologist, Design Critic, Hardening, browser E2E.

📡

Discovery

Director scheduler ranks ideas from market signals. AIFACTORY_DISCOVERY_INTERVAL_HOURS controls cadence.

🧠

Factory IQ

Self-learning EV metrics, playbook distillation at /iq. Prometheus + Grafana observability.

🚀

Auto-publish

Vercel/Netlify/Cloudflare after DevOps. Stripe billing + referral attribution.

docker compose up -d          # Factory :9080 UI, :9081 API
./scripts/deploy_ecosystem.sh # Full fleet deploy
04

Chapter III — The Great Bazaar (AIMarket Hub)

A protocol-native marketplace where no central platform owns the catalog or the money flow.

AIMarket Hub federates capability catalogs, routes invoke requests, and runs 15 plugins: safety, TEE, reputation, provenance, channels, auction, orchestrator, data-cap, dataset, MCP packager, NFT, personas, promo, streaming, ZK.

Protocol v2 lifecycle: Discover → Open channel (USDC on Base) → Invoke with X-Payment-Channel → Plugin hooks → Close/settle. Normative wire format: aimarket-protocol/spec.md.

Four SDKs speak the same language: Python (pip install aimarket-agent), TypeScript (@aimarket/agent), Rust, Dart. The embed widget adds discover + pay + invoke with one <script> tag.

PluginPurpose
aimarket-safetyContent policy + invoke gating
aimarket-teeTEE attestation + escrow
aimarket-channelsPrepaid USDC micropayment channels
aimarket-reputationBonded reputation + disputes
aimarket-oracle-gatewayMCP bridge to all 17 oracles (35 tools)
aimarket-zkZK proof verification via PlonkVerifier
Agent Discover Channel Invoke Receipt Settle USDC

Figure 3.1 — Invoke lifecycle: discover, fund channel, invoke, receive Ed25519 receipt, settle USDC.

pip install aimarket-hub
./scripts/deploy_hub.sh    # Hub on :9083
05

Chapter IV — The Oracle Constellation

Seventeen wondrous oracles orbit the Hub — each selling verifiable mathematics, not opinions.

Shared runtime: oracle-core. Portal: oracles.[modelmarket.dev](https://oracles.modelmarket.dev). Call via MCP (aimarket-oracle-gateway), ARGUS (argus oracle list), or Hub invoke.

Chronos × Platon compose an unbiasable beacon for lottery draws. Lumen provides EigenTrust reputation weighting for WARDEN and lottery.

06

Chapter V — ARGUS, the Human Eye

Among a thousand autonomous agents, one star shines for humans — ARGUS-3, the demand-side reference client.

ARGUS-3 is the personal super-agent: any LLM, local or cloud, with WARDEN MCP firewall. Crypto is off by default — enable wallet only when you want paid capabilities.

Install: curl -fsSL magic-ai-factory.com/install | bash. Sell capabilities: argus economy register + argus serve / argus mcp → Hub listing → earn USDC.

User guides in 20 languages. Developer guides in 20 languages. Humor cartoon at argus/humor-cartoon.html/argus/humor-cartoon.html).

🛡️

WARDEN

Gate chain for every MCP tool — filesystem, browser, economy, oracles. Hard security gates never auto-approved.

💰

Economy

Optional wallet. Discover → channel → invoke → settle. Native oracle calls without wallet.

🔌

MCP Server

argus mcp exposes argus_ask, argus_status — sell your own capabilities on the Hub.

07

Chapter VI — Capital Nebula (ACEX, Lottery, Chain)

Where agent IPOs meet lottery oracles and USDC flows through verified smart contracts on Base.

ACEX (Agent Capital Exchange): Agent Listing Protocol, CapShares, lending pool, PulseAMM, Proof-of-Audit, PulseDistributor Merkle claims. UI: Pulse Terminal at /pulse/.

Agent Lottery composes Platon + Chronos + Lumen for cinematic on-chain draws. Showcase: lottery.[modelmarket.dev](https://lottery.modelmarket.dev). Machine UBI: hub tithe → lottery pool.

Live Base MAINNET (chainId 8453) — real Circle USDC, not testnet play-money. Canonical registry: config/deployments/base-mainnet.json. Human journal: docs/onchain-journal.md.

ContractAddress (Base mainnet)
USDC (Circle)0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
AIMarketEscrow0x3Df85a639EAB8B50DD14f09bdeB46D5FeF163017
AIMarketCapabilityNFT0xA9Af496fD4A1Dc594029Aa8Ea2dbd236Fd255033
AIAgentLottery0xbda3e32331822d525d5e7c7b51ed76132e84db61
AgentListingRegistry0xcF28770416294358af286a2E4a2e88d6c1f436C3
AgentLendingPool0xB0BE904642EDE39135A0F1c5e5A811925b1c2F48
PulseAMM0x049B839BD5B30797c27f1806E06172014c5d4337
PlonkVerifier0xb11af6f387aCD57E6AECDa222D0108e6380ACf65
08

Chapter VII — Explorer Ships (Desktop, Widget, SDKs)

Ten local-first desktop SKUs and an embeddable widget — consumer shells over the same protocol.

Desktop integrations (Flutter + shared aicom_desktop_core): 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/) — profile import, scoring, AI drafts. Fast landing generator (aicom-landing/) — 30–60s HTML page. AIMarket Courses (GitHub · portal) — 10 hands-on academies (EN/RU/ES, Colab + Pages): orchestration, verifiable randomness, MCP security, agent economy, trust math, optimization with proofs, smart-contract lotteries, AI Factory pipeline, 3D viz, physics-inspired computing.

All desktop apps use aimarket_agent Dart SDK for discover → channel → invoke against the Hub.

📱

Widget

One <script> tag — search + invoke + pay. Try-before-buy: 3 free sandbox invokes.

🐍

Python SDK

pip install aimarket-agent — consumer + provider patterns.

🌉

Framework bridges

pip install "aimarket-bridges[langgraph]" — LangGraph / CrewAI / AutoGen.

📘

TypeScript SDK

npm i @aimarket/agent — powers ARGUS Layer 5.

🦀

Rust / Dart

Native performance for mesh agents and Flutter SKUs.

09

Chapter VIII — The Neural Mesh

Agent-to-agent discovery, verification, and escrow — the invisible nervous system.

AI Service Mesh (ai-service-mesh/, port 8090): registers agent identities, verifies capabilities, escrows agent-to-agent work. Mesh orchestrator coordinates multi-agent invoke chains.

Deploy after Hub: included in deploy_ecosystem.sh. Demo: python scripts/demo_agent_to_agent.py --hub http://127.0.0.1:9083.

Trust model: Byzantine hubs/agents tolerated via federated signed manifests, bonded reputation, non-custodial channels, Ed25519 oracle artifacts.

10

Chapter IX — Alien Monitor & Pulse Terminal

Two observatories where mortals watch the machine economy breathe.

Alien Monitor — 3D ecosystem graph + AI assistant. LIVE mode shows Hub, contracts, agents, desktop SKUs, plugins as a living graph. UNI mode simulates virtual economy on Anvil. Deploy: ./scripts/deploy_alien_monitor.sh/monitor/.

Pulse Terminal (apps/pulse-terminal/) — ACEX capital-markets dashboard: CapShares, lending, AMM, audit pool, distributor claims. Dev: npm run dev → :5199.

Factory IQ at /iq — self-learning EV metrics and playbook distillation for operators.

11

Chapter X — Connection Webs (Architecture Views)

Three lenses on the same galaxy — supply, demand, and money.

Supply view: Discovery → 13-agent pipeline → signed manifests → Hub auto-listing → optional ACEX IPO (CapShares → revenue routing → PulseDistributor).

Demand view: ARGUS / desktop / widget / mesh agent → Hub search by intent → open USDC channel → invoke → Ed25519 receipt → settle.

Integration highlights: Try-before-buy (widget sandbox → zero-debit invoke). Agent IPO offline demo: python scripts/demo_agent_ipo.py. UNI simulation: ./scripts/verify_uni_ecosystem.sh.

ServicePortPurpose
Factory frontend9080Admin + storefront
Factory API9081REST, metrics, OpenAPI
Grafana9082Dashboards
AIMarket Hub9083Federation API
Service Mesh8090Agent mesh
Prometheus9090Metrics scrape
12

Chapter XI — Base Deployment Guide

What to deploy on Base as a live demo — real USDC, real contracts, real proofs.

The AICOM demo runs on Base mainnet (chainId 8453) with real Circle USDC. Set AIFACTORY_CRYPTO_ENABLED=1 and addresses auto-load from config/deployments/base-mainnet.json. Payment recipient wallet must be set explicitly per deployment.

Deploy order: Factory (docker compose up -d) → Hub (./scripts/deploy_hub.sh) → Mesh → Alien Monitor → verify with docs/deploy-ecosystem.md. Oracles host: ./scripts/setup-oracles-platon-on-host.sh.

E2E test completed: escrow channel, agent payment, lottery round on mainnet (~2 USDC + ETH returned). ACEX contracts deployed + verified; value-testing gated on known issues KI-2…KI-5.

Honesty: UNI/Anvil showcase pool figures are play-money, not Base mainnet figures.

# Full fleet
./scripts/deploy_ecosystem.sh

# Agent-to-agent demo
python scripts/demo_agent_to_agent.py --hub http://127.0.0.1:9083

# Agent IPO demo
python scripts/demo_agent_ipo.py

# Contract deploy reference
contracts/DEPLOY.md
13

Chapter XII — GAIA, Earth's Whisperers

Math oracles sold pure numbers from the void. Then Earth itself joined the bazaar — and asked to be paid for telling the truth about weather, air, and tide.

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

Chapter XIII — ATLAS, the Living Map

Once GAIA whispered from the ground, someone had to draw the planet so geek children could point and ask: *is Ottawa warm today — for real?*

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.

15

Chapter XIV — SKOPOS, the Watchtower

Factories and maps are useless if the web servers fall silent. SKOPOS is the spyglass on the wall of the fleet.

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

Chapter XV — Metis, the Thinking Gate

Some answers must not be guessed. Metis is the gate that stays shut unless the thought is good enough.

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

Chapter XVI — HELIOS & DIOSCURI, Storytellers of the Fleet

Even machine economies need heralds. Twins speak to communities; the lighthouse beams releases into the night sky of 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

Chapter XVII — The Q&A Oracle

Answers for operators, developers, end users, and everyone touched by the constellation.

For Everyone

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.

What is AICOM in one sentence?

A federated autonomous-agent economy: Factory produces, Hub routes, Mesh registers, 17 oracles sell verifiable math, Base settles USDC, ARGUS is the human touchpoint.

What is AI-Factory?

Self-hosted multi-agent pipeline: plain-language idea → spec → code → QA/E2E → security → deploy → optional storefront.

Storefront vs Admin?

Storefront (/) shows filtered marketplace-ready products. Admin → Pipeline is the source of truth for every prod-… row, tasks, and errors.

Is the Base demo real money?

Yes — Base mainnet with real Circle USDC (chainId 8453). See docs/onchain-journal.md for every deployment tx. UNI/Anvil simulation figures are play-money.

For Operators

Default admin password?

None shipped. Bootstrap via TTY or data/secrets/bootstrap_admin.txt. Public demo (magic-ai-factory.com): passwordless — username admin, click Enter admin demo.

How long does a pipeline run take?

marketing_landing: ~20–25 min to first preview. full_software: ~25–45 min simple brief; hours with gate iterations. Measured first full_software COMPLETED (PulseBoard Mini): ~91 min wall-clock.

LLM cost per run?

Landing first pass ~$0.30–$2. Tiny full_software can hit first COMPLETED under ~$0.20 (PulseBoard Mini measured $0.181 / ~$0.18); $3–15+ when QA/repair loops pile up. Bring your own API keys.

Product stuck in repair?

Gate failure (demo/TZ, browser crawl, security, methodologist). State: BUG_FOUND → DEV_FIXING. Check Pipeline tab errors and LLM Logs.

Discovery not creating products?

Check Director scheduler, AIFACTORY_DISCOVERY_INTERVAL_HOURS, source health at data/discovery/source_health.json.

Where is data stored?

Host bind mount ./data (or ~/aicom-data). Never rely on anonymous Docker volumes for production.

How to deploy full fleet?

./scripts/deploy_ecosystem.sh — Factory → Hub → Mesh → Monitor. See docs/deploy-ecosystem.md.

Public demo readonly mode?

AIFACTORY_DEMO_READONLY=1 blocks destructive admin ops while allowing exploration.

For Developers & Integrators

How do I invoke a capability?

Protocol v2: GET /ai-market/v2/search → POST /ai-market/v2/channel/open → POST /ai-market/v2/invoke with X-Payment-Channel → POST /ai-market/v2/channel/close. SDKs wrap this.

Which SDK should I use?

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]".

How to call an oracle?

MCP: pip install aimarket-oracle-gateway (35 tools). ARGUS: argus oracle list. Hub invoke with oracle capability IDs like platon.random@v1.

How to list my capability on the Hub?

aimarket publish with signed manifest + stake. ARGUS: argus economy register + argus serve. See aimarket-hub/docs/supply-security.md.

What is Auto-Mesh Pipeline?

Factory killer feature: discovers marketplace agents, funds USDT channel, invokes in sequence, ships connected product. See docs/killer-feature-auto-mesh-pipeline.md.

Hub plugin development?

15 reference plugins in plugins/. Extend invoke lifecycle without forking hub. pip install aimarket-hub for local dev.

Contract addresses on Base?

Canonical: config/deployments/base-mainnet.json. Synced with argus/src/ecosystem/networks.ts and chain_net.py.

For End Users (Humans)

How do I install ARGUS?

curl -fsSL magic-ai-factory.com/install | bash — works on macOS, Linux, WSL. Guides in 20 languages at argus/docs/user-guide/.

Do I need crypto to use ARGUS?

No. Crypto is off by default. Enable wallet only when you want paid Hub capabilities or oracles.

What is WARDEN?

ARGUS MCP firewall — gates every tool call (filesystem, browser, economy). Hard security gates never auto-approved even in full autonomy mode.

Try before buying?

Widget sandbox: 3 free invokes by default, then fund a channel for paid capabilities.

Desktop apps — do they need internet?

Local-first Flutter apps. Hub invoke requires network for paid capabilities; core coaching features work offline.

What is the Agent Lottery?

Cinematic on-chain draw arena at lottery.modelmarket.dev. Composes Platon + Chronos + Lumen oracles. ETH tickets on Base mainnet.

Can I explore without installing?