---
id: lance-namespace-urllib3-client
version: "0.11.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# lance-namespace-urllib3-client — Lance Namespace Specification

License: permissive · Maintenance: active · Downloads: 10.9M/mo

## What it is and what it does

This is an auto-generated Python client library for the Lance Namespace REST API, built from an OpenAPI specification. It provides typed bindings to all Lance dataset operations—table creation, querying, branching, indexing, and materialized view management—over HTTP. The client handles authentication (API key, bearer token, or access token), request serialization via pydantic, and response parsing.

You use it by instantiating an ApiClient with a configuration pointing to a Lance REST server, then calling methods on API classes (BranchApi, DataApi, IndexApi, etc.) to perform operations on remote Lance datasets. It is a thin, generated wrapper around urllib3 and pydantic, suitable for applications that need to interact with Lance datasets programmatically without embedding the Lance library itself.

Use it for:

- Query and retrieve data from remote Lance tables via REST without running Lance locally.
- Manage table branches, create indexes, and perform schema alterations on a Lance server.
- Build ETL pipelines that insert, update, or upsert records into Lance tables over HTTP.
- Integrate Lance dataset operations into microservices or cloud functions that cannot run Lance natively.
- Analyze query plans and gather table statistics from a remote Lance instance.

## Worth the install?

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

Auto-generated REST client for the Lance Namespace specification, providing Python bindings to interact with Lance dataset operations over HTTP.

Yes, if you need to interact with a Lance REST server from Python. The package is lightweight, actively maintained, permissive-licensed, and has no known vulnerabilities. Install it only if you have a Lance REST namespace server running; it is not useful standalone. The auto-generated nature means it tracks the OpenAPI spec closely but may lag behind Lance feature releases.

## Install

pip install lance-namespace-urllib3-client
uv add lance-namespace-urllib3-client
poetry add lance-namespace-urllib3-client

## Installing lance-namespace-urllib3-client

Before you install: Low install friction with only four runtime dependencies (pydantic, python-dateutil, typing-extensions, urllib3). Active maintenance as of 2026-08-14 with recent releases.

License in practice: Apache-2.0 permissive license allows use in most projects, including commercial, with minimal restrictions.

Quickstart:

pip install lance-namespace-urllib3-client

import lance_namespace_urllib3_client
from lance_namespace_urllib3_client.rest import ApiException

configuration = lance_namespace_urllib3_client.Configuration(
    host="http://localhost:2333",
    access_token="your_token"
)
with lance_namespace_urllib3_client.ApiClient(configuration) as api_client:
    api_instance = lance_namespace_urllib3_client.DataApi(api_client)
    response = api_instance.query_table(id="table_id", query_request={})

Requires Python 3.8 or later; a running Lance REST server at the configured host.

Verify before relying:

- Whether the package is actively maintained beyond the initial release date (2025-08-01) or if it tracks upstream Lance changes.
- API stability and backward compatibility guarantees across versions.
- Performance characteristics and connection pooling behavior with urllib3.

## Package facts

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

## Tags

lance namespace rest client, lance api python client, openapi generated http client, lance dataset operations, lance table management api, rest client for lance, lance branch and index management, rest-client, lance-ecosystem, openapi-generated

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