HalaGPT


NameHalaGPT JSON
Version 1.25.7 PyPI version JSON
download
home_pageNone
SummaryLibrary for interacting with multiple AI APIs
upload_time2025-07-12 10:44:37
maintainerNone
docs_urlNone
authorDark
requires_python>=3.6
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            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


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "HalaGPT",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": null,
    "author": "Dark",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/15/fa/fe7358f79edc718d2d2f5c6347ad3893bdc405c7ac5d9f7abdda7a804d17/halagpt-1.25.7.tar.gz",
    "platform": null,
    "description": "library HalaGPT\n\nHalaGPT 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 \u2014 all available without complex setup. You do not need a key or anything like that, it is free. \n\n\n---\n\nInstallation\n\nInstall HalaGPT quickly using pip:\n\n```bash\npip install HalaGPT\n```\nor:\n```bash\npython -m pip install HalaGPT\n```\n\nInstall HalaGPT via GitHub:\n\n``bash\ngit clone https://github.com/HalaGPT/HalaGPT.git\n```\n\n\n---\n\nFeatures and Modules\n\nHalaGPT provides a rich set of AI modules to cover many use cases. All classes are imported in lowercase for consistency:\n\nfrom HalaGPT import voice, image, blackbox, deepinfra, gpt, wormgpt, gemini, chat, deepseek\n\n1. Voice\n\nGenerate human-like speech from text.\n\nSupported voices: alloy, coral, echo, shimmer, verse, onyx\n\nSupported styles: friendly, calm, noir_detective, cowboy\n\n\nExample:\n\n```python\nfrom HalaGPT import voice\n\n# Default voice\nresp = voice.openai(\"Hello from HalaGPT!\")\nprint(resp.get(\"result\"))\n\n# Custom voice and style\nresp = voice.openai(\n    text=\"Welcome to HalaGPT voice service\",\n    voice=\"echo\",\n    style=\"calm\"\n)\nprint(resp.get(\"result\"))\n```\n2. Image\n\nGenerate images from text prompts.\n\nSupported models: fluex-pro, flux, schnell, imger-12, deepseek, gemini-2-5-pro, blackbox, redux, halagpt-7-i, r1, gpt-4-1\n\n\nExample:\n\n```python\nfrom HalaGPT import image\n\nresp = image.generate(\n    prompt=\"A futuristic city skyline at sunset\",\n    model=\"imger-12\"\n)\nprint(resp.get(\"result\"))\n```\n\n3. BlackBox\n\nSpecialized models for programming and development tasks.\n\nSupported models: python, html, react, flask, fastapi, docker, git, and many more.\n\n\nExample:\n\n```python\nfrom HalaGPT import blackbox\n\n# Generate a Flask hello world app\nresp = blackbox.ask(\n    text=\"Create a Flask 'Hello World' app\",\n    model=\"python\"\n)\nprint(resp.get(\"result\"))\n```\n\n4. DeepInfra\n\nAccess DeepInfra text models for advanced text tasks.\n\nSupported models: deepseekv3, deepseekr1, qwen30, scout, phi-plus, wizard822, and more.\n\n\nExample:\n\n```python\nfrom HalaGPT import deepinfra\n\nresp = deepinfra.ask(\n    text=\"Explain the theory of relativity in simple terms\",\n    model=\"deepseekv3\"\n)\nprint(resp.get(\"result\"))\n```\n\n5. GPT\n\nUnified access to popular GPT-style models.\n\nSupported models: gpt-4, gpt-4o, gpt-4-1, gpt-voice, llama8, mistral, phi, qwen, gpt-music, o3, and more.\n\n\nExample:\n\n```python\nfrom HalaGPT import gpt\n\nresp = gpt.ask(\n    text=\"What is artificial intelligence?\",\n    model=\"gpt-4o\"\n)\nprint(resp.get(\"result\"))\n```\n\n6. WormGPT\n\nDarkGPT and Worm endpoints for specialized conversational AI.\n\nExample:\n\n```python\nfrom HalaGPT import wormgpt\n\nresp1 = wormgpt.worm(\"Generate a random sci-fi plot outline\")\nprint(resp1.get(\"result\"))\n\nresp2 = wormgpt.darkgpt(\"Write a compelling resume in Arabic\")\nprint(resp2.get(\"result\"))\n```\n\n7. Gemini\n\nAccess Google Gemini conversational models.\n\nExample:\n\n```python\nfrom HalaGPT import gemini\n\nresp = gemini.ask(\"Analyze the current crypto market trends.\")\nprint(resp.get(\"result\"))\n```\n\n8. Chat\n\nLightweight chat interface using OpenAI GPT-3.5.\n\nExample:\n\n```python\nfrom HalaGPT import chat\n\nresp = chat.ask(\"Who founded Apple Inc.?\")\nprint(resp.get(\"result\"))\n```\n9. DeepSeek\n\nCode generation and understanding assistance.\n\nExample:\n\n```python\nfrom HalaGPT import deepseek\n\nresp = deepseek.codeify(\"Build a login page with HTML and JavaScript\")\nprint(resp.get(\"result\"))\n```\n\n---\n\nResponse Handling\n\nMost functions return a dict with the following fields:\n\n```\nstatus: \"OK\", \"Error\", or \"Bad\"\n```\n\nresult: Main output or raw response\n\nerror: Error message (if any)\n\n\nExample:\n\n```python\nresp = gpt.ask(\"Tell me a joke\", model=\"gpt-4\")\nif resp.get(\"status\") == \"OK\":\n    print(resp.get(\"result\"))\nelse:\n    print(\"Error:\", resp.get(\"error\", \"Unknown error\"))\n```\n\n---\n\nTelegram Bot Integration\n\nEasily integrate HalaGPT into Telegram bots:\n\n```python\nfrom HalaGPT import voice, chat, image\nfrom telegram import Bot, Update\nfrom telegram.ext import Updater, CommandHandler, MessageHandler, Filters\n\ndef start(update: Update, context):\n    update.message.reply_text(\"Welcome to HalaGPT bot!\")\n\n# Example: echo with GPT\ndef handle_text(update: Update, context):\n    user_text = update.message.text\n    resp = chat.ask(user_text)\n    update.message.reply_text(resp.get(\"result\"))\n\nupdater = Updater(\"YOUR_TELEGRAM_TOKEN\")\nupdater.dispatcher.add_handler(CommandHandler(\"start\", start))\nupdater.dispatcher.add_handler(MessageHandler(Filters.text, handle_text))\nupdater.start_polling()\nupdater.idle()\n```\n\n\n---\n\nAdvantages\n\nFree to use: No cost barriers for advanced AI.\n\nUnified library: Multiple AI modules in one package.\n\nSimple API: Start quickly without complex setup Without a key or anything like that, just send the request and you will receive a response. \n\nMultilingual: Supports Arabic and English out of the box.\n\n\n---\n\nRequirements\n\n```\nPython 3.7+\n```\n\nrequests\n\nbeautifulsoup4\n\nmnemonic\n\npycountry\n\nuser_agent\n\n\n\n---\n\nContributing & Support\n\nContributions, bug reports, and feature requests are welcome! Open issues on GitHub or contact the maintainer.\n\n\n---\n\nContact\n\n> owner Telegram: https://t.me/sii_3\n> owner Telegram Channel: https://t.me/HalaGPT\n> owner Instagram: https://www.instagram.com/1.44110\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Library for interacting with multiple AI APIs",
    "version": "1.25.7",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "91d84d1512e6d67fcef52c8560ea8afc76d1308ce5a0f1cd478584c51302c1e4",
                "md5": "5436d454f31e88d682b4b2722a055403",
                "sha256": "5eb310d1838628ae93d50ca231104d001eece2ccd96e1824d108f6e7a9d42910"
            },
            "downloads": -1,
            "filename": "HalaGPT-1.25.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5436d454f31e88d682b4b2722a055403",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 5124,
            "upload_time": "2025-07-12T10:44:35",
            "upload_time_iso_8601": "2025-07-12T10:44:35.715183Z",
            "url": "https://files.pythonhosted.org/packages/91/d8/4d1512e6d67fcef52c8560ea8afc76d1308ce5a0f1cd478584c51302c1e4/HalaGPT-1.25.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "15fafe7358f79edc718d2d2f5c6347ad3893bdc405c7ac5d9f7abdda7a804d17",
                "md5": "48ac399fe38731a02fc65f8ea04c9eef",
                "sha256": "926964308157b6b4265909fe1675f1f87d97cf2e25386d3be087b8285ac802bb"
            },
            "downloads": -1,
            "filename": "halagpt-1.25.7.tar.gz",
            "has_sig": false,
            "md5_digest": "48ac399fe38731a02fc65f8ea04c9eef",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 5091,
            "upload_time": "2025-07-12T10:44:37",
            "upload_time_iso_8601": "2025-07-12T10:44:37.287407Z",
            "url": "https://files.pythonhosted.org/packages/15/fa/fe7358f79edc718d2d2f5c6347ad3893bdc405c7ac5d9f7abdda7a804d17/halagpt-1.25.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-12 10:44:37",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "halagpt"
}
        
Elapsed time: 0.48113s