Quick Start — Ecosystem

Stand up the core fleet on one VPS (Factory, Hub, Mesh, ARGUS, Alien Monitor, lottery relayer, ecosystem landing) — not the seventeen oracles (Level 4). For Factory-only, see Quick-Start.

Full tiered runbook (with RU/ES/FR/ZH versions): docs/quickstart-ecosystem-deploy.md · RU · ES · FR · ZH

Requirements

• Docker + Docker Compose v2; nginx (for the public tier); DNS A-records
• A populated .env (LLM keys) — see .env.example
• For production: a factory host and a separate oracle host (Level 4 — or same VPS for lab)

The fleet, one command

git clone https://github.com/alexar76/aicom.git
cd aicom
cp -n .env.example .env   # add at least one LLM provider key
./scripts/quickstart_ecosystem.sh        # preflight + deploy + next steps
# or call the engine directly:
./scripts/deploy_ecosystem.sh            # 7 deploy steps + verify (17+ checks)

Service	Local URL
Factory	http://localhost:9080 (API :9081)
Hub	http://localhost:9083
Mesh	http://localhost:8090
ARGUS	http://localhost:8787/health
Monitor	http://localhost:9100
Pulse	http://localhost:5199
UNI lottery relayer	http://localhost:9195
Ecosystem landing	https://modeldev.modelmarket.dev/ (after TLS)

Not in core fleet script (deploy separately — see runbook §9): Metis, LOGOS, SKOPOS, MOMUS/Treasury, GAIA/ATLAS, Signal Hunt, DIOSCURI, HELIOS, THEOROS, seventeen oracles, School.

Production (public + TLS)

./scripts/quickstart_ecosystem.sh --public-url https://your-domain.example.com
sudo [email protected] ./scripts/setup-modelmarket-ssl.sh   # Hub TLS
# + certbot for the factory domain — see [Deployment](/alexar76/aicom/wiki/Deployment)
./scripts/verify_ecosystem_full.sh

Oracle host (separate machine by default)

deploy_ecosystem.sh does not deploy the seventeen oracles. On the oracle host:

sudo [email protected] ./scripts/setup-oracles-platon-on-host.sh
./scripts/announce-platon-oracles.sh     # then federate from the factory host

On-chain (optional, Base mainnet 8453)

./scripts/deploy_ecosystem_base.sh broadcast   # FakeUSDT / Escrow / NFT
./scripts/deploy_lottery_base.sh broadcast      # AIAgentLottery

Monitor mode: LIVE vs UNI

The Alien Monitor runs in universe (self-contained simulation) by default. To bind it to the real chain (Base) at deploy time:

ALIEN_MODE=real ./scripts/deploy_alien_monitor.sh    # or: --live

LIVE reads the live contract addresses from chain_net and skips the embedded dev chains.

---

Full details, troubleshooting, ports, and the RU/ES translations: docs/quickstart-ecosystem-deploy.md.