{"library":"nacos-sdk-python","title":"Nacos Python SDK","description":"Python client for Nacos, a dynamic service discovery, configuration, and service management platform. It currently supports Nacos server versions 3.x and Python 3.10+. The library maintains a regular release cadence, with version 3.0.4 being the latest stable release.","language":"python","status":"active","last_verified":"Thu May 14","install":{"commands":["pip install nacos-sdk-python"],"cli":null},"imports":["import nacos\nclient = nacos.NacosClient(...)","from v2.nacos import NacosConfigService, ClientConfigBuilder","from v2.nacos import NacosNamingService, ClientConfigBuilder"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nimport nacos\n\n# Configure Nacos server address and optional namespace/auth via environment variables\nSERVER_ADDRESSES = os.environ.get('NACOS_SERVER_ADDR', '127.0.0.1:8848')\nNAMESPACE_ID = os.environ.get('NACOS_NAMESPACE_ID', '') # e.g., 'public'\nACCESS_KEY = os.environ.get('NACOS_ACCESS_KEY', '')\nSECRET_KEY = os.environ.get('NACOS_SECRET_KEY', '')\n\n# Initialize Nacos Client\n# For production, ensure access_key and secret_key are provided for authentication.\nclient = nacos.NacosClient(\n    SERVER_ADDRESSES,\n    namespace=NAMESPACE_ID,\n    ak=ACCESS_KEY,\n    sk=SECRET_KEY\n)\n\n# --- Configuration Service Example ---\ndata_id = \"example_config\"\ngroup = \"DEFAULT_GROUP\"\n\n# Publish a configuration\nsuccess = client.publish_config(data_id, group, \"Hello from nacos-sdk-python!\")\nprint(f\"Published config: {success}\")\n\n# Get a configuration\nconfig_content = client.get_config(data_id, group)\nprint(f\"Retrieved config: {config_content}\")\n\n# --- Naming Service Example ---\nservice_name = \"example_service\"\nservice_ip = \"127.0.0.1\"\nservice_port = 8080\n\n# Register an instance\nregistered = client.add_naming_instance(service_name, service_ip, service_port)\nprint(f\"Registered service instance: {registered}\")\n\n# Query instances\ninstances = client.get_naming_instance(service_name, group_name=group)\nprint(f\"Discovered instances: {instances}\")\n\n# Deregister an instance\nderegistered = client.remove_naming_instance(service_name, service_ip, service_port)\nprint(f\"Deregistered service instance: {deregistered}\")\n","lang":"python","description":"This quickstart demonstrates how to initialize the `NacosClient` and perform basic configuration publishing/retrieval and service registration/discovery. It's recommended to configure Nacos server addresses, namespace, and authentication credentials via environment variables for flexible deployment. For Nacos server 3.x and above, ensure the Nacos server is running and accessible.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-14","installed_version":"2.0.11","pypi_latest":"3.2.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":60,"avg_install_s":19.3,"avg_import_s":0.18,"wheel_type":"sdist"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"105.5M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":18.1,"import_time_s":null,"mem_mb":null,"disk_size":"105M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"115.1M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":15,"import_time_s":null,"mem_mb":null,"disk_size":"114M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"103.9M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":23.9,"import_time_s":null,"mem_mb":null,"disk_size":"103M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"103.7M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":21.1,"import_time_s":null,"mem_mb":null,"disk_size":"103M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.17,"mem_mb":5.6,"disk_size":"94.1M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.19,"mem_mb":5.6,"disk_size":"94.1M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":18.3,"import_time_s":0.14,"mem_mb":5.4,"disk_size":"94M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"nacos-sdk-python","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.23,"mem_mb":5.4,"disk_size":"94M"}]}}