---
id: kumo-api
version: "0.92.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# kumo-api — RESTful datamodels for Kumo AI

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

## What it is and what it does

kumo-api is a low-level library that provides Pydantic-based dataclass definitions for Kumo AI's RESTful API resources. It acts as a schema layer for HTTP clients to construct and validate payloads when communicating with Kumo's cloud services. The library bundles four runtime dependencies—pydantic for data validation, protobuf for serialization, numpy and pandas for numerical and tabular data handling—to support structured API interactions.

The package is positioned as a foundational layer; the documentation recommends installing the higher-level kumoai SDK for a smoother user experience, suggesting that kumo-api alone is primarily useful for developers who need direct control over API resource construction or who are building custom integrations. It supports Python 3.10 through 3.14 and carries no known security vulnerabilities.

Use it for:

- Building custom HTTP clients to interact with Kumo AI cloud services using validated datamodels
- Integrating Kumo API resources into data pipeline tools that work with numpy and pandas
- Prototyping or testing Kumo API interactions without the full kumoai SDK overhead
- Serializing and deserializing Kumo API payloads using protobuf for efficient data transfer

## Worth the install?

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

kumo-api defines RESTful API resource schemas as Pydantic dataclasses for interacting with Kumo AI's cloud services over HTTP.

Yes, if you need direct control over Kumo AI API resource construction or are building a custom integration. The low install friction, permissive MIT license, and active maintenance make it a safe dependency. However, most users should prefer the kumoai SDK for a higher-level experience. No security vulnerabilities are known.

## Install

pip install kumo-api
uv add kumo-api
poetry add kumo-api

## Installing kumo-api

Before you install: Low friction install with a pure-wheel distribution. Active maintenance as of 59 days ago. Depends on widely-used libraries: pydantic, protobuf, numpy, and pandas.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for commercial and open-source projects alike.

Quickstart:

pip install kumo-api

from kumo_api import <resource_class>
# Use Pydantic dataclasses to construct and validate API payloads

Requires Python 3.10 or later.

Verify before relying:

- What specific resource schemas and API endpoints are available in version 0.92.0
- Whether kumo-api can be used standalone or requires the kumoai SDK for practical use
- Performance characteristics when handling large datasets with numpy and pandas dependencies

## Package facts

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

## Tags

kumo ai api client, rest api datamodels, pydantic schema definitions, cloud service integration, http api resources, kumo cloud services, api resource schema, api-client, pydantic-schema, cloud-integration

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