Argus docs
All pages

Postgres, Qdrant and MinIO/S3

Optional stores for cortex's argus_cortex.store. Each one is off unless its URL is set. Agent-composer's guard server also needs a Postgres and a Qdrant to start.

Used by

PackageWhat forReads
argus-cortex (opens in new tab)

Records (Postgres), vectors (Qdrant) and blobs (S3-compatible).

CORTEX_PG_URL, CORTEX_QDRANT_URL, CORTEX_S3_ENDPOINT, CORTEX_S3_BUCKET, [postgres], [qdrant], [s3]

argus-lens (opens in new tab)

--backend replay reads recorded captions from Postgres, and LENS_RECORD_LINEAGE=1 records them.

CORTEX_PG_URL, LENS_RECORD_LINEAGE, [replay], [lineage]

SingGuard guard server

agent-composer's rag-chat refuses to start without both.

QDRANT_URL, DATABASE_URL

Official guides

Minimal setup

For production, follow the official guides: the PostgreSQL install guide (opens in new tab) and the Postgres Docker image (opens in new tab) (its environment variables and data volume), the Qdrant quickstart (opens in new tab) and its installation guide (opens in new tab), and MinIO in a container (opens in new tab). For a local try-out, the official images are enough:

docker run -d --name pg -e POSTGRES_PASSWORD=… -p 127.0.0.1:5432:5432 postgres
docker run -d --name qdrant -p 127.0.0.1:6333:6333 qdrant/qdrant

Then point each client at them:

  • cortex and lens: CORTEX_PG_URL=postgresql://user:pass@localhost:5432/argus, CORTEX_QDRANT_URL=http://localhost:6333, and for S3 CORTEX_S3_ENDPOINT, CORTEX_S3_ACCESS_KEY, CORTEX_S3_SECRET_KEY, CORTEX_S3_BUCKET (and CORTEX_S3_REGION). Install the matching extras. Every store is off unless its variable is set.
  • agent-composer: DATABASE_URL and QDRANT_URL in its .env. Its rag-chat service won't start without them, even if you only use the guard.