Metadata-Version: 2.1
Name: RelevanceAI
Version: 0.26.0
Summary: UNKNOWN
Home-page: https://relevance.ai/
Author: Relevance AI
Author-email: dev@relevance.ai
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Manufacturing
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Database
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
Classifier: Topic :: Multimedia :: Video :: Conversion
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Image Recognition
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tqdm (>=4.49.0)
Requires-Dist: pandas (>=1.0.0)
Requires-Dist: loguru (>=0.5.3)
Requires-Dist: document-utils (>=1.6.1)
Requires-Dist: requests (>=2.0.0)
Requires-Dist: numpy (>=1.19.0)
Requires-Dist: joblib (>=1.0.0)
Provides-Extra: dev
Requires-Dist: autopep8 ; extra == 'dev'
Requires-Dist: pylint ; extra == 'dev'
Requires-Dist: jupyter ; extra == 'dev'
Requires-Dist: sphinx-rtd-theme (>=0.5.0) ; extra == 'dev'
Requires-Dist: sphinx-autoapi (==1.8.4) ; extra == 'dev'
Requires-Dist: sphinx-autodoc-typehints (==1.12.0) ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-dotenv ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: pytest-mock ; extra == 'dev'
Requires-Dist: mypy ; extra == 'dev'
Requires-Dist: types-requests ; extra == 'dev'
Requires-Dist: tqdm (>=4.49.0) ; extra == 'dev'
Requires-Dist: pandas (>=1.0.0) ; extra == 'dev'
Requires-Dist: loguru (>=0.5.3) ; extra == 'dev'
Requires-Dist: document-utils (>=1.6.1) ; extra == 'dev'
Requires-Dist: requests (>=2.0.0) ; extra == 'dev'
Requires-Dist: numpy (>=1.19.0) ; extra == 'dev'
Requires-Dist: joblib (>=1.0.0) ; extra == 'dev'
Requires-Dist: openpyxl (>=3.0.9) ; extra == 'dev'
Requires-Dist: fsspec (>=2021.10.1) ; extra == 'dev'
Requires-Dist: scikit-learn ; extra == 'dev'
Requires-Dist: plotly (>=5.3.1) ; extra == 'dev'
Requires-Dist: typing-extensions ; extra == 'dev'
Requires-Dist: typeguard ; extra == 'dev'
Requires-Dist: dash ; extra == 'dev'
Requires-Dist: pillow ; extra == 'dev'
Requires-Dist: opencv-python ; extra == 'dev'
Requires-Dist: scikit-image ; extra == 'dev'
Requires-Dist: dash-bootstrap-components ; extra == 'dev'
Provides-Extra: dev-vis
Requires-Dist: autopep8 ; extra == 'dev-vis'
Requires-Dist: pylint ; extra == 'dev-vis'
Requires-Dist: jupyter ; extra == 'dev-vis'
Requires-Dist: sphinx-rtd-theme (>=0.5.0) ; extra == 'dev-vis'
Requires-Dist: pytest ; extra == 'dev-vis'
Requires-Dist: pytest-dotenv ; extra == 'dev-vis'
Requires-Dist: pytest-cov ; extra == 'dev-vis'
Requires-Dist: pytest-mock ; extra == 'dev-vis'
Requires-Dist: mypy ; extra == 'dev-vis'
Requires-Dist: types-requests ; extra == 'dev-vis'
Requires-Dist: tqdm (>=4.49.0) ; extra == 'dev-vis'
Requires-Dist: pandas (>=1.0.0) ; extra == 'dev-vis'
Requires-Dist: loguru (>=0.5.3) ; extra == 'dev-vis'
Requires-Dist: document-utils (>=1.6.1) ; extra == 'dev-vis'
Requires-Dist: requests (>=2.0.0) ; extra == 'dev-vis'
Requires-Dist: numpy (>=1.19.0) ; extra == 'dev-vis'
Requires-Dist: joblib (>=1.0.0) ; extra == 'dev-vis'
Requires-Dist: openpyxl (>=3.0.9) ; extra == 'dev-vis'
Requires-Dist: fsspec (>=2021.10.1) ; extra == 'dev-vis'
Requires-Dist: scikit-learn ; extra == 'dev-vis'
Requires-Dist: plotly (>=5.3.1) ; extra == 'dev-vis'
Requires-Dist: typing-extensions ; extra == 'dev-vis'
Requires-Dist: typeguard ; extra == 'dev-vis'
Requires-Dist: dash ; extra == 'dev-vis'
Requires-Dist: pillow ; extra == 'dev-vis'
Requires-Dist: opencv-python ; extra == 'dev-vis'
Requires-Dist: scikit-image ; extra == 'dev-vis'
Requires-Dist: dash-bootstrap-components ; extra == 'dev-vis'
Provides-Extra: excel
Requires-Dist: tqdm (>=4.49.0) ; extra == 'excel'
Requires-Dist: pandas (>=1.0.0) ; extra == 'excel'
Requires-Dist: loguru (>=0.5.3) ; extra == 'excel'
Requires-Dist: document-utils (>=1.6.1) ; extra == 'excel'
Requires-Dist: requests (>=2.0.0) ; extra == 'excel'
Requires-Dist: numpy (>=1.19.0) ; extra == 'excel'
Requires-Dist: joblib (>=1.0.0) ; extra == 'excel'
Requires-Dist: openpyxl (>=3.0.9) ; extra == 'excel'
Requires-Dist: fsspec (>=2021.10.1) ; extra == 'excel'
Provides-Extra: hdbscan
Requires-Dist: hdbscan (>=0.8.27) ; extra == 'hdbscan'
Provides-Extra: kmedoids
Requires-Dist: scikit-learn-extra (>=0.2.0) ; extra == 'kmedoids'
Provides-Extra: notebook
Requires-Dist: jsonshower ; extra == 'notebook'
Requires-Dist: tqdm (>=4.49.0) ; extra == 'notebook'
Requires-Dist: pandas (>=1.0.0) ; extra == 'notebook'
Requires-Dist: loguru (>=0.5.3) ; extra == 'notebook'
Requires-Dist: document-utils (>=1.6.1) ; extra == 'notebook'
Requires-Dist: requests (>=2.0.0) ; extra == 'notebook'
Requires-Dist: numpy (>=1.19.0) ; extra == 'notebook'
Requires-Dist: joblib (>=1.0.0) ; extra == 'notebook'
Requires-Dist: scikit-learn ; extra == 'notebook'
Requires-Dist: plotly (>=5.3.1) ; extra == 'notebook'
Requires-Dist: typing-extensions ; extra == 'notebook'
Requires-Dist: typeguard ; extra == 'notebook'
Requires-Dist: dash ; extra == 'notebook'
Requires-Dist: pillow ; extra == 'notebook'
Requires-Dist: opencv-python ; extra == 'notebook'
Requires-Dist: scikit-image ; extra == 'notebook'
Requires-Dist: dash-bootstrap-components ; extra == 'notebook'
Provides-Extra: tests
Requires-Dist: pytest ; extra == 'tests'
Requires-Dist: pytest-dotenv ; extra == 'tests'
Requires-Dist: pytest-cov ; extra == 'tests'
Requires-Dist: pytest-mock ; extra == 'tests'
Requires-Dist: mypy ; extra == 'tests'
Requires-Dist: types-requests ; extra == 'tests'
Requires-Dist: tqdm (>=4.49.0) ; extra == 'tests'
Requires-Dist: pandas (>=1.0.0) ; extra == 'tests'
Requires-Dist: loguru (>=0.5.3) ; extra == 'tests'
Requires-Dist: document-utils (>=1.6.1) ; extra == 'tests'
Requires-Dist: requests (>=2.0.0) ; extra == 'tests'
Requires-Dist: numpy (>=1.19.0) ; extra == 'tests'
Requires-Dist: joblib (>=1.0.0) ; extra == 'tests'
Requires-Dist: openpyxl (>=3.0.9) ; extra == 'tests'
Requires-Dist: fsspec (>=2021.10.1) ; extra == 'tests'
Requires-Dist: scikit-learn ; extra == 'tests'
Requires-Dist: plotly (>=5.3.1) ; extra == 'tests'
Requires-Dist: typing-extensions ; extra == 'tests'
Requires-Dist: typeguard ; extra == 'tests'
Requires-Dist: dash ; extra == 'tests'
Requires-Dist: pillow ; extra == 'tests'
Requires-Dist: opencv-python ; extra == 'tests'
Requires-Dist: scikit-image ; extra == 'tests'
Requires-Dist: dash-bootstrap-components ; extra == 'tests'
Provides-Extra: umap
Requires-Dist: umap-learn (>=0.5.2) ; extra == 'umap'
Provides-Extra: vis
Requires-Dist: tqdm (>=4.49.0) ; extra == 'vis'
Requires-Dist: pandas (>=1.0.0) ; extra == 'vis'
Requires-Dist: loguru (>=0.5.3) ; extra == 'vis'
Requires-Dist: document-utils (>=1.6.1) ; extra == 'vis'
Requires-Dist: requests (>=2.0.0) ; extra == 'vis'
Requires-Dist: numpy (>=1.19.0) ; extra == 'vis'
Requires-Dist: joblib (>=1.0.0) ; extra == 'vis'
Requires-Dist: scikit-learn ; extra == 'vis'
Requires-Dist: plotly (>=5.3.1) ; extra == 'vis'
Requires-Dist: typing-extensions ; extra == 'vis'
Requires-Dist: typeguard ; extra == 'vis'
Requires-Dist: dash ; extra == 'vis'
Requires-Dist: pillow ; extra == 'vis'
Requires-Dist: opencv-python ; extra == 'vis'
Requires-Dist: scikit-image ; extra == 'vis'
Requires-Dist: dash-bootstrap-components ; extra == 'vis'

# RelevanceAI

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

If you are looking for an SDK reference, you can find that [here](https://relevanceai.github.io/RelevanceAI/docs/html/index.html).

Built mainly for data scientists/engineers looking to experiment with vectors/embeddings.

## Installation 

The easiest way is to install this package is to run `pip install --upgrade relevanceai`.

You can also install on conda (only available on Linux environments at the moment): `conda install -c relevance relevanceai`.

## How to use the RelevanceAI client

For example:

```python
## To instantiate the client 
from relevanceai import Client
client = Client()
```

## Development

### Getting Started

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

```python
python -m pip install pytest mypy
```


Then run testing using:

Make sure to set your test credentials!

```
export TEST_PROJECT = xxx 
export TEST_API_KEY = xxx 
```

```python
python -m pytest
mypy relevanceai
```

## Config

The config contains the adjustable global settings for the SDK. For a description of all the settings, see [here](https://relevanceai.github.io/RelevanceAI/docs/html/index.html).  

To view setting options, run the following:

```python
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*:

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

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

```python
client.config.reset_to_default()
```

## Changing 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
```


