guardana-server
Guardana's optional collector — a minimal FastAPI service that ingests findings from many agents and, optionally, serves a read-only monitoring dashboard.
Part of Guardana — security verification for self-hosted and self-built AI (model files, live endpoints, and agents) from one rule engine that runs on your laptop, in CI, and next to a served model.
Run it
pip install "guardana-server[serve]" # `[serve]` adds the ASGI server
export GUARDANA_DATABASE_URL=postgresql://guardana:secret@db:5432/guardana
guardana-collector migrate # never on start: see the docs for why
guardana-collector bootstrap --org acme --project web # prints the key, once
guardana-collector serve # http://127.0.0.1:8000
serve binds loopback unless you pass --host 0.0.0.0. The ASGI server is an
extra rather than a dependency, so a deployment that already runs gunicorn or
hypercorn can point it at the app instead:
gunicorn -k uvicorn.workers.UvicornWorker 'guardana.server:create_app()'.
There is an official image too:
docker run -p 8000:8000 -e GUARDANA_DATABASE_URL=… ghcr.io/guardana/guardana-collector:0.25.
The dashboard is a single self-contained page (no build step, works offline)
showing severity, per-source/per-rule breakdowns, an activity-over-time trend,
the unverified counter, and a filterable recent-findings table. It is
read-only, and signs in with a read-scoped API key that it holds in an
HttpOnly, SameSite=Strict cookie — a browser has nowhere safe to put a bearer
token, so it never gets one. It is still a panel over a security database: put it
behind the same network boundary as the collector itself (see
SECURITY.md).
- Main README & quickstart: https://github.com/guardana/guardana#readme
- Documentation: https://guardana.dev
Licensed under Apache-2.0.
1 maintainer
Release files for guardana-server 0.25.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| guardana_server-0.25.0.tar.gz | 136.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| guardana_server-0.25.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 243.2 kB
Release files / guardana_server-0.25.0.tar.gz
| Download URL | guardana_server-0.25.0.tar.gz |
|---|---|
| Size | 136.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ed7b8dd16dc83e3f82bd106e46b4f33b7bf31479a813cc2c4d82afc8846c9261
|
|
BLAKE2b-256 checksum How to use checksums |
001b551ec6906f9504e88900b804eaf0e3e4f9ccf0d53dce6c6c456b50f251d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 20, 2026.
Transparency logRelease files / guardana_server-0.25.0-py3-none-any.whl
| Download URL | guardana_server-0.25.0-py3-none-any.whl |
|---|---|
| Size | 107.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bdb70851c58aed194756ceccb2dae883cbb5ee5b16fa9ab268b2b2490d47f8bc
|
|
BLAKE2b-256 checksum How to use checksums |
508467794d7ad3f513c74fb9504f66312add8ac32e3f4a94818e554d0b8d0b35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 20, 2026.
Transparency log
