SKOPOS — fleet observability satellite of the AICOM ecosystem

🌐 English · Русский · Español · Français · 中文 · Glossary

WARDEN quality cycle: MOMUS → AI-Factory → SKOPOS → shared node agent → deployment.

Self-hosted nginx & Apache analytics and AI security for your server fleet — GA-like HTTP dashboards, Security Center with 3D threat map, Prometheus Observability (APM KPIs + 3D service graph), scan history, and an AI agent with voice input. No third-party trackers; data stays on your infrastructure.

Live demo · Landing · nine built-in themes

In Greek, skopos (σκοπός) means watcher or scout. SKOPOS is the fleet observability satellite of the AICOM / AIMarket ecosystem: nginx traffic over SSH, security posture across factory / metis / oracle hosts, and an LLM analyst in the sidebar.

Features

• Analytics — nginx access logs over SSH, SQLite, Streamlit charts, traffic globe
• Security — CPU/RAM/disk/network, port audit, firewall, cyberpunk 3D threat map, consolidated Security Report
• Scan History — score timeline, findings trends, snapshot comparison
• Auto-scan — configurable background security scans (default every 60 min)
• AI Agent — OpenRouter (default), DeepSeek, OpenAI, Anthropic, Ollama, LM Studio; sidebar chat with voice input
• i18n — English (default), Russian, Spanish (locales/)

Quick start

See docs/quickstart.md.

cp servers.example.yaml servers.yaml
cp agent.example.yaml agent.yaml
export OPENROUTER_API_KEY=sk-or-...
python skoposctl.py collect
python skoposctl.py security-scan
streamlit run dashboard.py

Security

• Security Score (0–100, grade A–F) in sidebar on every page
• Threat alerts banner when critical/high issues exist
• Dashboard password — set/change/regenerate in the admin panel; only a salted PBKDF2 hash is stored in the DB (env SKOPOS_DASHBOARD_PASSWORD still supported for bootstrap). A post-deploy modal prompts you to set one, and passwords expire after 90 days with a Telegram reminder. See configuration → Dashboard password & rotation
• SKOPOS_SSH_STRICT_HOST_KEYS=1 — verify SSH host keys (recommended)
• Login limits — 5 failures lock one address for 5 minutes; failures from many addresses together (SKOPOS_LOGIN_GLOBAL_MAX_ATTEMPTS, 30 per 15 min) slow new addresses down, at most a minute per submitted try. The password is checked after that attempt's own delay even if other addresses keep failing; the login form stays available. An address that logged in within SKOPOS_LOGIN_KNOWN_DAYS (30) never waits.
• Proxy headers — X-Real-IP / X-Forwarded-For count only from SKOPOS_TRUSTED_PROXIES (loopback by default; the compose file adds gateway, the host's nginx)
• Remediation git push — every SSH remote's host key is pinned on first use; only a loopback Gitea may skip it, with SKOPOS_GIT_SKIP_HOST_KEY_LOOPBACK=1
• See docs/audit-findings.md

Documentation

Analytics scope: traffic dashboards parse nginx access logs by default. Apache combined logs are supported when apache.enabled: true. Security probes are stack-agnostic.

Configure servers

Edit servers.yaml — SSH host, nginx log paths. See servers.example.yaml.

For per-domain analytics, include $host in nginx log_format.

AI agent

Default provider: OpenRouter via OPENROUTER_API_KEY. Edit agent.yaml for DeepSeek, OpenAI, Anthropic, Ollama, or LM Studio.

For a full prioritized remediation report, open Security → Security Report. The sidebar agent supports follow-up chat (including voice) on every page.

Docker

docker compose up -d --build

Open http://localhost:8501

License

MIT — see LICENSE.

Testing & coverage

pip install -r requirements.txt pytest pytest-cov
bash scripts/ci_coverage_badge.sh -- tests/ -q --cov=skopos

227 pytest cases · line coverage on skopos/ tracked in docs/badges/coverage.svg (regenerate with bash scripts/ci_coverage_badge.sh, verified by CI).

Screenshots

Captured from skopos.modelmarket.dev — Analytics dashboards (traffic timeline + country-share donuts) in six themes (sidebar Theme picker):

_{Light · Premium}

_{Cosmos (midnight) · Ocean}

_{Aurora · Slate}

View	Screenshot
Security — 3D Threat Map
Sidebar & navigation
Floating AI agent

Regenerate hero + theme gallery from production:

export SKOPOS_DASHBOARD_PASSWORD='…'
pip install playwright pillow && playwright install chromium
python scripts/capture_readme_screenshots.py --base-url https://skopos.modelmarket.dev/app/