Installation

Quick Start (Docker)

The fastest way to get Argus running is with a single Docker command:

docker run -d --name argus \
  -p 7600:7600 -p 3000:3000 \
  -e ARGUS_LLM__PROVIDER=openai \
  -e ARGUS_LLM__API_KEY=your-api-key \
  -e ARGUS_PUBLIC_URL=http://your-server-ip:7600 \
  -v argus_data:/data \
  ghcr.io/precious112/argus:latest

This starts both the agent server (port 7600) and web UI (port 3000).

Docker Compose

For a multi-container setup, clone the repo and use Docker Compose:

git clone https://github.com/precious112/Argus.git
cd Argus
docker compose up -d

LLM Provider Configuration

Argus is LLM-agnostic. Set your preferred provider via environment variables:

Access the Dashboard

Once running, open your browser:

• Web UI: http://your-server-ip:3000
• Agent API: http://your-server-ip:7600

Create your first user account from the web UI to get started.

Local Development

For development, install dependencies and run locally:

git clone https://github.com/precious112/Argus.git
cd Argus
make install    # Install dependencies
make dev        # Start agent server
make dev-web    # Start web UI (in a second terminal)

Next Steps

• Connect the SDK to start sending metrics
• Explore the dashboard