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

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

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / dbos_argus-0.0.41.tar.gz

Download URL dbos_argus-0.0.41.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
c6f62176e84875edbd957c8986794b1858a4ec6e95f0c22cc96653d3f598d6a2
BLAKE2b-256 checksum
How to use checksums
7cf0a19cf81f810975e2057894b9501f8d469f0ac43d92f126d3e37ae43ae98f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","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.41-py3-none-any.whl

Download URL dbos_argus-0.0.41-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
070cf6ad89627571ef4d3f3b82c36f1bf8bb05182017d6b0d46f10bb07cd3630
BLAKE2b-256 checksum
How to use checksums
8b334bf093a13522267cf9650713911ea6f4f754ecf3fbabf7c90995a0b086a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","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.41

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