nacos-sdk-python

What it is and what it does

nacos-sdk-python is a Python 3.10+ client for Nacos service platform, implementing the full OpenAPI surface for service discovery, configuration management, and AI-driven features. It uses gRPC as the primary transport with HTTP fallback, built on async primitives like aiohttp and aiofiles for non-blocking I/O.

The library handles service registration and deregistration, instance health tracking, configuration publishing and listening, and optional KMS encryption for sensitive data. It includes local failover and snapshot caching for resilience, TLS support, and a fluent ClientConfigBuilder for setup. Most operations are async coroutines, so it integrates naturally into async Python applications but requires an event loop context.

Use it for:

• Register microservices and query service instances for client-side load balancing in distributed systems.
• Centrally manage application configuration with push-based listener callbacks when values change.
• Implement service health checks and instance metadata tracking for dynamic service mesh routing.
• Fetch and subscribe to AI prompts and skills from Nacos AI service (requires server 3.1.0+).
• Encrypt sensitive configuration values using KMS integration for compliance.
• Build multi-region or multi-cluster service registries with namespace isolation and custom grouping.

Worth the install?

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

Python client library for Nacos service discovery, configuration management, and AI services via OpenAPI, supporting gRPC and HTTP protocols with async/await.

Yes, if you are using Nacos 3.x and need a Python client for service discovery or configuration management. The library is actively maintained, has no known vulnerabilities, and low install friction. Requires Python 3.10+ and an async-capable application context; not suitable for synchronous-only codebases or older Nacos versions.

Install

nacos-sdk-python on PyPI

pip install nacos-sdk-python

uv add nacos-sdk-python

poetry add nacos-sdk-python

Installing nacos-sdk-python

Before you install

Low install friction with a pure-Python wheel. Active maintenance with recent commits (2026-07-30) and no known vulnerabilities. Requires Python 3.10+.

License in practice

Apache License 2.0 (permissive) allows commercial use, modification, and distribution with minimal restrictions.

Quickstart

pip install nacos-sdk-python

import asyncio
from nacos_sdk_python import NacosConfigService, ClientConfigBuilder

async def main():
    client_config = (ClientConfigBuilder()
        .server_address('localhost:8848')
        .build())
    config_client = await NacosConfigService.create_config_service(client_config)

Requires Python 3.10 or later; Nacos server 3.x required (AI features need 3.1.0+); async/await usage requires an event loop.

Verify before relying

• Performance characteristics under high-volume service registration/discovery workloads
• Compatibility matrix with specific Nacos server minor versions beyond 3.x
• Failover behavior and consistency guarantees across multi-server deployments

Package facts

Evidence: nacos_sdk_python-3.2.0-py3-none-any.whl

Keywords: nacos, nacos-sdk-python

Tags

More Python Modules packages