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.40

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.40
File Size Uploaded Provenance
dbos_argus-0.0.40.tar.gz 1.1 MB Without provenance Details

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / dbos_argus-0.0.40.tar.gz

Download URL dbos_argus-0.0.40.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
20bbe23ff59f380a7df0995b61275172958de6c7ab1d6c10a8bfb317bfe103ed
BLAKE2b-256 checksum
How to use checksums
e8136c0e951e0263bcd99bf2b2db8acf57621b6c3a62d3fbb53724004f2b8d11
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.40-py3-none-any.whl

Download URL dbos_argus-0.0.40-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
6b6026a82540109a3dc19f20eb5e1a2fe899f4d473421b10980c7e9ee1dd99e6
BLAKE2b-256 checksum
How to use checksums
12894cd95a6f087031aae01c35aa801d5cd3cfd4f708f4b54fae9f707625baf1
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.40

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.40 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