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.
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dbos_argus-0.0.36.tar.gz.
File metadata
- Download URL: dbos_argus-0.0.36.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e5eefc4b7052d08a696da600464ba6b5d9e04c3af03d090648f8b4e21b8f520
|
|
| MD5 |
a140134795e97690e7293d219bb285bc
|
|
| BLAKE2b-256 |
5a8cfce771c7835ad06a0edebc0fb3da681c011a236f427d9a302465b8bb3644
|
File details
Details for the file dbos_argus-0.0.36-py3-none-any.whl.
File metadata
- Download URL: dbos_argus-0.0.36-py3-none-any.whl
- Upload date:
- Size: 1.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
de7f463a545f40342080132b3857cc2b614f260b113676f4cb1efc89e62ac50f
|
|
| MD5 |
9e031ffdb08d8b5cf65c6edd1e5578c3
|
|
| BLAKE2b-256 |
b506d2f8a16d06cc9dcd12a867043763cd6c612a56a4efc769795b11723d276b
|
