Metadata-Version: 2.4
Name: HalaGPT
Version: 1.24.1
Summary: Library for interacting with multiple AI APIs
Author: Dark
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
Requires-Dist: user_agent
Requires-Dist: beautifulsoup4
Requires-Dist: pycountry
Requires-Dist: mnemonic
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

HalaGPT

HalaGPT is a free, powerful Python library designed to provide easy access to a variety of advanced AI models and tools. It offers a unified and straightforward interface to interact with multiple AI-powered features such as text generation, voice AI, chatbots, image generation, code assistance, and more — all available for free without complex setup.


---

Installation

Install HalaGPT quickly using pip:

```bash
pip install HalaGPT
```


---

Features and Modules

HalaGPT provides a rich set of AI modules to cover many use cases:

VoiceAi

Generate human-like speech from text using OpenAI-powered voices.

Supported voices: alloy, coral, echo, shimmer, verse, onyx.

Supported styles: friendly, calm, noir_detective, cowboy.

Example:

from HalaGPT import VoiceAi

# Default voice (alloy)
response = VoiceAi.openai("Welcome to the service HalaGPT")
print(response.get("result"))

# Custom voice and style
response = VoiceAi.openai(
    text="hello",
    voice="echo",       # alloy, coral, echo, shimmer, verse, onyx
    style="calm"        # friendly, calm, noir_detective, cowboy
)
print(response.get("result"))


TextAi

DeepInfra models: deepseekv3, deepseekv3x, deepseekr1, deepseekr1base, deepseekr1turbo, deepseekr1llama, deepseekr1qwen, deepseekprover, qwen235, qwen30, qwen32, qwen14, mav, scout, phi-plus, guard, qwq, gemma27, gemma12, llama31, llama332, llama337, mixtral24, phi4, phi-multi, wizard822, wizard27, qwen2572, qwen272, dolphin26, dolphin29, airo70, lzlv70, mixtral822.

Example:

from HalaGPT import TextAi
response = TextAi.DeepInfra("Write a poem about nature.", "deepseekv3")
print(response.get("result"))


WormGpt

DarkGPT and Worm: conversational AI models with special endpoints.


Model31

Access popular LLMs such as grok, gpt-4, gpt-4o, gpt-4-1, gpt-4-1-mini, o4-mini, command-r-plus, gemini-2-5-flash, gemini-2-0-flash-thinking, qwen-2-5-coder-32b, llama-3-3-70b, llama-4-scout, llama-4-scout-17b, mistral-small-3-1-24b, phi-4, and others.


BlackBox

Specialized models for programming and software development tasks.


ModelDeepInfra

Returns the full list of DeepInfra models for dynamic usage.


Developers

Utility functions and info, including developer contacts and quotes.


ImageAi

Supported models: fluex-pro, flux, schnell, imger-12, deepseek, gemini-2-5-pro, blackbox, redux, halagpt-7-i, r1, gpt-4-1.

Generate images from text prompts.


ChatAi

Lightweight chat interface using GPT-3.5.


AzkarApi

Daily Islamic supplications and prayers.


DeepSeekT1

Code generation and understanding assistance.


GeminiApi

Access to Gemini conversational models.



---

How to Use

Basic usage with TextAi module:

from HalaGPT import TextAi

prompt = "Write a short story about friendship."
response = TextAi.DeepInfra(prompt, "deepseekv3")
print(response.get("result", "No response received."))

Listing available models:

from HalaGPT import TextAi
models = TextAi.models()
print("Available TextAi models:", models)


---

Response Handling

Most functions return a dict with at least:

status: "OK", "Error", or "Bad".

result: main output or raw response.

error: error message if applicable.


if response.get("status") == "OK":
    print(response.get("result"))
else:
    print("Error:", response.get("error", "Unknown error"))


---

Telegram Bot Integration

Easily integrate HalaGPT into Telegram bots:

Let users select modules and models.

Respond with AI-generated text, voice, or images.

Customize bot behavior dynamically.



---

Advantages

Free to use: No cost barriers for advanced AI.

Unified library: Multiple AI modules in one package.

Simple API: Start quickly without complex setup.

Multilingual: Supports Arabic and English out of the box.



---

Requirements

Python 3.7+

requests, beautifulsoup4, mnemonic, pycountry, user_agent



---

Contributing & Support

Contributions, bug reports, and feature requests are welcome! Open issues on GitHub or contact the maintainer.


---

Owner's Telegram: https://t.me/sii_3
Owner's Telegram Channel: https://t.me/HalaGPT
Owner's Instagram: https://www.instagram.com/1.44110
