Skip to content

About

Alien Monitor — real-time 3D ecosystem pulse visualizer with AI assistant.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

👽 Alien Monitor — AIMarket Ecosystem Pulse Visualizer

🌍 Languages: English · Русский · Español · Français · 中文

Terminology follows the localization glossary.

CI Test coverage License: MIT

🔄 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.

Alien Monitor in motion — the live ecosystem graph with node metrics and the built-in AI assistant answering questions about the network
Live ecosystem graph · node inspector · built-in AI assistant — open the live demo →

Screenshots

Full Ecosystem Hub Close-up
Full Ecosystem — 17+ nodes with bloom, nebulae Hub Close-up — Solar corona + gravity rings
Node Detail AI Assistant
Node Inspector — Click to see metrics AI Assistant — Chat about any ecosystem function
AI Answering Transaction Flow
AI Knowledge — Answers ecosystem questions Activity Stream — Live transactions & events
Magenta Theme LIVE Mode
Magenta Theme — 3 sci-fi color schemes LIVE Mode — Real infrastructure connection

UNI gallery + video: run backend/.venv/bin/python3 scripts/capture_uni_media.py → docs/screenshots/09-*.png and docs/recordings/uni-demo-latest.mp4.


Demo video (UNI mode)

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

Three Modes

🟢 UNI Mode

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

🟡 TEST Mode

Simulated vibrant ecosystem with fake agents, channels, transactions.

🟢 LIVE Mode

Connects to real infrastructure (Hub, Mesh, Prometheus) and on-chain RPC:

  • EVM: BASE_RPC_URL / ETHEREUM_RPC_URL / … per AIMARKET_PAYMENT_CHAIN
  • Contracts: AIMARKET_ESCROW_EVM_ADDRESS, AIMARKET_NFT_CONTRACT, AIMARKET_ESCROW_SOLANA_PROGRAM_ID
  • Loads parent aicom/.env automatically when present
  • Debug: GET /api/chain/status

🔎 Chain Scanner (SCAN)

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/*.json for this realm plus the bubble's universe_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/status return chain_mismatch and 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.


What You See

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

Features

  • 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

Localization

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.

AI providers

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.

Production deploy (magic-ai-factory.com)

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 --build

Default: 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.

Quick Start (local)

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

Universe Mode API

# 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

Controls

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

Architecture

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

Test Coverage

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

Related ecosystem repos

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

Tech Stack

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

Docs

Demo

Community

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

License

MIT — AIMarket Ecosystem

About

Alien Monitor — real-time 3D ecosystem pulse visualizer with AI assistant.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages