renault-api

What it is and what it does

Renault API is a Python client for Renault's private MyRenault API that retrieves real-time vehicle telemetry and controls. It reads mileage, GPS location, battery autonomy for electric vehicles, fuel autonomy for fuel vehicles, and associated contracts (warranty, connected services). For compatible vehicles, it also manages HVAC pre-conditioning and charge scheduling. The client uses async/await throughout and handles authentication via Gigya login tokens, allowing you to avoid storing passwords by persisting and reusing the token instead.

The package is designed primarily for Home Assistant integration but works as a standalone Python library. It wraps HTTP communication with aiohttp, uses PyJWT for token handling, and marshmallow-dataclass for response deserialization. All three runtime dependencies are lightweight and widely used.

Use it for:

• Retrieve current mileage and GPS location from a Renault vehicle for fleet tracking or personal monitoring.
• Check battery status and autonomy of an electric Renault vehicle to plan charging or trips.
• Automate HVAC pre-conditioning or charge scheduling for compatible Renault EVs via a home automation system.
• Build a Home Assistant integration to display Renault vehicle status and control features in a smart home dashboard.
• Fetch warranty and connected services contract details associated with a Renault account.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Communicates with Renault's private API to read vehicle attributes like mileage, GPS location, battery/fuel autonomy, and manage HVAC and charge schedules for supported vehicles.

Yes, if you own a supported Renault vehicle and need programmatic access to its telemetry and controls. The package is actively maintained, has no known vulnerabilities, uses permissive MIT licensing, and integrates well with Home Assistant. The main risk is API compatibility—Renault may change or restrict their private API at any time, and this project is not affiliated with Renault. Verify your vehicle model is supported before committing to it as a critical dependency.

Install

renault-api on PyPI

pip install renault-api

uv add renault-api

poetry add renault-api

Installing renault-api

Before you install

Low friction installation with a pure Python wheel and three lightweight runtime dependencies. The package is actively maintained with a recent release and no known vulnerabilities.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for both personal and commercial projects.

Quickstart

pip install renault-api

import aiohttp
import asyncio
from renault_api.renault_client import RenaultClient

async def main():
    async with aiohttp.ClientSession() as websession:
        client = RenaultClient(websession=websession, locale="fr_FR")
        await client.session.login('email', 'password')
        person = await client.get_person()
        print(f"Accounts: {person}")

asyncio.run(main())

Requires Python >= 3.10; async/await pattern mandatory; valid Renault MyRenault credentials required.

Verify before relying

• Whether the package works with all Renault vehicle models or only specific generations/markets.
• Rate limiting or throttling behavior when polling vehicle data frequently.
• Whether Renault API changes or account lockouts could break the client without warning.

Package facts

Evidence: renault_api-0.5.12-py3-none-any.whl

Tags

More WWW/HTTP packages