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

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

Built distribution (wheel)

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

Total release size: 446.1 kB

Release files / kestrel_pi-0.7.7.tar.gz

Download URL kestrel_pi-0.7.7.tar.gz
Size 266.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f5aac24ccceea9d7222ad061ae70743a0383c3afc671c3dfa3e8281ede101bf6
BLAKE2b-256 checksum
How to use checksums
c9454b57afb769a89351203c4097854e776a4076d4d372b59efa6d73dac5976a
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.7-py3-none-any.whl

Download URL kestrel_pi-0.7.7-py3-none-any.whl
Size 179.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2b860c9604ab9ace6d112ee8af2b29c79583f70135a57323af5bb4842d823121
BLAKE2b-256 checksum
How to use checksums
296c312cde4c9b0798721a6d27c4a00e51c4f4bbc0ae254dc643dc728b4b4e87
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.7

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