This release is a pre-release and may not be stable for production use.
cremalink
A high-performance Python library and local API server for monitoring and controlling IoT coffee machines.
✨ Overview
Cremalink provides a unified interface to interact with smart coffee machines via Local LAN control or Cloud API. It allows for real-time state monitoring and precise command execution.
[!TIP] For detailed guides, advanced configuration, and developer deep-dives, please visit our Project Wiki.
[!NOTE] This project was developed with a result-oriented approach, primarily optimized for the De'Longhi PrimaDonna Soul. While the architecture is designed to be extensible, some logic may currently be tightly coupled to this specific model and might not work seamlessly with others yet. The goal is to make the library fully generic. If you notice parts that are too specific to the PrimaDonna Soul or encounter issues with other machines, we highly encourage contributions! Refactoring and generalizations are very welcome to improve support for a wider range of devices.
🚀 Installation
Install the package via pip (Cremalink requires Python 3.13+):
pip install cremalink
Optional Dependencies
To include tools for development or testing:
pip install "cremalink[dev]" # For notebooks and kernel support
pip install "cremalink[test]" # For running pytest suites
🛠 Usage
Integrated API Server
Cremalink includes a FastAPI-based server for headless environments:
# Start the server
cremalink-server --ip 0.0.0.0 --port 10280 --settings_path "conf.json"
More information: Local Server Setup
Python API (Local Control)
Connect to your machine directly via your local network for the lowest latency.
More information: Local Device Usage
🛠 Development
Testing
Run the comprehensive test suite using pytest:
pytest tests/
Contributing
Contributions are welcome! If you have a machine profile not yet supported, please check the Wiki: 5. Adding Custom Devices on how to add new .json device definitions.
Currently supported devices:
De'Longhi PrimaDonna Soul (ECAM612)De'Longhi Eletta Explore (ECAM452) (not tested yet)
☕ Credits
This project stands on the shoulders of giants. The reverse engineering and implementation is a community effort. A special thanks to the following projects and individuals for their pioneering work and documentation:
Technical Foundations, Protocol Research & Inspiration
- ECAMpy
- delonghi-comfort-client
- Hacking Bluetooth to Brew Coffee
- delonghi-coffee-link-python
- DlghIoT
- home_assistant_delonghi_primadonna
- longshot
Is a project missing or do you have suggestions for improvement? Feel free to open a PR or an issue!
💫 Star History
📄 License
Distributed under the AGPL-3.0-or-later License. See LICENSE for more information.
Developed by Midian Tekle Elfu. Supported by the community.
1 maintainer
Metadata
1 maintainer
Release files for cremalink 0.1.0b28
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cremalink-0.1.0b28.tar.gz | 511.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cremalink-0.1.0b28-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 591.9 kB
Release files / cremalink-0.1.0b28.tar.gz
| Download URL | cremalink-0.1.0b28.tar.gz |
|---|---|
| Size | 511.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4c2fef8d4e6afbbf31aff09defc842bc7b50e9edfeceb98db11b45e42e398953
|
|
BLAKE2b-256 checksum How to use checksums |
80dbd4ec84233badc237673744c2d665fdc0cafcb2c4e0e3b5a429bef3ea39ff
|
| 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 4, 2026.
Transparency logRelease files / cremalink-0.1.0b28-py3-none-any.whl
| Download URL | cremalink-0.1.0b28-py3-none-any.whl |
|---|---|
| Size | 80.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
58a2e244c47e526285f496f903c298f06228df89b8339e14a5ad99658da55ffd
|
|
BLAKE2b-256 checksum How to use checksums |
b53b437314f4f5173a24ce678759cdfddcc72eee5b80d49b875e84e20d8776a2
|
| 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 4, 2026.
Transparency log
