explaingit

pedroxns/my-koleos-ha-latam

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A reverse engineered Home Assistant integration that lets you control and track a Renault Koleos car through the same backend as Renault's My Koleos app.

Mindmap

mindmap
  root((my-koleos-ha-latam))
    What it does
      Connects Koleos to Home Assistant
      Reads car location
      Remote climate control
      Reverse engineered API
    Tech stack
      Python
      Home Assistant
      HACS
    Use cases
      Smart home automation
      Remote AC control
      Location tracking
    Audience
      Renault Koleos owners
      LATAM Home Assistant users
    Notes
      Experimental commands
      Use at own risk

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add your Renault Koleos car as a device in Home Assistant to see its location alongside your other smart home devices.

USE CASE 2

Start or stop the car's climate control remotely for a set duration and temperature from a Home Assistant automation.

USE CASE 3

Track version-by-version fixes to how the integration talks to Renault's backend, since the API was reverse engineered rather than officially documented.

USE CASE 4

Install and update the integration easily through HACS instead of manually copying files.

What is it built with?

PythonHome AssistantHACS

How does it compare?

pedroxns/my-koleos-ha-latam0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Renault Koleos E-Tech LATAM vehicle and a Renault My Koleos account login through a manual URL-copy authentication step.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

This project is a custom Home Assistant integration that connects the Renault Koleos, specifically the E-Tech version sold in Brazil and Latin America, to your smart home setup through the Renault My Koleos mobile app's backend. The README explains plainly that there was no official way to do this, so the author reverse engineered the Android app with heavy help from AI tools, and warns that it should be used at your own risk. To set it up, you install the integration in Home Assistant, restart, then follow a login flow through Renault's own authentication page: you sign in with your email and password, the browser URL changes after login, and you copy that new URL back into the integration to finish connecting. Once connected, all the created entities follow a consistent naming pattern starting with renault_koleos. The integration can read the car's location, using the same coordinate scale as the official app, and it supports experimental remote commands, most notably starting and stopping the climate control for a set number of minutes at a chosen temperature, which the author confirms has been tested on a real vehicle. These remote commands depend on Renault's cloud service being available, so they may not always work. Climate commands are not treated as sensitive by default, even though they physically turn on the car, while lock, unlock, and remote start commands stay behind a separate sensitive commands setting that must be enabled deliberately. The README's version history shows the integration has been actively patched, including a fix to how location coordinates are decoded and a correction to how the climate control commands are sent to Renault's servers. Installation is done through HACS, the Home Assistant Community Store, by adding this GitHub repository as a custom integration source. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through installing this Home Assistant integration via HACS and completing the Renault login flow.
Prompt 2
Write a Home Assistant automation that turns on my car's climate control for 10 minutes at 22 degrees when I leave for work.
Prompt 3
Explain the risk of using a reverse engineered vehicle integration like this compared to an official manufacturer app.
Prompt 4
What is the difference between the sensitive commands option and the regular climate control service in this integration?

Frequently asked questions

What is my-koleos-ha-latam?

A reverse engineered Home Assistant integration that lets you control and track a Renault Koleos car through the same backend as Renault's My Koleos app.

What language is my-koleos-ha-latam written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

What license does my-koleos-ha-latam use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is my-koleos-ha-latam to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is my-koleos-ha-latam for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.