PumaGuard
Introduction
Please visit http://pumaguard.rtfd.io/ for more information.
Get PumaGuard
GitHub Codespaces
If you do not want to install any new software on your computer you can use GitHub Codespaces, which provide a development environment in your browser.
Local Development Environment
A local development environment can be created by using the poetry tool,
which can be installed with
sudo apt install python3-poetry
Run
poetry install
To install all of the necessary Python modules.
Running the scripts on colab.research.google.com
Google Colab offers runtimes with GPUs and TPUs, which make training a model much faster. In order to run the training script in Google Colab, do the following from the terminal:
git clone https://github.com/PEEC-Nature-Youth-Group/pumaguard.git
cd pumaguard
scripts/train.py --help
For example, if you want to train the model from row 1 in the notebook,
scripts/train.py --notebook 1
Running the server
The pumaguard-server watches a folder and classifies new files as they are
added to that folder. Run with
poetry run pumaguard-server FOLDER
Where FOLDER is the folder to watch.
Training new models
For reproducibility, training new models should be done via the train script and all necessary data, i.e. images, and the resulting weights and history should be committed to the repository.
-
Get a TPU instance on Colab or run the script on your local machine.
-
Open a terminal and run
git clone https://github.com/PEEC-Nature-Youth-Group/pumaguard.git cd pumaguard
-
Get help on how to use the script
On Colab, run
./scripts/pumaguard --help ./scripts/pumaguard train --help
On your local machine, run
sudo apt install nvidia-cudnn poetry install poetry run pumaguard --help poetry run pumaguard train --help
-
Train the model from scratch
./scripts/pumaguard train --no-load --settings pumaguard-models/model_settings_6_pre-trained_512_512.yaml
1 maintainer
Metadata
1 maintainer
Release files for pumaguard 20.post25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pumaguard-20.post25.tar.gz | 156.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pumaguard-20.post25-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 321.8 kB
Release files / pumaguard-20.post25.tar.gz
| Download URL | pumaguard-20.post25.tar.gz |
|---|---|
| Size | 156.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e63383168bfb652e967d5eaa0b685900495845c593b8c590faacd187c574f709
|
|
BLAKE2b-256 checksum How to use checksums |
e97e2d1d4e0d5af20ca5bcdae972884e06ae2aa64901edad036d1cdd0a444079
|
| 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 Nov 4, 2025.
Transparency logRelease files / pumaguard-20.post25-py3-none-any.whl
| Download URL | pumaguard-20.post25-py3-none-any.whl |
|---|---|
| Size | 164.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a57a7a463f2edd52bfb1068b240a03717b5b1b6c168633aa7fc8808d9aa6dc88
|
|
BLAKE2b-256 checksum How to use checksums |
dbe723a5fcd25429933f8f1315e33dac6f847acac778ed189c4aafbe53c35e35
|
| 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 Nov 4, 2025.
Transparency log
