{"id":35452825,"url":"https://github.com/miditkl/cremalink","last_synced_at":"2026-02-13T01:52:15.306Z","repository":{"id":331390841,"uuid":"1126444475","full_name":"miditkl/cremalink","owner":"miditkl","description":"Python bridge for local and cloud connectivity to compatible coffee machines.","archived":false,"fork":false,"pushed_at":"2026-01-18T22:16:17.000Z","size":9098,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-19T02:26:58.038Z","etag":null,"topics":["api","automation","cloud","coffee","coffeemachine","cremalink","delonghi","iot","lan","local","primadonna","soul"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/miditkl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T23:29:39.000Z","updated_at":"2026-01-18T22:14:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/miditkl/cremalink","commit_stats":null,"previous_names":["miditkl/cremalink"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/miditkl/cremalink","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miditkl%2Fcremalink","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miditkl%2Fcremalink/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miditkl%2Fcremalink/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miditkl%2Fcremalink/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miditkl","download_url":"https://codeload.github.com/miditkl/cremalink/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miditkl%2Fcremalink/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28740387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T22:12:27.248Z","status":"ssl_error","status_checked_at":"2026-01-24T22:12:10.529Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","automation","cloud","coffee","coffeemachine","cremalink","delonghi","iot","lan","local","primadonna","soul"],"created_at":"2026-01-03T04:09:01.418Z","updated_at":"2026-02-13T01:52:15.299Z","avatar_url":"https://github.com/miditkl.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"docs/source/cremalink.png\" alt=\"Cremalink Logo\" height=\"45\" style=\"vertical-align: middle; margin-right: 10px;\"\u003e cremalink\n\n**A high-performance Python library and local API server for monitoring and controlling IoT coffee machines.**\n\n[![PyPI version](https://img.shields.io/pypi/v/cremalink.svg?style=for-the-badge\u0026color=blue)](https://pypi.org/project/cremalink/)\n[![Python Version](https://img.shields.io/pypi/pyversions/cremalink.svg?style=for-the-badge\u0026color=FFE169\u0026labelColor=3776AB)](https://pypi.org/project/cremalink/)\n[![License](https://img.shields.io/github/license/miditkl/cremalink?style=for-the-badge\u0026color=success)](LICENSE)\n[![Downloads](https://img.shields.io/pypi/dm/cremalink.svg?style=for-the-badge\u0026color=orange)](https://pypi.org/project/cremalink/)\n[![Source Code](https://img.shields.io/badge/Source-GitHub-black?style=for-the-badge\u0026logo=github)](https://github.com/miditkl/cremalink)\n\n---\n\n## ✨ Overview\n\nCremalink 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.\n\n\u003e [!TIP]\n\u003e For detailed guides, advanced configuration, and developer deep-dives, please visit our **[Project Wiki](https://github.com/miditkl/cremalink/wiki)**.\n\n\u003e [!NOTE] \n\u003e 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.\n\u003eThe 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.\n\n---\n\n## 🚀 Installation\n\nInstall the package via `pip` (Cremalink requires **Python 3.13+**):\n\n```bash\npip install cremalink\n\n```\n\n### Optional Dependencies\n\nTo include tools for development or testing:\n\n```bash\npip install \"cremalink[dev]\"   # For notebooks and kernel support\npip install \"cremalink[test]\"  # For running pytest suites\n\n```\n\n---\n\n## 🛠 Usage\n\n### Integrated API Server\n\nCremalink includes a FastAPI-based server for headless environments:\n\n```bash\n# Start the server\ncremalink-server --ip 0.0.0.0 --port 10280 --settings_path \"conf.json\"\n```\n\u003e More information: [Local Server Setup](https://github.com/miditkl/cremalink/wiki/3.-Local-Server-Setup)\n\n### Python API (Local Control)\n\nConnect to your machine directly via your local network for the lowest latency.\n\n\u003e More information: [Local Device Usage](https://github.com/miditkl/cremalink/wiki/4.-Local-Device-Usage)\n\n---\n\n## 🛠 Development\n\n### Testing\n\nRun the comprehensive test suite using `pytest`:\n\n```bash\npytest tests/\n\n```\n\n### Contributing\n\nContributions are welcome! If you have a machine profile not yet supported, please check the [Wiki: 5. Adding Custom Devices](https://github.com/miditkl/cremalink/wiki/) on how to add new `.json` device definitions.\n\nCurrently supported devices:\n\n- `De'Longhi PrimaDonna Soul (ECAM612)`\n- `De'Longhi Eletta Explore (ECAM452) (not tested yet)`\n---\n\n## ☕ Credits\n\nThis 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:\n\n### Technical Foundations, Protocol Research \u0026 Inspiration\n* **[ECAMpy](https://github.com/duckwc/ECAMpy)**\n* **[delonghi-comfort-client](https://github.com/rtfpessoa/delonghi-comfort-client)**\n* **[Hacking Bluetooth to Brew Coffee](https://grack.com/blog/2022/12/02/hacking-bluetooth-to-brew-coffee-on-github-actions-part-2/)**\n* **[delonghi-coffee-link-python](https://github.com/otto-dev/delonghi-coffee-link-python.git)**\n* **[DlghIoT](https://framagit.org/mattgk/dlghiot)**\n* **[home_assistant_delonghi_primadonna](https://github.com/Arbuzov/home_assistant_delonghi_primadonna)**\n* **[longshot](https://github.com/mmastrac/longshot)**\n\n*Is a project missing or do you have suggestions for improvement? Feel free to open a PR or an issue!*\n\n---\n\n## 📄 License\n\nDistributed under the **AGPL-3.0-or-later** License. See `LICENSE` for more information.\n\n---\n\n*Developed by [Midian Tekle Elfu](mailto:developer@midian.tekleelfu.de). Supported by the community.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiditkl%2Fcremalink","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiditkl%2Fcremalink","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiditkl%2Fcremalink/lists"}