MCPcopy Index your code
hub / github.com/OStrama/judo_rest_api

github.com/OStrama/judo_rest_api @1.0.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release 1.0.4 ↗ · + Follow
98 symbols 313 edges 16 files 95 documented · 97% updated 10mo ago1.0.4 · 2025-08-31★ 3811 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Version 1.0.3

Added control for changing salt mass. The control shows the current salt mass. When refilling, the mass that was refilled has to be added to the shown mass.

judo_rest_api

Home Assistant integration to connect to judo water treatment directly via REST API based on this documentation: https://judo.eu/app/uploads/2024/11/API-KOMMANDOZEILEN.pdf Some more basic info can be found here: https://judo.eu/app/downloads/files/de/8203521/manuals/1702574_202405.pdf

Please have a look here to learn more about the communication module that provides the REST API:

https://judo.eu/produkte/connectivity-modul-wlan/

Judo_rest_api

This integration lets you monitor and control your Judo water treatment device locally through it's REST API. image

Installation

HACS (manually add Repository)

Add this repository to HACS. * In the HACS GUI, select "Custom repositories" * Enter the following repository URL: https://github.com/OStrama/judo_rest_api * Category: Integration * After adding the integration, restart Home Assistant. * Now press the button "Add Integration" in Configuration -> Integrations to install it in Home assistant. * Now under Configuration -> Integrations, "Judo REST API" should be available.

Manual install

Create a directory called judo_rest_api in the <config directory>/custom_components/ directory on your Home Assistant instance. Install this component by copying all files in /custom_components/judo_rest_api/ folder from this repo into the new <config directory>/custom_components/judo_rest_api/ directory you just created.

This is how your custom_components directory should look like:

custom_components
├── judo_rest_api
│   ├── __init__.py
│   ├── ...
│   ├── ...
│   ├── ...
│   └── sensor.py  

Configuration

image

The only mandatory parameters are: * The IP-Address of your Judo water treatment device. The port should be ok at default (80) unless you changed it in the configuration of the connectivity module. * The user name. The default value of the connectivity module is "admin". You can change it on the web interface of the connectivity module * The password. The default value of the connectivity module is "Connectivity". You can change it on the web interface of the connectivity module

The "Device Postfix" has a default value of "". It can be used to add multiple devices to one home assistant. For compatibility this should be left empty. If you want to add another device, use a name that helps to identify the devices. The "Scan interval" determines how often the REST API is polled. The default value is every 60 seconds. Too small values will cause more timeouts.

Disclaimer

The developers of this integration are not affiliated with Judo. They have created the integration as open source in their spare time on the basis of publicly accessible information. The use of the integration is at the user's own risk and responsibility. The developers are not liable for any damages arising from the use of the integration.

More coming soon to this theater ;-)

Core symbols most depended-on inside this repo

build_entity_list
called by 8
custom_components/judo_rest_api/entity_helpers.py
set_rest
called by 5
custom_components/judo_rest_api/restobject.py
format_int_message
called by 4
custom_components/judo_rest_api/restobject.py
setvalue
called by 4
custom_components/judo_rest_api/restobject.py
get_rest
called by 3
custom_components/judo_rest_api/restobject.py
get_number_from_translation_key
called by 3
custom_components/judo_rest_api/items.py
get_value_from_item
called by 2
custom_components/judo_rest_api/coordinator.py
_cache_device_info
called by 2
custom_components/judo_rest_api/coordinator.py

Shape

Method 64
Class 20
Function 14

Languages

Python100%

Modules by API surface

custom_components/judo_rest_api/entities.py24 symbols
custom_components/judo_rest_api/items.py23 symbols
custom_components/judo_rest_api/restobject.py16 symbols
custom_components/judo_rest_api/coordinator.py10 symbols
custom_components/judo_rest_api/config_flow.py6 symbols
custom_components/judo_rest_api/const.py5 symbols
custom_components/judo_rest_api/__init__.py4 symbols
custom_components/judo_rest_api/judo_rest_test.py3 symbols
custom_components/judo_rest_api/switch.py1 symbols
custom_components/judo_rest_api/sensor.py1 symbols
custom_components/judo_rest_api/select.py1 symbols
custom_components/judo_rest_api/number.py1 symbols

For agents

$ claude mcp add judo_rest_api \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page