{"id":16961872,"url":"https://github.com/xknx/xknx","last_synced_at":"2026-01-16T03:36:19.811Z","repository":{"id":37731284,"uuid":"51259458","full_name":"XKNX/xknx","owner":"XKNX","description":"XKNX - A KNX library written in Python","archived":false,"fork":false,"pushed_at":"2025-05-02T11:15:46.000Z","size":6848,"stargazers_count":305,"open_issues_count":17,"forks_count":114,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-05-08T05:27:43.386Z","etag":null,"topics":["hacktoberfest","home-assistant","home-automation","knx","python"],"latest_commit_sha":null,"homepage":"http://xknx.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/XKNX.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"XKNX","open_collective":"xknx"}},"created_at":"2016-02-07T18:29:39.000Z","updated_at":"2025-05-02T11:15:50.000Z","dependencies_parsed_at":"2023-09-22T02:17:55.816Z","dependency_job_id":"b6673090-e964-48b0-817d-0249bc7aca31","html_url":"https://github.com/XKNX/xknx","commit_stats":{"total_commits":2367,"total_committers":75,"mean_commits":31.56,"dds":0.7013096746937051,"last_synced_commit":"9c2d71712639140b02a3e1522ca00d2fb966fbb3"},"previous_names":[],"tags_count":133,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XKNX%2Fxknx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XKNX%2Fxknx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XKNX%2Fxknx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XKNX%2Fxknx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XKNX","download_url":"https://codeload.github.com/XKNX/xknx/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254040419,"owners_count":22004534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["hacktoberfest","home-assistant","home-automation","knx","python"],"created_at":"2024-10-13T23:04:29.330Z","updated_at":"2026-01-16T03:36:19.780Z","avatar_url":"https://github.com/XKNX.png","language":"Python","funding_links":["https://github.com/sponsors/XKNX","https://opencollective.com/xknx"],"categories":[],"sub_categories":[],"readme":"# XKNX - An asynchronous KNX library written in Python\n\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/xknx?logo=python)\n[![codecov](https://codecov.io/gh/XKNX/xknx/branch/main/graph/badge.svg?token=irWbIygS84)](https://codecov.io/gh/XKNX/xknx)\n[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)\n[![Pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=f8b424)](https://github.com/pre-commit/pre-commit)\n[![HA integration usage](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fanalytics.home-assistant.io%2Fcurrent_data.json\u0026query=%24.integrations.knx\u0026logo=home-assistant\u0026label=integration%20usage\u0026color=41BDF5\u0026cacheSeconds=21600)](https://www.home-assistant.io/integrations/knx/)\n[![Discord](https://img.shields.io/discord/338619021215924227?color=7289da\u0026label=Discord\u0026logo=discord\u0026logoColor=7289da)](https://discord.gg/bkZe9m4zvw)\n\n## Documentation\n\nSee documentation at: [https://xknx.io/](https://xknx.io/)\n\n## Help\n\nWe need your help for testing and improving XKNX. For questions, feature requests, bug reports either open an [issue](https://github.com/XKNX/xknx/issues), join the [XKNX chat on Discord](https://discord.gg/EuAQDXU) or write an [email](mailto:xknx@xknx.io).\n\n## Development\n\nYou will need at least Python 3.10 in order to use XKNX.\n\nSetting up your local environment:\n\n1. Install requirements: `pip install -r requirements/testing.txt`\n2. Install pre-commit hook: `pre-commit install`\n\n## Testing\n\nTo run all tests, linters, formatters and type checker call `tox`\n\nRunning only unit tests is possible with `pytest`\nRunning specific unit tests can be invoked by: `pytest -vv test/management_tests/procedures_test.py -k test_nm_individual_address_serial_number_write_fail`\n\n## Home-Assistant\n\nXKNX is the underlying library for the KNX integration in [Home Assistant](https://home-assistant.io/).\n\n## Example\n\n```python\n\"\"\"Example for switching a light on and off.\"\"\"\nimport asyncio\n\nfrom xknx import XKNX\nfrom xknx.devices import Light\n\n\nasync def main():\n    \"\"\"Connect to KNX/IP bus, switch on light, wait 2 seconds and switch it off again.\"\"\"\n    async with XKNX() as xknx:\n        light = Light(\n            xknx,\n            name='TestLight',\n            group_address_switch='1/0/9',\n        )\n        xknx.devices.async_add(light)\n\n        await light.set_on()\n        await asyncio.sleep(2)\n        await light.set_off()\n\nasyncio.run(main())\n```\n\n## Attributions\n\nMany thanks to [Weinzierl Engineering GmbH](https://weinzierl.de) and [MDT technologies GmbH](https://www.mdt.de) for providing us each an IP Secure Router to support testing and development of xknx.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxknx%2Fxknx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxknx%2Fxknx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxknx%2Fxknx/lists"}