RelevanceAI-dev

Github Banner

Run Our Colab Notebook And Get Started In Less Than 10 Lines Of Code!

For guides and tutorials on how to use this package, visit https://docs.relevance.ai/docs.

🔥 Features

Fast vector search with free dashboard to preview and visualise results
Vector clustering with support for libraries like scikit-learn and easy built-in customisation
Store nested documents with support for multiple vectors and metadata in one object
Multi-vector search with filtering, facets, weighting
Hybrid search with support for weighting keyword matching and vector search ... and more!

🧠 Documentation

API type	Link
Guides	Documentation
Python Reference	Documentation

You can easily access our documentation while using the SDK using:

from relevanceai import Client
client = Client()

# Easy one line of code to access our docs
client.docs

🛠️ Installation

Using pip:

pip install -U relevanceai

Using conda:

conda install -c relevance relevanceai

⏩ Quickstart

Login into your project space

from relevanceai import Client

client = Client(<project_name>, <api_key>)

Prepare your documents for insertion by following the below format:

Each document should be a dictionary
Include a field _id as a primary key, otherwise it's automatically generated
Suffix vector fields with _vector_

docs = [
    {"_id": "1", "example_vector_": [0.1, 0.1, 0.1], "data": "Documentation"},
    {"_id": "2", "example_vector_": [0.2, 0.2, 0.2], "data": "Best document!"},
    {"_id": "3", "example_vector_": [0.3, 0.3, 0.3], "data": "document example"},
    {"_id": "4", "example_vector_": [0.4, 0.4, 0.4], "data": "this is another doc"},
    {"_id": "5", "example_vector_": [0.5, 0.5, 0.5], "data": "this is a doc"},
]

Insert data into a dataset

Create a dataset object with the name of the dataset you'd like to use. If it doesn't exist, it'll be created for you.

Quick tip! Our Dataset object is compatible with common dataframes methods like .head(), .shape() and .info().

ds = client.Dataset("quickstart")
ds.insert_documents(docs)

Perform vector search

results = ds.vector_search(
    multivector_query=[{"vector": [0.2, 0.2, 0.2], "fields": ["example_vector_"]}],
    page_size=3,
    query="sample search" # optional, name to display in dashboard
)

Cluster dataset with Auto Cluster

Generate 12 clusters using kmeans

clusterop = ds.auto_cluster("kmeans-12", vector_fields=["example_vector_"])
clusterop.list_closest_to_center()

Quick tip! After each of these steps, the output will provide a URL to the Relevance AI dashboard where you can see a visualisation of your results

🚧 Development

Getting Started

To get started with development, ensure you have pytest and mypy installed. These will help ensure typechecking and testing.

python -m pip install pytest mypy

Then run testing using:

Don't forget to set your test credentials!

export TEST_PROJECT = xxx
export TEST_API_KEY = xxx

python -m pytest
mypy relevanceai

Set up precommit

pip install precommit
pre-commit install

🧰 Config

The config object contains the adjustable global settings for the SDK. For a description of all the settings, see here.

To view setting options, run the following:

client.config.options

The syntax for selecting an option is section.key. For example, to disable logging, run the following to modify logging.enable_logging:

client.config.set_option('logging.enable_logging', False)

To restore all options to their default, run the following:

Changing the base URL

You can change the base URL as such:

client.base_url = "https://.../latest"

You can also update the ingest base URL:

client.ingest_base_url = "https://.../latest

Metadata

Release files for RelevanceAI-dev 2.0.0.2022.4.6.2.1.52.985865

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for RelevanceAI-dev 2.0.0.2022.4.6.2.1.52.985865
File	Size	Uploaded
RelevanceAI-dev-2.0.0.2022.4.6.2.1.52.985865.tar.gz	178.1 kB	Apr 6, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for RelevanceAI-dev 2.0.0.2022.4.6.2.1.52.985865
File	Interpreter	ABI	Platform	Reset
RelevanceAI_dev-2.0.0.2022.4.6.2.1.52.985865-py3-none-any.whl 244.4 kB Apr 6, 2022	Python 3	none	any	Details

Total release size: 422.5 kB

Release files / RelevanceAI-dev-2.0.0.2022.4.6.2.1.52.985865.tar.gz

Download URL	RelevanceAI-dev-2.0.0.2022.4.6.2.1.52.985865.tar.gz
Size	178.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`e85a172603adaa64e4686ad20d270709a1074f0c53a563231339a8158bd25aec`
BLAKE2b-256 checksum How to use checksums	`6e52d1f671b63f10ed8333127b25b7bdd91907445cd2509a6e24215f004deba3`
Upload date	Apr 6, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.0 CPython/3.10.4`

Release files / RelevanceAI_dev-2.0.0.2022.4.6.2.1.52.985865-py3-none-any.whl

Download URL	RelevanceAI_dev-2.0.0.2022.4.6.2.1.52.985865-py3-none-any.whl
Size	244.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c1c575efdeee91827bf30e94c7e39f6bd30c5b15ae33a536d9545eafddf7aff1`
BLAKE2b-256 checksum How to use checksums	`41ddd0b0990bc506c216d9aa97f46548a52c1055dd4f03a2650b36cad7ffd9d2`
Upload date	Apr 6, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.0 CPython/3.10.4`