Skip to main content

dbos-argus

Self-hosted, read-only workflow viewer for DBOS Transact.

Argus is a web dashboard for the durable workflows your DBOS apps are already running. It opens a read-only connection to the same Postgres your DBOS app uses and renders the workflow state from dbos.workflow_status and friends. No agents, no app-side wiring, no schema of its own.

This is the PyPI package: a FastAPI backend with the SvelteKit console SPA bundled inside the wheel. One uvx away.

Argus dashboard

Workflow detail with step graph

For production workflow operations, use DBOS Conductor — the DBOS-supported management service for recovery, retention, alerting, and team controls. Argus is a dev-focused companion for inspecting workflow state.

Quick start

Point at the same Postgres your DBOS app writes to. Open http://localhost:8090.

uvx (no install)

uvx dbos-argus --db-url "postgresql://USER:PASS@localhost:5432/YOURDB"

pipx

pipx install dbos-argus
dbos-argus --db-url "postgresql://USER:PASS@localhost:5432/YOURDB"

Docker

docker run --rm -p 8090:8090 \
  -e ARGUS_DATABASE_URL="postgresql://USER:PASS@host.docker.internal:5432/YOURDB" \
  tmarkovski/dbos-argus:latest

A bare postgresql:// URL is fine — Argus rewrites the scheme to postgresql+asyncpg:// for you. For Azure Database for PostgreSQL hosts, sslmode=require is enabled by default.

Configuration

Purpose
--db-url / ARGUS_DATABASE_URL Postgres URL your DBOS app writes to
ARGUS_CORS_ORIGINS Comma-separated allowed origins (only when serving the console from a different host than the API)

dbos-argus --help for the full flag list.

More

Full project docs, CHANGELOG, contributing guide, and the source for the SvelteKit console all live in the monorepo: github.com/tmarkovski/dbos-argus.

MIT licensed. Not affiliated with DBOS Inc.

Metadata

Release files for dbos-argus 0.0.39

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dbos-argus 0.0.39
File Size Uploaded Provenance
dbos_argus-0.0.39.tar.gz 1.1 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for dbos-argus 0.0.39
File Interpreter ABI Platform
dbos_argus-0.0.39-py3-none-any.whl Python 3 none any Details

Total release size: 2.3 MB

Release files / dbos_argus-0.0.39.tar.gz

Download URL dbos_argus-0.0.39.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
b8563c6d050554ca44307e227c5607c13ffdc2b9066ad720467c1af9afa63aac
BLAKE2b-256 checksum
How to use checksums
60df590d711aa8022b5bdf9288972b5086f3ce43235dfacc85256c14a4825971
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / dbos_argus-0.0.39-py3-none-any.whl

Download URL dbos_argus-0.0.39-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
f447d989541a50616a0a12453c804a8e077f5119079eb65ef800efef0e9a40a7
BLAKE2b-256 checksum
How to use checksums
5e45af416bea812dc09041da1ba444671607172d0c935b720739b0112bcb6edb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for dbos-argus 0.0.39

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.39 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page