🌍 Languages: English · Русский · Español · Français · 中文
Terminology follows the localization glossary.
🔄 Synced from the AI-Factory monorepo (append-only history). Pull requests are welcome — merged PRs are imported back and re-synced here. Issues · Pull requests
Ecosystem: AICOM overview & live demos · Community: Telegram · Castor · Discord · Pollux
Maps: UNI https://monitor-uni.modelmarket.dev/ (ALIEN_MODE=universe) · LIVE https://monitor.modelmarket.dev/ (ALIEN_MODE=real). Split: uni-and-live.md.
Pulse Terminal (Agent Capital Exchange) runs on the same host: https://magic-ai-factory.com/pulse/ — deploy both with docker compose -f docker-compose.prod.yml up -d --build or ./scripts/deploy_alien_monitor.sh from the monorepo root.
Watch every component — hub, contracts, agents, desktop apps, plugins, blockchains — as a living, breathing cosmos. Click any node to zoom in, inspect metrics, and see live data flowing through the network.
Live ecosystem graph · node inspector · built-in AI assistant — open the live demo →
UNI gallery + video: run
backend/.venv/bin/python3 scripts/capture_uni_media.py→docs/screenshots/09-*.pnganddocs/recordings/uni-demo-latest.mp4.
Regenerate after ./start.sh --universe or with auto-boot:
backend/.venv/bin/python3 scripts/capture_uni_media.py| Asset | Path |
|---|---|
| WebM | docs/recordings/uni-demo-latest.webm |
| MP4 | docs/recordings/uni-demo-latest.mp4 |
Local chain + live polls from deployed Hub, Mesh, Factory, and Prometheus — same UI as LIVE (no simulated metrics).
- Embedded EVM (Anvil) + optional Solana validator
- Auto-deploy Escrow / NFT on local chain
- Factory webhook:
POST /api/universe/materialize
Simulated vibrant ecosystem with fake agents, channels, transactions.
Connects to real infrastructure (Hub, Mesh, Prometheus) and on-chain RPC:
- EVM:
BASE_RPC_URL/ETHEREUM_RPC_URL/ … perAIMARKET_PAYMENT_CHAIN - Contracts:
AIMARKET_ESCROW_EVM_ADDRESS,AIMARKET_NFT_CONTRACT,AIMARKET_ESCROW_SOLANA_PROGRAM_ID - Loads parent
aicom/.envautomatically when present - Debug:
GET /api/chain/status
A small block explorer for the realm's own chain. The UNI bubble runs its own Anvil, and until this existed nothing in the monitor had ever read a block. Open it with the SCAN button in the control bar.
| Endpoint | What it answers |
|---|---|
GET /api/chain/scan?limit=40 |
recent transactions, newest first |
GET /api/chain/tx/{hash} |
one transaction with its receipt (status / gas / logs) |
GET /api/chain/address/{addr} |
balance, nonce, code size, recent transactions |
- Realm-scoped — reads this process's
ALIEN_EVM_RPC, so the UNI monitor scans the bubble and the LIVE monitor scans its own chain. - Read-auth, like every other read route (open when
ALIEN_PUBLIC_READ=1). - Names, never guesses — addresses come from
config/deployments/*.jsonfor this realm plus the bubble'suniverse_config.json; method names from a 4-byte table built off the real ABIs. An unknown selector stays hex. - Chain-identity warning — when the RPC answers as a different chainId than the configured
network, the scan and
/api/chain/statusreturnchain_mismatchand the panel shows a banner. - Never 500s — any failure is an empty scan with a
note; a scanner must not take the dashboard down.
Why it earns its place: an address with code_size: 0 receiving a steady stream of successful
calls is a component driving a contract that no longer exists — a call to a code-less address
does not revert. That is how the UNI lottery relayer spent nine days calling openRound() into
the void, and how the same drift was caught a second time within minutes.
A personal observable universe where each celestial body is a living component:
| Visual | Represents |
|---|---|
| ☀️ Solar hub with corona + gravity rings | AIMarket Hub — the center |
| 🪐 Orbiting planets with wobble physics | Core services: Factory, Mesh, Agent Capital Exchange |
| 💎 Crystalline nodes with orbital rings | Smart contracts (EVM + Solana) |
| 🌌 Nebula clouds | Clusters of related components |
| 🕳️ Wormhole tunnels | Active data flows between services |
| 💫 Asteroid belts | Blockchain network activity |
| ✨ Cosmic dust | Background agent activity |
| 🌟 Constellation lines | Permanent connections |
| 🆕 Materializing planets | New factory products appearing in real-time |
- UNI runtime — Local chain + live layer polling (no mock metrics)
- Product Materialization — Factory products become new planets via webhook
- 3D Force-Directed Universe — Zoom, rotate, pan, fly-to nodes
- Bloom Post-Processing — Everything glows (Bloom + Vignette + Noise)
- Real-Time WebSocket — Live data every 1.5s
- AI Assistant — multi-provider LLM (default DeepSeek
deepseek-v4-pro, same registry as aicom) with live monitor state in every prompt (tick, mode, node metrics, activity) - 3 Themes — Cyan, Magenta, Green with pulse intensity slider
- i18n (EN / RU / ES / FR / ZH) — JSON locale files, browser-detected language, switcher in the control bar; AI replies in the selected language. Terminology follows docs/localization-glossary.md, enforced by
frontend/src/__tests__/glossary.test.ts
| Locale | UI strings | README |
|---|---|---|
| English | frontend/src/i18n/locales/en.json |
README.md |
| Русский | frontend/src/i18n/locales/ru.json |
README.ru.md |
| Español | frontend/src/i18n/locales/es.json |
README.es.md |
| Français | frontend/src/i18n/locales/fr.json |
README.fr.md |
| 中文 | frontend/src/i18n/locales/zh.json |
README.zh.md |
All five carry the same 344 keys; parity, empty strings and glossary terms are held by tests, so a locale cannot silently fall behind.
Choice is stored in localStorage (alien-monitor-locale). AI requests send locale to POST /api/ai/ask. See frontend/src/i18n/README.md.
Reads data/config/model_providers.yaml from the parent aicom repo (or ALIEN_LLM_CONFIG). Default: deepseek_api / deepseek-v4-pro.
| Endpoint | Purpose |
|---|---|
GET /api/ai/providers |
List enabled providers + models |
POST /api/ai/ask |
{ question, locale, provider?, model_role?, state?, selected_node_id? } |
The frontend sends the current WebSocket state on each question so the model sees the same 3D cosmos data you see.
From the aicom repo root on the server:
./scripts/deploy_alien_monitor.sh
# or: cd alien-monitor && docker compose -f docker-compose.prod.yml up -d --buildDefault: ALIEN_MODE=universe — Anvil + FakeUSDT + Escrow + NFT deploy inside the container on startup.
Factory catalog: UNI syncs GET /api/products from AI-Factory every ~60s and on bootstrap; products appear as star clusters near Factory. Failures/timeouts do not wipe clusters (see docs/uni-troubleshooting.md §16).
Verify: curl -s http://127.0.0.1:9100/api/health | jq . → blockchain_ready: true.
Hub addresses: data/alien-monitor/universe/hub.env.snippet.
Troubleshooting: docs/uni-troubleshooting.md.
Public URLs (with nginx): UNI https://monitor-uni.modelmarket.dev/ · LIVE https://monitor.modelmarket.dev/
Universe compose polls ALIEN_UNI_HUB_URL (https://uni.modelmarket.dev). LIVE compose uses ALIEN_PUBLIC_HUB_URL (https://modelmarket.dev). Do not point the UNI process at the live hub.
| Variable | Default (prod compose) |
|---|---|
ALIEN_MODE |
universe |
ALIEN_UNIVERSE_AUTO_START |
1 |
HUB_URL |
http://127.0.0.1:9083 (API poll; Docker host) |
ALIEN_PUBLIC_HUB_URL |
https://modelmarket.dev (operator link on node cards) |
AICOM_API_URL |
http://127.0.0.1:9081 |
ALIEN_FACTORY_API_TIMEOUT |
30 (seconds; /api/products can be slow) |
PROMETHEUS_URL |
http://127.0.0.1:9090 |
MESH_URL |
http://127.0.0.1:8090 |
| Anvil state volume | ../data/alien-monitor/universe |
Build context is the monorepo root (context: ..) so contracts/evm and Foundry ship in the image.
git clone https://github.com/alexar76/alien-monitor.git
cd alien-monitor
# Virtual Universe mode (embedded blockchain + entities)
./start.sh --universe
# Or test mode with simulated data
./start.sh
# Open: http://localhost:5173# Start the virtual universe
curl -X POST http://localhost:9100/api/universe/start
# Materialize a product (call this from your factory pipeline)
curl -X POST http://localhost:9100/api/universe/materialize \
-H 'Content-Type: application/json' \
-d '{"name": "MyAgent", "type": "ai-agent", "category": "fullstack-app"}'
# Get universe state
curl http://localhost:9100/api/universe/state
# Stop universe
curl -X POST http://localhost:9100/api/universe/stop| Action | How |
|---|---|
| Rotate view | Click + drag |
| Zoom | Scroll wheel |
| Inspect node | Click on planet |
| Close inspector | Esc or × |
| AI Assistant | AI button (top right) |
| Switch mode | TEST / LIVE / UNI buttons |
| Change theme | CY / MG / GR buttons |
| Adjust glow | PULSE slider |
alien-monitor/
├── backend/
│ ├── main.py # FastAPI + WebSocket server
│ ├── universe.py # Virtual Universe Machine
│ └── requirements.txt
├── frontend/ # React + Three.js (R3F)
│ └── src/components/
│ └── EcosystemGraph.tsx # 3D cosmic engine
├── infrastructure/ # Docker compose + seed scripts
├── scripts/ # Screenshot capture, demo recording
├── tests/ # 46 backend + 19 frontend tests
└── docs/ # Screenshots, user guide, security
Backend: 46 tests — topology, simulator, API, AI, WS, edge cases
Frontend: 19 tests — models, formatting, invariants, themes
Total: 65 tests
Run: python3 -m pytest tests/ -v and cd frontend && npm test
| Repo | Role for Monitor |
|---|---|
| aimarket-hub | Hub node — federation, invoke, channels |
| oracles | Oracle family — Platon, Chronos, Lumen, … (visualized as live capability nodes when federated) |
| acex | Capital layer · Pulse Terminal pricing feed |
| aicom | AI-Factory pipeline · shipped products → hub |
| Layer | Technology |
|---|---|
| 3D Engine | Three.js via @react-three/fiber |
| Post-FX | @react-three/postprocessing |
| UI | React 18 + TypeScript + Tailwind |
| Backend | FastAPI + WebSockets |
| AI | Claude API (Anthropic) |
| Blockchain | Anvil (Foundry) + Solana validator |
| Testing | Pytest + Vitest |
- User Guide — Controls, node reference, troubleshooting
- User Cases — 10 real-world scenarios
- Security Assessment — Risk matrix, findings, recommendations
- UNI map: https://monitor-uni.modelmarket.dev/
- LIVE map: https://monitor.modelmarket.dev/
- Docs: https://github.com/alexar76/alien-monitor/blob/main/docs/USER_GUIDE.md
The DIOSCURI twins answer questions from synced GitHub docs.
| Channel | Twin | Best for |
|---|---|---|
| Telegram | Castor | Releases, digests, quick news |
| Discord | Pollux | Help, ideas, show-and-tell |
Ecosystem map: Alien Monitor · AICOM
MIT — AIMarket Ecosystem







