Metadata-Version: 2.2
Name: HalaGPT
Version: 1.25.4
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

library 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 synthesis, chatbots, image generation, code assistance, and more — all available without complex setup. You do not need a key or anything like that, it is free. 


---

Installation

Install HalaGPT quickly using pip:

```bash
pip install HalaGPT
```
or:
```bash
python -m pip install HalaGPT
```

Install HalaGPT via GitHub:

``bash
git clone https://github.com/HalaGPT/HalaGPT.git
```


---

Features and Modules

HalaGPT provides a rich set of AI modules to cover many use cases. All classes are imported in lowercase for consistency:

from HalaGPT import voice, image, blackbox, deepinfra, gpt, wormgpt, gemini, chat, deepseek

1. Voice

Generate human-like speech from text.

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

Supported styles: friendly, calm, noir_detective, cowboy


Example:

```python
from HalaGPT import voice

# Default voice
resp = voice.openai("Hello from HalaGPT!")
print(resp.get("result"))

# Custom voice and style
resp = voice.openai(
    text="Welcome to HalaGPT voice service",
    voice="echo",
    style="calm"
)
print(resp.get("result"))
```
2. Image

Generate images from text prompts.

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


Example:

```python
from HalaGPT import image

resp = image.generate(
    prompt="A futuristic city skyline at sunset",
    model="imger-12"
)
print(resp.get("result"))
```

3. BlackBox

Specialized models for programming and development tasks.

Supported models: python, html, react, flask, fastapi, docker, git, and many more.


Example:

```python
from HalaGPT import blackbox

# Generate a Flask hello world app
resp = blackbox.ask(
    text="Create a Flask 'Hello World' app",
    model="python"
)
print(resp.get("result"))
```

4. DeepInfra

Access DeepInfra text models for advanced text tasks.

Supported models: deepseekv3, deepseekr1, qwen30, scout, phi-plus, wizard822, and more.


Example:

```python
from HalaGPT import deepinfra

resp = deepinfra.ask(
    text="Explain the theory of relativity in simple terms",
    model="deepseekv3"
)
print(resp.get("result"))
```

5. GPT

Unified access to popular GPT-style models.

Supported models: gpt-4, gpt-4o, gpt-4-1, gpt-voice, llama8, mistral, phi, qwen, gpt-music, o3, and more.


Example:

```python
from HalaGPT import gpt

resp = gpt.ask(
    text="What is artificial intelligence?",
    model="gpt-4o"
)
print(resp.get("result"))
```

6. WormGPT

DarkGPT and Worm endpoints for specialized conversational AI.

Example:

```python
from HalaGPT import wormgpt

resp1 = wormgpt.worm("Generate a random sci-fi plot outline")
print(resp1.get("result"))

resp2 = wormgpt.darkgpt("Write a compelling resume in Arabic")
print(resp2.get("result"))
```

7. Gemini

Access Google Gemini conversational models.

Example:

```python
from HalaGPT import gemini

resp = gemini.ask("Analyze the current crypto market trends.")
print(resp.get("result"))
```

8. Chat

Lightweight chat interface using OpenAI GPT-3.5.

Example:

```python
from HalaGPT import chat

resp = chat.ask("Who founded Apple Inc.?")
print(resp.get("result"))
```
9. DeepSeek

Code generation and understanding assistance.

Example:

```python
from HalaGPT import deepseek

resp = deepseek.codeify("Build a login page with HTML and JavaScript")
print(resp.get("result"))
```

---

Response Handling

Most functions return a dict with the following fields:

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

result: Main output or raw response

error: Error message (if any)


Example:

```python
resp = gpt.ask("Tell me a joke", model="gpt-4")
if resp.get("status") == "OK":
    print(resp.get("result"))
else:
    print("Error:", resp.get("error", "Unknown error"))
```

---

Telegram Bot Integration

Easily integrate HalaGPT into Telegram bots:

```python
from HalaGPT import voice, chat, image
from telegram import Bot, Update
from telegram.ext import Updater, CommandHandler, MessageHandler, Filters

def start(update: Update, context):
    update.message.reply_text("Welcome to HalaGPT bot!")

# Example: echo with GPT
def handle_text(update: Update, context):
    user_text = update.message.text
    resp = chat.ask(user_text)
    update.message.reply_text(resp.get("result"))

updater = Updater("YOUR_TELEGRAM_TOKEN")
updater.dispatcher.add_handler(CommandHandler("start", start))
updater.dispatcher.add_handler(MessageHandler(Filters.text, handle_text))
updater.start_polling()
updater.idle()
```


---

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 Without a key or anything like that, just send the request and you will receive a response. 

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.


---

Contact

> owner Telegram: https://t.me/sii_3
> owner Telegram Channel: https://t.me/HalaGPT
> owner Instagram: https://www.instagram.com/1.44110