periplus-client 0.1.0a1

Description:

periplusclient 0.1.0a1

Periplus Client Library

Introduction
The Periplus client library provides an interface to interact with a Periplus instance. Periplus is a remote vector database cache. This client library allows you to initialize, train, add data, load data, perform searches, and evict data within Periplus. For more information on Periplus, please refer to the README.md.
Installation
Prerequisites

Python 3.8+
struct and collections libraries (included in the Python standard library)

Installation via pip
You can install the Periplus client library using pip:
pip install periplus-client

Quick Start
Here’s a quick example of how to use the Periplus client library to interact with the Periplus service:
from periplus_client import Periplus

# Initialize the Periplus client
client = Periplus(host='localhost', port=8080)

# Initialize the Periplus instance
await client.initialize(
d=128,
db_url='http://localhost:5000/proxy',
options={'n_records': 500000, 'use_flat': False}
)

# Train the instance with sample data
await client.train(training_data=[[0.1, 0.2, ..., 0.128]])

# Add data to the instance
await client.add(ids=['vec1', 'vec2'], embeddings=[[0.1, 0.2, ..., 0.128]])

# Perform a search
results = await client.search(k=5, xq=[[0.1, 0.2, ..., 0.128]])
print(results)

Documentation
API Reference
For a complete API reference, including details on all classes, methods, and their usage, please refer to the API Reference.
Contributing
Contributions are welcome! If you'd like to contribute to the project, please follow these steps:

Fork the repository.
Create a new branch: git checkout -b feature/your-feature-name.
Make your changes.
Commit your changes: git commit -m 'Add some feature'.
Push to the branch: git push origin feature/your-feature-name.
Open a pull request.

License
This project is licensed under the MIT License - see the LICENSE file for details.