---
id: nebius
version: "0.5.4"
license: The MIT License (MIT) Copyright (c) 2025 Nebius B.V. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"),… (full text in the JSON record)
license_treatment: unclear
maintenance: active
---

# nebius — Nebius Python SDK

License: unclear · Maintenance: active · Downloads: 2.4M/mo

## What it is and what it does

Nebius is a Python client library for interacting with Nebius AI Cloud services via gRPC. It handles authentication, manages cloud resources, and provides a unified interface to Nebius APIs. The library supports both synchronous and asynchronous workflows, with version 0.5.x introducing a significant architectural change: each SDK instance now manages its own internal event loop and daemon thread, simplifying deployment in many scenarios but requiring careful handling of loop ownership, exception handlers, and executor threads.

The SDK depends on cryptography, pyyaml, grpcio, PyJWT, certifi, protobuf, portalocker, aiohttp, and typing-extensions. If you are migrating from 0.4.x, several workflows have changed: `Channel.bg_task()` now returns a reusable awaitable rather than an `asyncio.Task`, synchronous helpers cannot be called from async contexts, and supplied event loops must already be running. The documentation emphasizes thread safety, loop ownership, and proper cleanup to avoid deadlocks and resource leaks.

Use it for:

- Authenticate with Nebius AI Cloud and manage cloud resources programmatically from Python applications.
- Build async microservices that communicate with Nebius APIs using gRPC for low-latency, typed service calls.
- Integrate Nebius AI services (e.g., model inference, data processing) into existing Python workflows with both sync and async patterns.
- Deploy cloud-native applications that require fine-grained control over event loops and executor thread pools.
- Migrate from Nebius SDK 0.4.x to 0.5.x by adapting async task handling and loop ownership patterns.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Client library for Nebius AI Cloud services that provides gRPC-based authentication, resource management, and API communication with async/sync support.

Yes, if you are building on Nebius AI Cloud. The SDK is actively maintained, has low install friction, and carries no known vulnerabilities. However, version 0.5.x introduces breaking changes from 0.4.x and requires careful attention to event loop ownership, thread safety, and async/sync boundary crossing. Read the migration guide and threading documentation before upgrading or integrating into existing async applications.

## Install

pip install nebius
uv add nebius
poetry add nebius

## Installing nebius

Before you install: Low install friction with a pure-Python wheel and well-established dependencies. Active maintenance with a release one day ago suggests ongoing support.

License in practice: MIT license permits commercial and private use with minimal restrictions; include the license text and copyright notice in distributions.

Quickstart:

pip install nebius

from nebius import SDK

sdk = SDK()
await sdk.some_service.some_method(request)

Requires Python 3.10 or later; async operations require an event loop context or SDK-managed loop.

Verify before relying:

- Whether the SDK's internal event loop and executor threading model is compatible with existing async frameworks in your application.
- Specific Nebius API endpoints and services available in version 0.5.4 beyond what the description excerpt covers.
- Performance characteristics and rate limits for gRPC communication with Nebius services.

## Package facts

- License: The MIT License (MIT) Copyright (c) 2025 Nebius B.V. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"),… (full text in the JSON record) (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 2.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

nebius cloud client library, grpc api client for nebius, nebius ai cloud sdk, async cloud service client, nebius resource management, cloud authentication and api calls, nebius service integration, grpc-client, cloud-sdk, async-first

[View on SkillFed](https://skillfed.io/packages/nebius) · [View on PyPI](https://pypi.org/project/nebius/)