This release is a pre-release and may not be stable for production use.
PyMammotion - Python API for Mammotion Mowers 
PyMammotion is a Python API for controlling and monitoring Mammotion devices (Luba, Yuka, spino etc) via MQTT, Cloud, and Bluetooth.
[!WARNING] Use at your own risk. Mammotion's Terms of Service prohibit unofficial API access. Using this library may result in a permanent ban of your Mammotion account. The authors are not responsible for any consequences, including loss of access to your device or account.
⚠️ Please note: This API is still under active development. You may encounter unfinished features or bugs. If you come across any issues, please open an issue on the GitHub repository. 🐛
Home Assistant Integration
This library is the foundation for the Mammotion Home Assistant integration. If you're looking to control your Mammotion mower through Home Assistant, check out the integration repository for installation and setup instructions.
Installation 🛠️
You can install PyMammotion using pip:
pip install pymammotion
Development 🔧
PyMammotion uses betterproto2 and protoc for generating protobuf models. To set up the development environment:
- Clone the repository
- poetry install --with=dev
- Profit
Contributing 🤝
Contributions are welcome! Please check the issues for ways you can help improve PyMammotion.
Troubleshooting 🔍
If you encounter any issues:
- Check the wiki for known issues and solutions
- Ensure you're using the latest version of PyMammotion
- If the problem persists, please open an issue on GitHub
Credits 👥
License 📄
This project is licensed under the MIT License - see the LICENSE file for details.
Trademark Notice
The trademarks "Mammotion," "Luba,", "Yuka" and "Spino" referenced herein are registered trademarks of their respective owners. The author of this software repository is not affiliated with, endorsed by, or connected to these trademark owners in any way.
1 maintainer
Release files for pymammotion 0.9.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pymammotion-0.9.0b1.tar.gz | 468.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pymammotion-0.9.0b1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.0 MB
Release files / pymammotion-0.9.0b1.tar.gz
| Download URL | pymammotion-0.9.0b1.tar.gz |
|---|---|
| Size | 468.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
756809f8b1093f291debff3c3149468a8d4ab95f1e766505000d0dd39613fc39
|
|
BLAKE2b-256 checksum How to use checksums |
773bca7236c616675c8e8fb08c53cf574e2b29baa69a549c6c7064b893dd4c41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 7, 2026.
Transparency logRelease files / pymammotion-0.9.0b1-py3-none-any.whl
| Download URL | pymammotion-0.9.0b1-py3-none-any.whl |
|---|---|
| Size | 545.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2100feccac55f6e023d55747e04665d46862e1f1f728d5f8670d2b40afd700c9
|
|
BLAKE2b-256 checksum How to use checksums |
4b9cbb937c1000b0a15d9395dce9917812b979fc3ca14a3e1871c72e92a1debf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 7, 2026.
Transparency log
