SKOPOS (skopos/) is the fleet observability satellite of AICOM — nginx & Apache analytics over SSH, Security Center, scan history, an AI analyst, and an Observability page (Prometheus PromQL KPIs + 3D service graph; see observability-prometheus.md). Self-hosted; PostgreSQL recommended for production.
| Surface | URL | Role |
|---|---|---|
| Dashboard | skopos.modelmarket.dev | Streamlit UI (password-protected in production) |
| Public status | GET /healthz |
Non-secret JSON for Alien Monitor & probes |
| Alien Monitor | monitor.modelmarket.dev/ | 3D graph node — click SKOPOS sphere |
| Env | Purpose |
|---|---|
ALIEN_SKOPOS_URL |
Poll GET /healthz (default https://skopos.modelmarket.dev) |
ALIEN_PUBLIC_SKOPOS_URL |
Panel link — dashboard URL |
ALIEN_SKOPOS_GITHUB_URL |
GitHub link in panel (default https://github.com/alexar76/skopos) |
Health response (non-secret):
{
"ok": true,
"service": "skopos",
"version": "0.1.0",
"database": "postgresql",
"log_parsers": ["nginx", "apache"],
"servers_monitored": 1,
"requests_total": 4035,
"security_score": 87
}Graph position: west shelf near Metis (skopos @ -11.5, -3.5, 1.5).
Edges: factory → skopos (traffic telemetry), skopos → metis (host fleet), skopos → hub (ecosystem posture).
Click the sphere → Open SKOPOS dashboard, GitHub, docs, integration guide. Metrics show servers monitored, total parsed requests, and security score — no secrets.
Production test stack: metis/deploy/skopos-test/.
cd metis/deploy/skopos-test
./remote-sync.shNginx vhost skopos.modelmarket.dev is in metis/deploy/nginx.conf — proxy :8501 (UI) and :8502 (/healthz).
TLS (once DNS points to the Metis host):
docker run --rm -v /opt/metis/deploy/letsencrypt:/etc/letsencrypt \
-v /var/www/certbot:/var/www/certbot certbot/certbot certonly --webroot \
-w /var/www/certbot -d skopos.modelmarket.dev --agree-tos -m [email protected]
docker restart metis-nginx| Path | Role |
|---|---|
skopos/ |
Application source |
metis/deploy/skopos-test/ |
Docker Compose + servers.yaml for Metis host |
alien-monitor/backend/skopos_*.py |
Graph node + live poll |
docs/ecosystem/skopos-integration.md |
This file |
Satellite repo: alexar76/skopos — publish via ./scripts/publish_all_repos.sh --satellite skopos.
Landing: skopos.modelmarket.dev (live) · alexar76.github.io/skopos (GitHub Pages, EN/RU/ES). Source: skopos/docs/landing/index.html. Workflow: skopos/.github/workflows/pages.yml.
SKOPOS does not require Factory, Hub, or Metis at runtime. Alien Monitor degrades gracefully when /healthz is unreachable (node shows offline).
SKOPOS can sell fleet intelligence to other AI agents via the AIMarket Protocol v2 — same pattern as Metis /aimarket/invoke.
Off by default. Enable only when you want SKOPOS in the federated agent economy:
SKOPOS_AIMARKET_ENABLED=1
SKOPOS_AIMARKET_PUBLIC_URL=https://skopos.modelmarket.dev
# Optional: protect invoke with API key
SKOPOS_AIMARKET_API_KEY=your-secret
# Optional: auto-register capabilities on Hub at startup
SKOPOS_HUB_URL=https://modelmarket.dev
SKOPOS_AIMARKET_AUTO_REGISTER=1
SKOPOS_AIMARKET_PUBLISH_TOKEN=...| Endpoint | Role |
|---|---|
GET /.well-known/ai-market.json |
Discovery |
GET /ai-market/v2/manifest |
Capability catalog |
POST /aimarket/invoke |
Hub invoke contract {input, product_id, capability_id} → {result} |
| ID | What it sells | ~USD/call |
|---|---|---|
skopos.fleet.status@v1 |
Heartbeat + security score | $0.01 |
skopos.security.posture@v1 |
Fleet score, alerts, remarks | $0.08 |
skopos.traffic.summary@v1 |
24h traffic aggregates | $0.05 |
skopos.briefing@v1 |
Human fleet briefing (rules / LLM) | $0.15 |
ARGUS, Factory, or Alien Monitor can buy posture context without SSH access to your fleet.
Set SKOPOS_HUB_URL so SKOPOS can discover Hub capabilities (free search). Paid invokes from SKOPOS to oracles require a wallet integration (future); standalone mode ignores missing Hub.
Nginx on Metis should proxy port 8502 for /healthz, /.well-known/*, /ai-market/*, and /aimarket/invoke (see metis/deploy/nginx.conf).