Python Tesla Wall Connector API

Python Tesla Wall Connector API for local consumption. This package allows you to monitor your 3rd generation Tesla Wall Connector programmatically. It is mainly created to enable integration with Home Assistant and therefore exposes an asynchronous API.

Usage

import asyncio
from tesla_wall_connector import WallConnector
async def main():
    async with WallConnector('TeslaWallConnector_ABC123.localdomain') as wall_connector:
        lifetime = await wall_connector.async_get_lifetime()
        print("energy_wh: {}Wh".format(lifetime.energy_wh))

asyncio.run(main())

Setting up development environment

This Python project is managed using uv, with project metadata defined in pyproject.toml.

You need at least:

• Python 3.11+
• uv

To install all packages, including all development requirements:

uv sync

Then install the Git hook once for this clone:

uv run pre-commit install --install-hooks

As this repository uses the pre-commit framework, all changes are linted and tested with each commit. You can run all checks and tests manually, using the following command:

uv run pre-commit run --all-files

To run Ruff directly:

uv run ruff check .
uv run ruff format --check .

To run Pyright directly:

uv run pyright

To run the Python tests:

uv run pytest