jibayai 0.1.0__tar.gz

jibayai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JibayAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jibayai-0.1.0/PKG-INFO

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: jibayai
+Version: 0.1.0
+Summary: Official-style Python SDK for the JibayAI API
+Author: JibayAI
+License-Expression: MIT
+Project-URL: Homepage, https://jibay.ir/
+Project-URL: Documentation, https://platform.jibay.ir/docs/
+Keywords: jibayai,jibay,ai,chat,image,music,video,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.31
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# JibayAI Python SDK
+
+A small, validated Python client for the JibayAI chat, image, music and video APIs.
+
+## Installation
+
+```bash
+pip install jibayai
+```
+
+## Quick start
+
+```python
+from jibayai import JibayAI
+
+client = JibayAI(api_key="YOUR_API_KEY")
+
+result = client.chat(
+    "Hello, how are you?",
+    model="jibay-5",
+)
+print(result)
+```
+
+You may keep the key outside source code:
+
+```bash
+export JIBAYAI_API_KEY="YOUR_API_KEY"
+```
+
+```python
+from jibayai import JibayAI
+
+client = JibayAI()
+print(client.chat("سلام"))
+```
+
+## Direct functions
+
+For small scripts, the four operations are also available directly on the package:
+
+```python
+import jibayai
+
+result = jibayai.chat(
+    "Hello",
+    api_key="YOUR_API_KEY",
+    model="jibay-5",
+)
+
+image_result = jibayai.image("A futuristic city", api_key="YOUR_API_KEY")
+music_result = jibayai.music("Calm jazz", api_key="YOUR_API_KEY")
+video_result = jibayai.video("Autumn forest", api_key="YOUR_API_KEY")
+```
+
+For repeated calls, prefer one `JibayAI` client so its HTTP connection is reused.
+
+## Chat
+
+```python
+result = client.chat(
+    text="Latest AI news",
+    model="jibay-5",
+    system="Answer clearly and briefly.",
+    chats=[
+        {"role": "user", "text": "My name is Ali"},
+        {"role": "assistant", "text": "Nice to meet you"},
+    ],
+    search_web=True,
+    signal=False,
+    saved_memories={"language": "fa"},
+    mode_official=False,
+)
+```
+
+The documented chat request uses JSON. To support the previous form-encoded integration:
+
+```python
+client = JibayAI(api_key="YOUR_API_KEY", chat_encoding="form")
+# Or only for one request:
+result = client.chat("Hello", encoding="form")
+```
+
+## Image
+
+The API requires a numeric `device`. The SDK generates one automatically when omitted.
+
+```python
+result = client.image("A futuristic city at night")
+# Or:
+result = client.image("A futuristic city at night", device=12345)
+print(result)
+```
+
+## Music
+
+```python
+result = client.music("Calm Persian jazz")
+print(result)
+```
+
+## Video
+
+```python
+result = client.video("An autumn forest with cinematic camera movement")
+print(result)
+```
+
+## Download generated media
+
+Generated media links are temporary, so save the result promptly:
+
+```python
+saved_path = client.download(
+    "https://example.com/temporary-file.mp4",
+    "outputs/video.mp4",
+)
+print(saved_path)
+```
+
+## Validation
+
+The SDK validates API key, text, booleans, chat history, device ID, timeout, retry count, URLs and model identifier syntax before sending a request.
+
+By default, new model names are allowed when their syntax is valid. Enable strict model validation when you need an allow-list:
+
+```python
+client = JibayAI(
+    api_key="YOUR_API_KEY",
+    strict_models=True,
+    supported_models=["jibay-4", "jibay-4.1", "jibay-5"],
+)
+```
+
+## Error handling
+
+```python
+from jibayai import (
+    JibayAI,
+    JibayError,
+    ValidationError,
+    AuthenticationError,
+    RateLimitError,
+    TimeoutError,
+    NetworkError,
+    ServerError,
+)
+
+client = JibayAI(api_key="YOUR_API_KEY")
+
+try:
+    result = client.chat("Hello", model="jibay-5")
+except ValidationError as exc:
+    print("Bad parameter:", exc.parameter, exc)
+except AuthenticationError:
+    print("Check the API key")
+except RateLimitError as exc:
+    print("Rate limited; retry after:", exc.retry_after)
+except TimeoutError:
+    print("Request timed out")
+except NetworkError:
+    print("Network connection failed")
+except ServerError as exc:
+    print("JibayAI server error:", exc.status_code)
+except JibayError as exc:
+    print("Other SDK error:", exc)
+```
+
+## Built-in help
+
+```python
+print(client.help())
+print(client.help("chat"))
+print(client.help("errors"))
+```
+
+## Command line
+
+```bash
+export JIBAYAI_API_KEY="YOUR_API_KEY"
+
+jibayai chat "Hello" --model jibay-5
+jibayai image "A futuristic city"
+jibayai music "Calm jazz"
+jibayai video "Autumn forest"
+jibayai help errors
+```
+
+Use `jibayai --help` and `jibayai <command> --help` for all parameters.
+
+## Local development and test
+
+```bash
+python -m pip install -e .
+python -m unittest discover -s tests -v
+```
+
+## Build
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+## Publish to TestPyPI
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+## Publish to PyPI
+
+```bash
+python -m twine upload dist/*
+```
+
+When Twine asks for credentials, use `__token__` as the username and your complete `pypi-...` token as the password.

