{"id":21825,"library":"python-matter-server","title":"Python Matter Server","description":"Python-based server for interacting with Matter smart home devices, part of the Open Home Foundation ecosystem. Current version 8.1.2, requires Python >=3.12. Rapid development with frequent breaking changes.","status":"active","version":"8.1.2","language":"python","source_language":"en","source_url":"https://github.com/home-assistant-libs/python-matter-server","tags":["matter","smarthome","iot","home-assistant"],"install":[{"cmd":"pip install python-matter-server","lang":"bash","label":"pip"}],"dependencies":[],"imports":[{"note":"Incorrect module path; the package's import prefix is 'matter_server' not 'python_matter_server'.","wrong":"from python_matter_server import MatterServer","symbol":"MatterServer","correct":"from matter_server.server import MatterServer"},{"note":"","wrong":"","symbol":"MatterClient","correct":"from matter_server.client import MatterClient"}],"quickstart":{"code":"import asyncio\nfrom matter_server.client import MatterClient\n\nasync def main():\n    client = MatterClient(\"ws://localhost:5580/ws\", \"\")\n    await client.connect()\n    nodes = await client.get_nodes()\n    print(nodes)\n\nasyncio.run(main())","lang":"python","description":"Connects to a local Matter Server instance and fetches all nodes. Requires a running Matter Server (e.g., via pip install python-matter-server and running matter-server)."},"warnings":[{"fix":"Use 'from matter_server.server import MatterServer' instead of 'from matter_server import MatterServer'.","message":"Breaking change in v7: 'MatterServer' class moved from 'matter_server' to 'matter_server.server'. Update imports.","severity":"breaking","affected_versions":">=7.0.0"},{"fix":"Ensure client passes an auth token (or empty string) when connecting via WebSocket.","message":"In v8, the WebSocket protocol changed: authentication now requires a token or empty string. Old versions used a different handshake.","severity":"breaking","affected_versions":">=8.0.0"},{"fix":"Upgrade Python to 3.12 or later.","message":"Python 3.11 and lower are no longer supported. Requires Python >=3.12.","severity":"breaking","affected_versions":">=8.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install python-matter-server'.","cause":"Package not installed.","error":"ModuleNotFoundError: No module named 'matter_server'"},{"fix":"Use 'from matter_server.server import MatterServer'.","cause":"MatterServer was moved to matter_server.server in v7.","error":"from matter_server import MatterServer -> ImportError: cannot import name 'MatterServer' from 'matter_server'"},{"fix":"Use MatterClient(server_url, auth_token) constructor directly.","cause":"Incorrect instantiation pattern (old API).","error":"TypeError: Client() missing required 'server_info' argument"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}