Metadata-Version: 2.1
Name: QwantAI
Version: 1.0.0
Summary: A Python library to interact with the Qwant search engine.
Home-page: https://github.com/Ramona-Flower/QwantAI
Author: Ramona
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests ==2.31.0
Requires-Dist: websocket-client ==1.6.0

# QwantAI

QwantAI is a Python library that provides an easy-to-use interface for interacting with the Qwant search engine. You can use it to perform searches and retrieve results either as a single text or streamed data in real time via WebSocket.

---

## Features

- Perform searches on Qwant using a simple Python function.
- Retrieve results in your preferred language.
- Choose between streamed real-time output or a single consolidated response.
- Lightweight and easy to integrate into any project.

---

## Installation

Install QwantAI using `pip` (once packaged):

```bash
pip install QwantAI
If you're developing locally, clone the repository and install it directly:

bash
Copier
Modifier
git clone https://github.com/yourusername/QwantAI.git
cd QwantAI
pip install .
Usage
Import the package and start searching:

Non-Streamed Example
Retrieve all results as a single text response.

python
Copier
Modifier
import QwantAI

response = QwantAI.search("Python programming", language="en_US", streamed=False)
print(response)
Streamed Example
Retrieve results in real-time as they are generated.

python
Copier
Modifier
import QwantAI

QwantAI.search("Python programming", language="en_US", streamed=True)
Parameters
search(query, language="en_US", streamed=False)
Parameter	Type	Description	Default Value
query	str	The search query string.	Required
language	str	The language for the search (e.g., en_US).	en_US
streamed	bool	Whether to stream results or fetch them all at once.	False
Requirements
Python 3.6+
requests (for HTTP requests)
websocket-client (for WebSocket communication)
Install dependencies with:

bash
Copier
Modifier
pip install -r requirements.txt
Disclaimer
This project is provided for educational and informational purposes only. The creator of this package is not responsible for any misuse or damages caused by using this tool. Users are responsible for ensuring their usage complies with applicable laws and regulations.

Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request.

Fork the repository.
Create a feature branch: git checkout -b feature-name.
Commit your changes: git commit -m 'Add new feature'.
Push to the branch: git push origin feature-name.
Open a pull request.
License
This project is licensed under the MIT License. See the LICENSE file for more information.

Acknowledgments
Special thanks to the Qwant search engine for providing a robust API.
