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

# lance-namespace — Lance Namespace interface and plugin registry

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

## What it is and what it does

Lance-namespace is a plugin registry and abstract interface layer for Lance namespace implementations. It defines the LanceNamespace ABC that custom storage backends must implement, and provides a connect() factory function to instantiate namespace instances by type. The package re-exports model types from its runtime dependency lance-namespace-urllib3-client, making it a bridge between the Lance ecosystem and pluggable storage backends.

Typical use involves either connecting to built-in implementations (dir for local filesystem, rest for remote HTTP) or registering and connecting to custom implementations. Developers building Lance integrations with external systems would subclass LanceNamespace and register their implementation via register_namespace_impl(), allowing other code to discover and instantiate it by name.

Use it for:

- Connect to local or remote Lance storage backends using the factory pattern without coupling to specific implementations.
- Register custom namespace implementations for proprietary or specialized storage systems to integrate with Lance.
- Build a plugin ecosystem where third-party packages can provide Lance namespace adapters without modifying core code.
- Abstract storage backend selection in applications that need to support multiple Lance data sources at runtime.

## Worth the install?

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

Provides an abstract interface and plugin registry for Lance namespace implementations, enabling connection to different storage backends and custom namespace providers.

Yes. The package is actively maintained, has no known vulnerabilities, carries a permissive license, and solves a real abstraction problem for Lance ecosystem integrations. Install it if you are building or using Lance applications that need pluggable namespace support or custom storage backends.

## Install

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

## Installing lance-namespace

Before you install: Low install friction with a single pure-Python dependency. Active maintenance as of 2026-08-14 with recent release activity.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install lance-namespace

import lance_namespace

ns = lance_namespace.connect("dir", {"root": "/path/to/data"})
lance_namespace.register_namespace_impl("custom", "my_module.MyNamespace")

Verify before relying:

- Whether native implementations (dir, rest) require the lance package to be installed separately
- Stability guarantees or API compatibility policy for the LanceNamespace ABC interface
- Performance characteristics when registering and connecting to custom implementations

## Package facts

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

## Tags

lance namespace interface, vector database namespace plugin, lance storage backend registry, custom namespace implementation, lancedb namespace adapter, lance connect factory, namespace abstraction layer, plugin-registry, vector-database, storage-abstraction

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