Skip to main content

Library for interacting with multiple AI APIs

Project description

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:

pip install HalaGPT

or:

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"))
  1. 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:

from HalaGPT import image

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

Specialized models for programming and development tasks.

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

Example:

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"))
  1. DeepInfra

Access DeepInfra text models for advanced text tasks.

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

Example:

from HalaGPT import deepinfra

resp = deepinfra.ask(
    text="Explain the theory of relativity in simple terms",
    model="deepseekv3"
)
print(resp.get("result"))
  1. 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:

from HalaGPT import gpt

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

DarkGPT and Worm endpoints for specialized conversational AI.

Example:

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"))
  1. Gemini

Access Google Gemini conversational models.

Example:

from HalaGPT import gemini

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

Lightweight chat interface using OpenAI GPT-3.5.

Example:

from HalaGPT import chat

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

Code generation and understanding assistance.

Example:

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:

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:

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

halagpt-1.25.7.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

HalaGPT-1.25.7-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file halagpt-1.25.7.tar.gz.

File metadata

  • Download URL: halagpt-1.25.7.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for halagpt-1.25.7.tar.gz
Algorithm Hash digest
SHA256 926964308157b6b4265909fe1675f1f87d97cf2e25386d3be087b8285ac802bb
MD5 48ac399fe38731a02fc65f8ea04c9eef
BLAKE2b-256 15fafe7358f79edc718d2d2f5c6347ad3893bdc405c7ac5d9f7abdda7a804d17

See more details on using hashes here.

File details

Details for the file HalaGPT-1.25.7-py3-none-any.whl.

File metadata

  • Download URL: HalaGPT-1.25.7-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for HalaGPT-1.25.7-py3-none-any.whl
Algorithm Hash digest
SHA256 5eb310d1838628ae93d50ca231104d001eece2ccd96e1824d108f6e7a9d42910
MD5 5436d454f31e88d682b4b2722a055403
BLAKE2b-256 91d84d1512e6d67fcef52c8560ea8afc76d1308ce5a0f1cd478584c51302c1e4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page