---
id: lakefs-sdk
version: "1.86.0"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# lakefs-sdk — lakeFS API

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

## What it is and what it does

lakefs-sdk is an auto-generated Python client for the lakeFS HTTP API, built from OpenAPI specifications. It wraps the full lakeFS API surface—including repositories, branches, commits, authentication, authorization, and actions—into typed Python classes and methods. The package depends on urllib3, python-dateutil, pydantic, and aenum to handle HTTP requests, date parsing, data validation, and enum support.

You use it to interact with a lakeFS server programmatically: configure authentication (basic auth, API keys, or JWT tokens), instantiate an API class (ActionsApi, AuthApi, etc.), and call methods to manage repositories, run actions, create users and groups, or query metadata. It is primarily useful when you need to automate lakeFS operations from Python code rather than using the web UI or CLI.

Use it for:

- Automate repository operations (create branches, commit data, merge) in data pipelines or CI/CD workflows.
- Manage authentication and authorization programmatically—create users, groups, policies, and credentials.
- Query and monitor action runs and hook outputs to track automated workflows triggered by lakeFS events.
- Build custom tooling or dashboards that need to read lakeFS metadata and state via the HTTP API.
- Integrate lakeFS into larger Python applications that require version control for data assets.

## Worth the install?

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

Provides a Python client library for the lakeFS HTTP API, automatically generated from OpenAPI specifications to enable programmatic interaction with lakeFS repositories.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. Install it if you need to interact with lakeFS programmatically from Python—it is the official client and covers the full API surface. Skip it if you only use lakeFS via its UI or CLI.

## Install

pip install lakefs-sdk
uv add lakefs-sdk
poetry add lakefs-sdk

## Installing lakefs-sdk

Before you install: Low install friction with four lightweight runtime dependencies. Actively maintained with a recent release (9 days old) and a well-established repository (5485 stars). Supports Python 3.6+ and is distributed as a pure Python wheel.

License in practice: Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install lakefs-sdk

import lakefs_sdk
from lakefs_sdk.rest import ApiException

configuration = lakefs_sdk.Configuration(
    host="/api/v1",
    username="user",
    password="pass"
)
with lakefs_sdk.ApiClient(configuration) as api_client:
    api_instance = lakefs_sdk.ActionsApi(api_client)
    response = api_instance.get_run("repo", "run_id")

Requires a running lakeFS server and valid authentication credentials (basic auth, API key, or JWT token).

Verify before relying:

- Specific API endpoint coverage and completeness relative to lakeFS server version 1.0.0
- Whether all authentication methods (basic, cookie, OIDC, SAML, JWT) are fully functional in practice
- Performance characteristics and rate-limiting behavior when working with large repositories

## Package facts

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

## Tags

lakeFS API client, python lakeFS SDK, lakeFS HTTP API wrapper, lakeFS repository management, lakeFS actions and auth API, OpenAPI generated lakeFS client, lakeFS data versioning, api-client, data-versioning, openapi-generated

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