comisai/comis-web repository overview

⁠Comis Web Dashboard

Web dashboard for Comis⁠, the open-source security-first runtime for AI agents that learn and act across sessions. Use it to manage agents and channels, inspect traces, review learned state, and follow live events. Learned guidance can influence an agent's proposals, but it cannot grant permission; runtime controls remain authoritative.

This image bundles the compiled SPA served by Nginx (nginx:alpine), with a built-in reverse proxy to the daemon for /api/* and /ws traffic.

• Source: https://github.com/comisai/comis⁠
• Docs: https://docs.comis.ai⁠
• License: Apache-2.0

⁠Supported architectures

linux/amd64 · linux/arm64

⁠Tag strategy

Versions move in lockstep with comisai/comis⁠ — match the tag to the daemon you're running.

⁠Quick start

The dashboard is a thin SPA — it expects a Comis daemon reachable at the hostname comis-daemon (the default service name in the Compose file).

⁠Docker Compose (recommended)

services:
  comis-daemon:
    image: comisai/comis:latest-slim
    # ... see comisai/comis README for full config

  comis-web:
    image: comisai/comis-web:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:8080"
    depends_on:
      comis-daemon:
        condition: service_healthy

Open http://127.0.0.1:8080⁠.

⁠Standalone (advanced)

If running outside Compose, expose the daemon to the web container under the hostname comis-daemon:

docker network create comis-net

docker run -d --name comis-daemon --network comis-net \
  comisai/comis:latest-slim

docker run -d --name comis-web --network comis-net \
  -p 127.0.0.1:8080:8080 \
  comisai/comis-web:latest

⁠Configuration

⁠Ports

⁠Built-in routes

The daemon hostname is resolved at request time via Docker's embedded DNS (127.0.0.11), so the web container can start before the daemon is ready.

⁠Health

Built-in HEALTHCHECK hits http://127.0.0.1:8080/ every 30 seconds.

⁠Custom Nginx config

Override the bundled config by mounting your own:

services:
  comis-web:
    image: comisai/comis-web:latest
    volumes:
      - ./my-nginx.conf:/etc/nginx/conf.d/default.conf:ro

The default config lives at docker/nginx.conf⁠ in the source repo.

⁠Companion images

• comisai/comis⁠ — daemon + gateway (required)

⁠Links

• Documentation: https://docs.comis.ai⁠
• Install with Docker: https://docs.comis.ai/installation/install-docker⁠
• Issues: https://github.com/comisai/comis/issues⁠
• Releases: https://github.com/comisai/comis/releases⁠