---
id: neptune-api
version: "0.26.0"
license: Apache-2.0
license_treatment: permissive
maintenance: abandoned
---

# neptune-api — A client library for accessing Neptune API

License: permissive · Maintenance: abandoned · Downloads: 2.4M/mo

## What it is and what it does

neptune-api is an auto-generated Python client for the Neptune API, built from an OpenAPI specification. It provides both synchronous and asynchronous methods to make authenticated or unauthenticated requests to Neptune endpoints, with automatic deserialization of responses into typed model objects. The library uses httpx for HTTP transport and supports custom SSL certificate handling.

The package is organized by endpoint tags—each API endpoint becomes a callable function in a module named after its tag. You instantiate either a plain Client or AuthenticatedClient with your base URL and optional token, then import and call the endpoint functions directly. It handles request/response serialization, optional detailed response metadata, with async/await patterns. However, the repository is archived, meaning no maintenance or updates will be provided.

Use it for:

- Integrate Neptune experiment tracking into Python applications that need to log metrics, parameters, or artifacts via the Neptune API.
- Build automation scripts that interact with Neptune's model registry or metadata store without writing raw HTTP requests.
- Call Neptune endpoints from async Python services where non-blocking I/O is required.
- Access Neptune's MLOps features from internal tools or CI/CD pipelines.

## Worth the install?

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

A generated Python client library for the Neptune API, providing synchronous and asynchronous methods to call Neptune endpoints with automatic model parsing and optional authentication.

No. While the package has low install friction and a permissive license, it is abandoned—the repository is archived with no updates in 219 days. Use only if you are certain the Neptune API specification has not changed and you can maintain a fork yourself. For active Neptune integration, contact Neptune.ai directly or use an officially maintained client.

## Install

pip install neptune-api
uv add neptune-api
poetry add neptune-api

## Installing neptune-api

Before you install: Low install friction with a small dependency footprint (5 runtime deps). However, the package is abandoned—the repository is archived with no updates in 219 days, which means bugs will not be addressed.

License in practice: Licensed under Apache-2.0 (permissive), which allows commercial and private use with minimal restrictions; you may use and modify the code freely but must retain the license notice.

Quickstart:

from neptune_api import AuthenticatedClient
from neptune_api.api.my_tag import get_my_data_model

client = AuthenticatedClient(
    base_url="https://api.example.com",
    token="SuperSecretToken"
)
my_data = await get_my_data_model.asyncio(client=client)

Requires Python 3.8 or later; endpoints are organized by their OpenAPI tags, so you must know the tag name and endpoint function to call.

Verify before relying:

- Whether the Neptune API specification this client was generated from remains current and compatible with the actual Neptune service.
- Support status: whether Neptune.ai continues to maintain the API itself despite this client library being archived.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 2.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

neptune api client, openapi generated python client, ml experiment tracking api, async http client library, rest api client generator, authenticated api calls, neptune mlops integration, api-client, mlops, abandoned

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