Metadata-Version: 2.2
Name: PyGPTs
Version: 2.1.0
Summary: PyGPTs simplifies interacting with AI models like Hugging Face Transformers and Google Gemini. It streamlines model management, handles rate limits, and provides an easy-to-use API for text generation and chat sessions.
Author: oddshellnick
Author-email: oddshellnick.programming@gmail.com
Description-Content-Type: text/markdown
Requires-Dist: setuptools
Requires-Dist: protobuf~=5.28.3
Requires-Dist: pytz~=2024.2
Requires-Dist: torch~=2.5.1
Requires-Dist: pyvartools~=1.3.10
Requires-Dist: transformers~=4.46.2
Requires-Dist: google-genai~=1.0.0
Requires-Dist: numpy~=2.1.3
Requires-Dist: parameterized~=0.9.0
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: summary

# PyGPTs: Seamless Integration with Hugging Face and AI APIs

PyGPTs simplifies interaction with various AI models, including Hugging Face Transformers and pre-trained models available through APIs like Google Gemini. It provides a streamlined interface for managing models, pipelines, and tokenizers, handling rate limits, and accessing different model configurations.

## Key Features

* **Hugging Face Integration:** Easily load and utilize pre-trained models from Hugging Face's `transformers` library. Configure models, tokenizers, and pipelines with flexible settings.
* **Gemini API Support:** Interact with Google's Gemini models through a dedicated wrapper. Manage API keys, track usage limits, and handle different model versions.
* **Rate Limiting:** Built-in rate limiting for Gemini API calls to avoid exceeding quotas and ensure continuous operation.
* **Multiple Model Management:** The `GeminiManager` allows using multiple Gemini models with different API keys, automatically switching between them based on availability and usage limits.
* **Simplified Interface:** PyGPTs provides a clean and easy-to-use API for generating text, managing chat sessions, and accessing model information.
* **Extensible Design:** Built with modularity in mind, PyGPTs can be extended to support other AI APIs and model providers.

## Installation


* **With pip:**
    ```bash
    pip install PyGPTs
    ```

* **With git:**
    ```bash
    pip install git+https://github.com/oddshellnick/PyGPTs.git
    ```

## Modules:

* **`PyGPTs.Gemini`:** Provides classes for interacting with Google Gemini:
* **`PyGPTs.HuggingFace`:** Provides classes for seamless integration with Hugging Face:

## Usage Examples

**Gemini:**

```python
from PyGPTs.Gemini.client import GeminiClientSettings, GeminiClient

settings = GeminiClientSettings(api_key="YOUR_API_KEY")
gemini = GeminiClient(settings)

gemini.start_chat()
response = gemini.send_message("Hello, Gemini!")
print("".join([part.text for candidate in response.candidates for part in candidate.content.parts]))
```

**Hugging Face:**

```python
from PyGPTs.HuggingFace.Transformers import HF_TransformerSettings, HF_Transformer
from transformers import AutoModelForCausalLM

settings = HF_TransformerSettings(
    pretrained_model_name_or_path="gpt2",
    model_class=AutoModelForCausalLM,
    task="text-generation"
)

transformer = HF_Transformer(settings)
generated_text = transformer.generate_content("Once upon a time")
print(generated_text)
```

This library offers a powerful and convenient way to integrate various AI models into your projects. Its flexible design and comprehensive feature set make it a valuable tool for developers working with large language models and other AI-driven applications.

## Future Notes

PyGPTs is an actively developing project. We are continually working on expanding its capabilities, including adding support for new AI models and APIs, improving performance, and enhancing the user experience. Contributions, feature requests, and bug reports are welcome! We encourage you to get involved and help shape the future of PyGPTs.
