neptune-api

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 on this page — 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

neptune-api on PyPI

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

Evidence: neptune_api-0.26.0-py3-none-any.whl

Keywords: MLOps, ML Experiment Tracking, ML Model Registry, ML Model Store, ML Metadata Store

Tags

More Python Modules packages