Metadata-Version: 2.1
Name: pigeonsai
Version: 1.0.0
Summary: PigeonAI client and SDK
Home-page: https://www.pigeonsai.com/
Author: PigeonsAI Inc.
Author-email: info@pigeonsai.com
License: Proprietary License
Project-URL: Homepage, https://www.pigeonsai.com
Project-URL: Documentation, https://docs.pigeonsai.com/
Project-URL: Contact, https://pigeonsai.com/
Keywords: PigeonsAI AI ecosystem vector database cloud semantic search
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Database
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.28.2)
Requires-Dist: nltk (==3.8.1)
Requires-Dist: faiss-cpu (==1.7.3)
Requires-Dist: openai (==0.27.4)
Requires-Dist: tenacity (==8.2.2)

# PigeonsAI SDK

The PigeonsAI SDK is a Python package that provides an interface to interact with the PigeonsDB database. This SDK allows you to search, initialize, get database information, and add documents to the database.

## Installation

To install the PigeonsAI SDK, use pip:

```
pip install pigeonsai
```

## Usage

To use the PigeonsAI SDK, first import the PigeonsDB class:

```
from pigeonsai import PigeonsDB
```


### Initialize the connection

Before using the SDK, you need to initialize the connection to the database by providing your API key and database name:


```
api_key = "your_api_key"
db_name = "your_db_name"
PigeonsDB.init(api_key, db_name)
```

### Add documents

To add documents to the database, use the add method:

```
documents = ["document1", "document2", "document3"]
metadata_list = [{"metadata1": "value1"}, {"metadata2": "value2"}, {"metadata3": "value3"}]

PigeonsDB.add(documents, metadata_list)
```


### Search

To search the database, use the search method:

```
query_text = "your_search_query"
k = 10  # Number of results to return
metadata_filters = [{"metadata1": "value1"}]  # Optional metadata filters
keywords = ["keyword"]  # Optional keywords

PigeonsDB.search(query_text, k, metadata_filters, keywords)
```


## Contributing

If you'd like to contribute to the PigeonsAI SDK, please submit a pull request or open an issue on the GitHub repository.

## License

The PigeonsAI SDK is released under the [MIT License](https://opensource.org/licenses/MIT) 
