PyiMAi 5.0.0

PyiMAi is a lightweight AI-powered CLI tool that allows you to interact with an AI model directly from your terminal, with optional image support.

PyMind

PyiMAi is a lightweight AI-powered CLI tool that allows you to interact with an AI model directly from your terminal, with optional image support.

🚀 Features

• 💬 Chat with AI from your terminal
• 🖼️ Send images along with prompts
• ☁️ Upload images and get public URLs
• ⚡ Simple CLI interface
• 🧠 Works with or without images
• 📦 Ready to use as a Python library or CLI tool

📦 Installation

• Clone the project:

git clone https://github.com/DevZ44d/PyiMAi.git

• Via PyPi

pip install pyimai -U

🧠 Usage Example (Class Ai)

• Chatting with Artificial Intelligence (AI). I

from pyimai import Ask
def main():
    prompt: Ask= Ask(
        prompt="Hello, what is this?", 
        filepath=["download.jpg"] #you can add multi photos (local)
    )

    print(prompt.chat())

if __name__ == "__main__":
    main()

• Uploading Image Online .

from pyimai import Upload


def main():
    _: Upload = Upload(
        filepath=["download.jpg"],  # you can add multi photos (required)
        expiration=15552000,  # automatically deleted after a certain time (in seconds, 60-15552000). (optional)
        key=""                # i default added one, so delete this argument (optional)
    )

    print(_.get_info())


if __name__ == "__main__":
    main()

Example response (Class Ai) (JSON)

{
    "request": "Hello, what is this ? and solve it .",
    "response": "This is a Math Olympiad question asking to solve the equation:\n\na^3 + a^2 = 36\n\nWe need to find the value of a that satisfies this equation.\n\nLet's solve it step-by-step:\n\n1. Rewrite the equation:\na^3 + a^2 = 36\n\n2. Factor out a^2:\na^2(a + 1) = 36\n\n3. Now, we look for integer values of a that satisfy this equation because Math Olympiad problems often expect integer or simple rational solutions.\n\nTry a = 2:\n2^2 × (2 + 1) = 4 × 3 = 12 ≠ 36\n\nTry a = 3:\n3^2 × (3 + 1) = 9 × 4 = 36\n\nThis works perfectly.\n\nSo, a = 3 is a solution.\n\nAnswer:\na = 3"
}

---

Example response (Class Upload) (JSON)

[
    {
        "data": {
            "delete_url": "https://ibb.co/twK1wYrW/db713ad7cde63f41189c589710396be2",
            "display_url": "https://i.ibb.co/MySJyP03/download.jpg",
            "expiration": 15552000,
            "height": 168,
            "id": "twK1wYrW",
            "image": {
                "extension": "jpg",
                "filename": "download.jpg",
                "mime": "image/jpeg",
                "name": "download",
                "url": "https://i.ibb.co/MySJyP03/download.jpg"
            },
            "size": 7895,
            "thumb": {
                "extension": "jpg",
                "filename": "download.jpg",
                "mime": "image/jpeg",
                "name": "download",
                "url": "https://i.ibb.co/twK1wYrW/download.jpg"
            },
            "time": 1765918544,
            "title": "download",
            "url": "https://i.ibb.co/MySJyP03/download.jpg",
            "url_viewer": "https://ibb.co/twK1wYrW",
            "width": 299
        },
        "status": 200,
        "success": true
    }
]

Class Terminal 🧠

pyimai -[OPTIONS] "[FOR-OPTION]"

Arguments:	           - Description:
    -p, --prompt	      Send a prompt to the AI
    -f, --filepath	      Image path (optional)
    -u, --upload	      Upload image only
    -e, --expiration	  default = 600 , Image expiration time (seconds)
    -k, --key             default i added one, The API key.
    -v, --version	      Show version
    -h, --help	          Show help

🚀 Usage (Class Terminal)

• 🔹Send a normal text prompt (no image required):

pyimai -p "hello"

• 🔹Ask the AI about an image:

pyimai -p "what is this?" -f "photo.jpg" # image must be in directory

• 🔹 Upload an image and get its public URL:

pyimai -u "photo.jpg"

• 🔹 Show version:

pyimai -v

• 🔹 Show help:

pyimai -h

💬 Help & Support .

• Follow updates via the Telegram Channel.
• For general questions and help, join our Telegram chat.