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 0.7.8

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 0.7.8
File Size Uploaded Provenance
kestrel_pi-0.7.8.tar.gz 269.7 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 450.5 kB

Release files / kestrel_pi-0.7.8.tar.gz

Download URL kestrel_pi-0.7.8.tar.gz
Size 269.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8cb5a69d2a149fd37671b84f01fa3de10c95c01d56e0fb0dc802267bbdf2dc04
BLAKE2b-256 checksum
How to use checksums
694203306d4914ee300e02ae8cdb3d7d076d16bdd5b48202a7f19167d7c5ee57
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-0.7.8-py3-none-any.whl

Download URL kestrel_pi-0.7.8-py3-none-any.whl
Size 180.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0151739a1487621c7f35e0b730dc28ab7282a783437b479a841b044c345cf77a
BLAKE2b-256 checksum
How to use checksums
8dccee5696d839ae923dcb3329b109b3cd3a503a7bf02c776925781b9d2285bd
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 0.7.8

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