---
id: aiven-client
version: "4.17.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# aiven-client — Aiven.io client library / command-line client

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

## What it is and what it does

aiven-client is the official command-line interface for Aiven, a managed cloud services platform. It provides a single entry point for authenticating with Aiven, managing projects and cloud resources, provisioning databases and message brokers, and administering users and permissions across your organization. The tool wraps Aiven's REST API and outputs raw JSON for scripting with tools like jq.

The package is built on requests, certifi, and requests-toolbelt, making it lightweight and portable. It requires Python 3.10 or later and is actively maintained with recent releases. The CLI supports both interactive login with credentials and token-based authentication, and includes comprehensive help and search features to discover available commands.

Use it for:

- Provision and manage PostgreSQL, Kafka, MySQL, and other managed services from the command line in CI/CD pipelines
- Automate project creation, user invitations, and permission management across Aiven organizations
- Query service details, connection strings, and logs programmatically using JSON output for integration with monitoring or deployment tools
- Manage authentication tokens and access control for application users and service accounts
- Switch between projects and cloud regions as part of multi-environment deployment workflows

## Worth the install?

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

Official command-line client for Aiven's managed cloud services platform, enabling authentication, project management, service provisioning, and cloud resource administration.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and is the official client for Aiven's platform. Install it if you need to manage Aiven services from the command line or automate cloud infrastructure provisioning. No known security vulnerabilities.

## Install

pip install aiven-client
uv add aiven-client
poetry add aiven-client

## Installing aiven-client

Before you install: Low install friction with three common runtime dependencies (certifi, requests-toolbelt, requests). Active maintenance with a release within the last day and ongoing commits. Supports modern Python versions from 3.10 through 3.14.

License in practice: Apache License 2.0 is permissive, allowing commercial and private use with minimal restrictions. You may use, modify, and distribute the package freely as long as you include a copy of the license and state significant changes.

Quickstart:

$ pip install aiven-client
$ avn user login you@example.com
$ avn project list
$ avn service list

Requires Python 3.10 or later. On Windows, you may need to use `python3 -m aiven.client` instead of the `avn` command directly.

Verify before relying:

- Whether all Aiven service types (PostgreSQL, Kafka, etc.) are fully supported in version 4.17.0
- Rate limits or quotas on API operations through the CLI
- Whether offline mode or local configuration caching is supported

## Package facts

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

## Tags

aiven cloud cli, managed services command line, aiven service management, cloud infrastructure cli, aiven authentication client, database service provisioning, cloud project management, cli-tool, cloud-management, aiven-platform

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