---
id: nacos-sdk-python
version: "3.2.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# nacos-sdk-python — Python client for Nacos.

License: permissive · Maintenance: active · Downloads: 503.2K/mo

## 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 above — 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

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

- License: Apache License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 503.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

nacos service discovery python, nacos configuration management client, service registry python, distributed config management, nacos grpc client, service mesh python sdk, nacos naming service, service-discovery, configuration-management, grpc

[View on SkillFed](https://skillfed.io/packages/nacos-sdk-python) · [View on PyPI](https://pypi.org/project/nacos-sdk-python/)