Skip to main content

kestrel_pi

The on-device Python runtime for Kestrel, a Raspberry Pi Wi-Fi capture-and-learning device. It bundles three cooperating pieces:

  • A plugin host daemon (kestrel-daemon) that loads plugins and dispatches a pwnagotchi-compatible on_* hook API off its event loop, drawing on the device's connectivity and capture state.
  • A web dashboard served on the device's management link — a dependency-free, server-rendered status and control surface for capture, plugins, and device actions.
  • A reinforcement-learning agent framework (kestrel-agent, kestrel-agent-train): an optional on-device policy that tunes the capture scan posture, with offline training kept out of the always-on daemon.

It also carries the shared UI state model and a vendored e-ink panel driver that plugins use without pulling hardware imports into the daemon.

The package is installed into the pi user's virtualenv (/home/pi/.venv) by the Kestrel image build. The reference plugins ship separately under /usr/local/lib/kestrel/plugins/, and operator plugins live in /etc/kestrel/plugins/.

See docs/developer/plugin-development.md in the repository for the plugin API and the Plugin base class in kestrel_pi/plugins.py.

Run the tests with pytest from this directory.

Metadata

Release files for kestrel-pi 1.0.0

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

Source distribution (sdist)

Source distribution for kestrel-pi 1.0.0
File Size Uploaded Provenance
kestrel_pi-1.0.0.tar.gz 269.6 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for kestrel-pi 1.0.0
File Interpreter ABI Platform
kestrel_pi-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 450.4 kB

Release files / kestrel_pi-1.0.0.tar.gz

Download URL kestrel_pi-1.0.0.tar.gz
Size 269.6 kB
Tags Source
SHA-256 checksum
How to use checksums
04937562b43649bfc4a06cbc18aebf1899d5a28df82a79363b8dafd30cde9fa1
BLAKE2b-256 checksum
How to use checksums
18a811f69c4f3a2bf415c54e96b2fde576379c1213fabc7a484914bd7127e712
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / kestrel_pi-1.0.0-py3-none-any.whl

Download URL kestrel_pi-1.0.0-py3-none-any.whl
Size 180.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cd06642bad4c133f4e5276cca7a23ad468fcd803e3e08f6f104e832cbaa6a58b
BLAKE2b-256 checksum
How to use checksums
bf2515c0a65caca8337be571aae93636ef0cf8152c72785e096021dce451bd70
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for kestrel-pi 1.0.0

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.

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