Quick Start Ecosystem

Quick Start — Ecosystem

Stand up the whole ecosystem (Factory, Hub, Mesh, Alien Monitor, Oracles, optional on-chain) — not just the factory. For the single-product factory quick start, see Quick-Start.

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

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

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            # Factory → Hub → Mesh → Monitor → verify (17+ checks)

Service	Local URL
Factory	http://localhost:9080 (API :9081)
Hub	http://localhost:9083
Mesh	http://localhost:8090
Monitor	http://localhost:9100
Pulse	http://localhost:5199
UNI lottery relayer	http://localhost:9195

Production (public + TLS)

./scripts/deploy_ecosystem.sh --public-url https://your-domain.example.com
sudo CERTBOT_EMAIL=you@example.com ./scripts/setup-modelmarket-ssl.sh   # Hub TLS
# + certbot for the factory domain — see [[Deployment]]
./scripts/verify_ecosystem_full.sh

Oracle host (separate machine)

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

sudo CERTBOT_EMAIL=you@example.com ./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.