Metadata-Version: 2.4
Name: atlas-db-client
Version: 0.0.1
Summary: The Python client for the Atlas vector database
Project-URL: Homepage, https://github.com/devfrank-m/python-atlas-client
Project-URL: Repository, https://github.com/devfrank-m/python-atlas-client
Project-URL: Issues, https://github.com/devfrank-m/python-atlas-client/issues
Author: devfrank-m
License-Expression: MIT
License-File: LICENSE
Keywords: atlas,client,database,embeddings,vector
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# Atlas Client

The Python client for the [Atlas](https://github.com/devfrank-m/atlas) vector database.

## Installation

```bash
pip install atlas-db-client
```

## Quick Start

```python
from atlas_db_client import AtlasClient

client = AtlasClient(host="http://localhost:8600")

# Create a collection
collection = client.create_collection(
    name="my-collection",
    dimension=128,
    metric="cosine",
)

# Insert a vector
result = client.insert_vector(
    collection_id=collection.id,
    vector=[0.1] * 128,
    metadata={"label": "example"},
)

# Search
response = client.search(
    collection_id=collection.id,
    vector=[0.1] * 128,
    k=5,
)

for r in response.results:
    print(r.id, r.score)
```

## Async Support

```python
from atlas_db_client import AsyncAtlasClient

async with AsyncAtlasClient() as client:
    collection = await client.create_collection(
        name="my-collection",
        dimension=128,
        metric="cosine",
    )
```

## License

MIT