jibayai-0.1.0/README.md

@@ -0,0 +1,218 @@
+# JibayAI Python SDK
+
+A small, validated Python client for the JibayAI chat, image, music and video APIs.
+
+## Installation
+
+```bash
+pip install jibayai
+```
+
+## Quick start
+
+```python
+from jibayai import JibayAI
+
+client = JibayAI(api_key="YOUR_API_KEY")
+
+result = client.chat(
+    "Hello, how are you?",
+    model="jibay-5",
+)
+print(result)
+```
+
+You may keep the key outside source code:
+
+```bash
+export JIBAYAI_API_KEY="YOUR_API_KEY"
+```
+
+```python
+from jibayai import JibayAI
+
+client = JibayAI()
+print(client.chat("سلام"))
+```
+
+## Direct functions
+
+For small scripts, the four operations are also available directly on the package:
+
+```python
+import jibayai
+
+result = jibayai.chat(
+    "Hello",
+    api_key="YOUR_API_KEY",
+    model="jibay-5",
+)
+
+image_result = jibayai.image("A futuristic city", api_key="YOUR_API_KEY")
+music_result = jibayai.music("Calm jazz", api_key="YOUR_API_KEY")
+video_result = jibayai.video("Autumn forest", api_key="YOUR_API_KEY")
+```
+
+For repeated calls, prefer one `JibayAI` client so its HTTP connection is reused.
+
+## Chat
+
+```python
+result = client.chat(
+    text="Latest AI news",
+    model="jibay-5",
+    system="Answer clearly and briefly.",
+    chats=[
+        {"role": "user", "text": "My name is Ali"},
+        {"role": "assistant", "text": "Nice to meet you"},
+    ],
+    search_web=True,
+    signal=False,
+    saved_memories={"language": "fa"},
+    mode_official=False,
+)
+```
+
+The documented chat request uses JSON. To support the previous form-encoded integration:
+
+```python
+client = JibayAI(api_key="YOUR_API_KEY", chat_encoding="form")
+# Or only for one request:
+result = client.chat("Hello", encoding="form")
+```
+
+## Image
+
+The API requires a numeric `device`. The SDK generates one automatically when omitted.
+
+```python
+result = client.image("A futuristic city at night")
+# Or:
+result = client.image("A futuristic city at night", device=12345)
+print(result)
+```
+
+## Music
+
+```python
+result = client.music("Calm Persian jazz")
+print(result)
+```
+
+## Video
+
+```python
+result = client.video("An autumn forest with cinematic camera movement")
+print(result)
+```
+
+## Download generated media
+
+Generated media links are temporary, so save the result promptly:
+
+```python
+saved_path = client.download(
+    "https://example.com/temporary-file.mp4",
+    "outputs/video.mp4",
+)
+print(saved_path)
+```
+
+## Validation
+
+The SDK validates API key, text, booleans, chat history, device ID, timeout, retry count, URLs and model identifier syntax before sending a request.
+
+By default, new model names are allowed when their syntax is valid. Enable strict model validation when you need an allow-list:
+
+```python
+client = JibayAI(
+    api_key="YOUR_API_KEY",
+    strict_models=True,
+    supported_models=["jibay-4", "jibay-4.1", "jibay-5"],
+)
+```
+
+## Error handling
+
+```python
+from jibayai import (
+    JibayAI,
+    JibayError,
+    ValidationError,
+    AuthenticationError,
+    RateLimitError,
+    TimeoutError,
+    NetworkError,
+    ServerError,
+)
+
+client = JibayAI(api_key="YOUR_API_KEY")
+
+try:
+    result = client.chat("Hello", model="jibay-5")
+except ValidationError as exc:
+    print("Bad parameter:", exc.parameter, exc)
+except AuthenticationError:
+    print("Check the API key")
+except RateLimitError as exc:
+    print("Rate limited; retry after:", exc.retry_after)
+except TimeoutError:
+    print("Request timed out")
+except NetworkError:
+    print("Network connection failed")
+except ServerError as exc:
+    print("JibayAI server error:", exc.status_code)
+except JibayError as exc:
+    print("Other SDK error:", exc)
+```
+
+## Built-in help
+
+```python
+print(client.help())
+print(client.help("chat"))
+print(client.help("errors"))
+```
+
+## Command line
+
+```bash
+export JIBAYAI_API_KEY="YOUR_API_KEY"
+
+jibayai chat "Hello" --model jibay-5
+jibayai image "A futuristic city"
+jibayai music "Calm jazz"
+jibayai video "Autumn forest"
+jibayai help errors
+```
+
+Use `jibayai --help` and `jibayai <command> --help` for all parameters.
+
+## Local development and test
+
+```bash
+python -m pip install -e .
+python -m unittest discover -s tests -v
+```
+
+## Build
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+## Publish to TestPyPI
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+## Publish to PyPI
+
+```bash
+python -m twine upload dist/*
+```
+
+When Twine asks for credentials, use `__token__` as the username and your complete `pypi-...` token as the password.

