---
id: pydo
version: "0.40.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pydo — The official client for interacting with the DigitalOcean API

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

## What it is and what it does

PyDo is the official Python client for DigitalOcean's API, generated from the DigitalOcean OpenAPI Specification to ensure compliance with the API contract. It provides a single Client interface for both infrastructure management (droplets, SSH keys, volumes, Kubernetes, etc.) and AI inference (chat completions, image generation, audio, batch inference) on DigitalOcean's Gradient platform. The library supports Python 3.8 and later, with both synchronous and asynchronous usage patterns.

Developers initialize the client with a DigitalOcean API token and then call methods organized by resource type—for example, `client.ssh_keys.list()` or `client.chat.completions.create()`. The client handles authentication, request serialization, and response parsing. It supports pagination for large result sets and streaming for inference endpoints like chat completions.

Use it for:

- Automate DigitalOcean infrastructure provisioning and management (droplets, volumes, SSH keys) from Python scripts or applications.
- Build chat applications using DigitalOcean's Gradient AI models with streaming support for real-time responses.
- Generate images programmatically via DigitalOcean's inference API without managing separate AI service credentials.
- Enumerate and list available AI models on the Gradient platform to discover capabilities at runtime.
- Implement batch inference workflows for processing multiple requests to AI models in parallel.

## Worth the install?

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

Official Python client library for the DigitalOcean API, wrapping OpenAPI-generated code to provide access to infrastructure management and AI inference endpoints through a single Client interface.

Yes. PyDo is the official, actively maintained client for DigitalOcean's API with low install friction, permissive licensing, and no known vulnerabilities. Install it if you need to manage DigitalOcean infrastructure or access Gradient AI services from Python—it's the canonical way to do so. The recent release and active repository indicate ongoing support.

## Install

pip install pydo
uv add pydo
poetry add pydo

## Installing pydo

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a release 11 days ago and recent commits. Depends on azure-core, azure-identity, isodate, msrest, and typing-extensions—all standard, well-maintained packages.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install pydo

import os
from pydo import Client

client = Client(token=os.getenv("DIGITALOCEAN_TOKEN"))
ssh_keys_resp = client.ssh_keys.list()
for k in ssh_keys_resp["ssh_keys"]:
    print(f"ID: {k['id']}, NAME: {k['name']}")

Requires a DigitalOcean API token (PAT) with appropriate scope; inference APIs require full-access scope or a Gradient Model Access Key.

Verify before relying:

- Whether all DigitalOcean API endpoints are fully supported or if some remain unimplemented.
- Performance characteristics and rate-limiting behavior under high-volume usage.
- Stability of the async interface (aio) relative to the synchronous client.

## Package facts

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

## Tags

digitalocean api client, digitalocean python sdk, manage digitalocean resources, digitalocean droplets python, digitalocean inference api, gradient ai platform client, digitalocean infrastructure automation, cloud-api-client, infrastructure-automation, ai-inference

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