Python side channel agent for Shaken Fist
This is the in-guest side channel agent for Shaken Fist. It runs inside virtual machines and provides a vsock-based interface for the hypervisor to execute commands, transfer files, and gather system information.
Documentation
- docs/index.md -- overview and feature summary
- docs/protocol.md -- protobuf protocol reference
- docs/developer-guide.md -- building, testing, and extending the agent
Quick Start
pip install shakenfist-agent
sf-agent daemon run
Development
# Run unit tests
tox -epy3
# Run linter
tox -eflake8
# Generate coverage report
tox -ecover
See ARCHITECTURE.md for the project structure and AGENTS.md for AI agent guidance.
1 maintainer
Release files for shakenfist-agent 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| shakenfist_agent-1.0.1.tar.gz | 40.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| shakenfist_agent-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 66.0 kB
Release files / shakenfist_agent-1.0.1.tar.gz
| Download URL | shakenfist_agent-1.0.1.tar.gz |
|---|---|
| Size | 40.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c28b4418d4c26ae64158af283f4835a71e08d609af3729d85a6a866340e4ab89
|
|
BLAKE2b-256 checksum How to use checksums |
339b08a8802b10bee2bfe8f1f8df38b34690542dedbfaba96dab1e63e2234528
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.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.
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 Apr 1, 2026.
Transparency logRelease files / shakenfist_agent-1.0.1-py3-none-any.whl
| Download URL | shakenfist_agent-1.0.1-py3-none-any.whl |
|---|---|
| Size | 26.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
36127d4b54072f8811bf9c2154e523837f2a8dd721bf41ade7d6040f3260e922
|
|
BLAKE2b-256 checksum How to use checksums |
2b77a96b8c03417759175a9ce1992076106ec3d316b4afa6c874e613d2c62e8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.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.
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 Apr 1, 2026.
Transparency log