jibayai-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jibayai"
+version = "0.1.0"
+description = "Official-style Python SDK for the JibayAI API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "JibayAI" }
+]
+keywords = ["jibayai", "jibay", "ai", "chat", "image", "music", "video", "sdk"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13"
+]
+dependencies = [
+  "requests>=2.31,<3"
+]
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2",
+  "twine>=5",
+  "pytest>=8"
+]
+
+[project.urls]
+Homepage = "https://jibay.ir/"
+Documentation = "https://platform.jibay.ir/docs/"
+
+[project.scripts]
+jibayai = "jibayai.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

jibayai-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

jibayai-0.1.0/src/jibayai/__init__.py

@@ -0,0 +1,49 @@
+"""JibayAI Python SDK public interface."""
+
+from .client import JibayAI
+from .convenience import chat, image, music, video
+from .errors import (
+    APIError,
+    AuthenticationError,
+    BadRequestError,
+    ConfigurationError,
+    ConflictError,
+    InvalidResponseError,
+    JibayError,
+    NetworkError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+    ServerError,
+    TimeoutError,
+    ValidationError,
+)
+from .helptext import sdk_help
+from .version import __version__
+
+Client = JibayAI
+
+__all__ = [
+    "JibayAI",
+    "Client",
+    "chat",
+    "image",
+    "music",
+    "video",
+    "sdk_help",
+    "__version__",
+    "JibayError",
+    "ConfigurationError",
+    "ValidationError",
+    "NetworkError",
+    "TimeoutError",
+    "InvalidResponseError",
+    "APIError",
+    "BadRequestError",
+    "AuthenticationError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "ConflictError",
+    "RateLimitError",
+    "ServerError",
+]

jibayai-0.1.0/src/jibayai/__main__.py

@@ -0,0 +1,112 @@
+"""Command-line interface installed as ``jibayai``."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from typing import Any, List, Optional
+
+from .client import JibayAI
+from .errors import JibayError
+from .helptext import sdk_help
+from .version import __version__
+
+
+def _add_common(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument("--api-key", help="API key; otherwise JIBAYAI_API_KEY is used")
+    parser.add_argument("--base-url", default="https://jibay.ir", help="API base URL")
+    parser.add_argument("--timeout", type=float, default=60.0, help="timeout in seconds")
+    parser.add_argument("--retries", type=int, default=2, help="automatic retry count, 0-10")
+
+
+def _print_result(result: Any) -> None:
+    if isinstance(result, (dict, list)):
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    elif result is None:
+        print("null")
+    else:
+        print(result)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="jibayai",
+        description="JibayAI command-line client for chat, image, music and video.",
+    )
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    chat = sub.add_parser("chat", help="send a chat message")
+    _add_common(chat)
+    chat.add_argument("text", help="message text")
+    chat.add_argument("--model", default="jibay-4.1")
+    chat.add_argument("--system")
+    chat.add_argument("--chats", help="JSON array of prior messages")
+    chat.add_argument("--saved-memories", help="JSON or plain text")
+    chat.add_argument("--search-web", action="store_true")
+    chat.add_argument("--signal", action="store_true")
+    chat.add_argument("--mode-official", action="store_true")
+    chat.add_argument("--encoding", choices=("json", "form"), default="json")
+
+    image = sub.add_parser("image", help="generate an image")
+    _add_common(image)
+    image.add_argument("text", help="image prompt")
+    image.add_argument("--device", type=int)
+
+    music = sub.add_parser("music", help="generate music")
+    _add_common(music)
+    music.add_argument("text", help="music style or prompt")
+
+    video = sub.add_parser("video", help="generate a video")
+    _add_common(video)
+    video.add_argument("text", help="video prompt")
+
+    help_parser = sub.add_parser("help", help="show detailed SDK help")
+    help_parser.add_argument("topic", nargs="?", default="overview")
+    return parser
+
+
+def main(argv: Optional[List[str]] = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if args.command == "help":
+        print(sdk_help(args.topic))
+        return 0
+
+    try:
+        with JibayAI(
+            api_key=args.api_key or os.getenv("JIBAYAI_API_KEY"),
+            base_url=args.base_url,
+            timeout=args.timeout,
+            retries=args.retries,
+            chat_encoding=getattr(args, "encoding", "json"),
+        ) as client:
+            if args.command == "chat":
+                result = client.chat(
+                    args.text,
+                    model=args.model,
+                    system=args.system,
+                    chats=args.chats,
+                    saved_memories=args.saved_memories,
+                    search_web=args.search_web,
+                    signal=args.signal,
+                    mode_official=args.mode_official,
+                    encoding=args.encoding,
+                )
+            elif args.command == "image":
+                result = client.image(args.text, device=args.device)
+            elif args.command == "music":
+                result = client.music(args.text)
+            else:
+                result = client.video(args.text)
+        _print_result(result)
+        return 0
+    except JibayError as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())