mayia-ai 0.1.1__tar.gz

mayia_ai-0.1.1/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026 ORF (Filip O.)
+
+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.

mayia_ai-0.1.1/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: mayia-ai
+Version: 0.1.1
+Summary: Official Python SDK for the Mayia AI API
+Author: ORF (Filip O.)
+License: MIT
+Project-URL: Homepage, https://ai-mayia.web.app
+Project-URL: Documentation, https://ai-mayia.web.app/api-center
+Keywords: mayia,ai,sdk,api,llm
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Mayia Python SDK
+
+Official Python client for the Mayia API.
+
+## Install
+
+```bash
+pip install mayia-ai
+```
+
+## Quick start
+
+```python
+from mayia import api
+
+client = api(api_key="mayia_sk_...")
+print(client.ask("Explain quantum computing simply."))
+```
+
+OpenAI-style chat:
+
+```python
+from mayia import Mayia
+
+client = Mayia(api_key="mayia_sk_...")
+response = client.chat.completions.create(
+    model="mayia-1",
+    messages=[{"role": "user", "content": "Build a Flask API."}],
+)
+print(response.content)
+```
+
+Environment variables:
+
+- `MAYIA_API_KEY`
+- `MAYIA_API_URL` (default: `https://ai-mayia.web.app/api`)
+
+> Keep API keys server-side. Never ship a secret Mayia API key in a public website, Roblox LocalScript, downloadable game client, or mobile bundle.

mayia_ai-0.1.1/README.md

@@ -0,0 +1,38 @@
+# Mayia Python SDK
+
+Official Python client for the Mayia API.
+
+## Install
+
+```bash
+pip install mayia-ai
+```
+
+## Quick start
+
+```python
+from mayia import api
+
+client = api(api_key="mayia_sk_...")
+print(client.ask("Explain quantum computing simply."))
+```
+
+OpenAI-style chat:
+
+```python
+from mayia import Mayia
+
+client = Mayia(api_key="mayia_sk_...")
+response = client.chat.completions.create(
+    model="mayia-1",
+    messages=[{"role": "user", "content": "Build a Flask API."}],
+)
+print(response.content)
+```
+
+Environment variables:
+
+- `MAYIA_API_KEY`
+- `MAYIA_API_URL` (default: `https://ai-mayia.web.app/api`)
+
+> Keep API keys server-side. Never ship a secret Mayia API key in a public website, Roblox LocalScript, downloadable game client, or mobile bundle.

mayia_ai-0.1.1/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mayia-ai"
+version = "0.1.1"
+description = "Official Python SDK for the Mayia AI API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "ORF (Filip O.)"}]
+keywords = ["mayia", "ai", "sdk", "api", "llm"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://ai-mayia.web.app"
+Documentation = "https://ai-mayia.web.app/api-center"
+
+[project.scripts]
+mayia = "mayia.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

mayia_ai-0.1.1/setup.cfg

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

mayia_ai-0.1.1/src/mayia/__init__.py

@@ -0,0 +1,4 @@
+from .client import Mayia, MayiaError, MayiaResponse, api
+
+__all__ = ["Mayia", "MayiaError", "MayiaResponse", "api"]
+__version__ = "0.1.1"

mayia_ai-0.1.1/src/mayia/cli.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from .client import Mayia, MayiaError
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="mayia", description="Mayia AI CLI")
+    parser.add_argument("prompt", nargs="*", help="Prompt to send to Mayia")
+    parser.add_argument("--model", default="mayia-1")
+    parser.add_argument("--api-key")
+    parser.add_argument("--base-url")
+    parser.add_argument("--verify", action="store_true")
+    parser.add_argument("--models", action="store_true")
+    parser.add_argument("--json", action="store_true")
+    args = parser.parse_args()
+
+    kwargs = {"api_key": args.api_key}
+    if args.base_url:
+        kwargs["base_url"] = args.base_url
+    try:
+        client = Mayia(**kwargs)
+        if args.verify:
+            result = client.verify()
+            print(json.dumps(result, indent=2) if args.json else result)
+            return
+        if args.models:
+            result = client.models()
+            print(json.dumps(result, indent=2) if args.json else result)
+            return
+        prompt = " ".join(args.prompt).strip()
+        if not prompt:
+            parser.error("Provide a prompt, --verify, or --models")
+        result = client.ask(prompt, model=args.model)
+        print(json.dumps(result.raw, indent=2) if args.json else result.content)
+    except MayiaError as exc:
+        print(f"Mayia error: {exc}", file=sys.stderr)
+        raise SystemExit(1)
+
+
+if __name__ == "__main__":
+    main()

mayia_ai-0.1.1/src/mayia/client.py

@@ -0,0 +1,178 @@
+from __future__ import annotations
+
+import json
+import os
+import urllib.error
+import urllib.request
+from dataclasses import dataclass
+from typing import Any, Dict, Iterable, List, Mapping, Optional
+
+DEFAULT_BASE_URL = os.getenv("MAYIA_API_URL", "https://ai-mayia.web.app/api")
+
+
+class MayiaError(RuntimeError):
+    def __init__(self, message: str, *, status: Optional[int] = None, payload: Any = None):
+        super().__init__(message)
+        self.status = status
+        self.payload = payload
+
+
+@dataclass
+class MayiaResponse:
+    id: Optional[str]
+    model: Optional[str]
+    content: str
+    raw: Dict[str, Any]
+
+    def __str__(self) -> str:
+        return self.content
+
+
+class _Completions:
+    def __init__(self, client: "Mayia") -> None:
+        self._client = client
+
+    def create(
+        self,
+        *,
+        model: str = "mayia-1",
+        messages: Iterable[Mapping[str, str]],
+        temperature: Optional[float] = None,
+        max_tokens: Optional[int] = None,
+        extra: Optional[Mapping[str, Any]] = None,
+    ) -> MayiaResponse:
+        body: Dict[str, Any] = {
+            "model": model,
+            "messages": list(messages),
+        }
+        if temperature is not None:
+            body["temperature"] = temperature
+        if max_tokens is not None:
+            body["max_tokens"] = max_tokens
+        if extra:
+            body.update(dict(extra))
+        raw = self._client._request("POST", "/v1/chat/completions", body)
+        return _to_response(raw)
+
+
+class _Chat:
+    def __init__(self, client: "Mayia") -> None:
+        self.completions = _Completions(client)
+
+
+class _Plugins:
+    def __init__(self, client: "Mayia") -> None:
+        self._client = client
+
+    def list(self) -> Dict[str, Any]:
+        return self._client._request("GET", "/v1/plugins")
+
+    def get(self, plugin_id: str) -> Dict[str, Any]:
+        return self._client._request("GET", f"/v1/plugins/{plugin_id}")
+
+    def configure(self, plugin_id: str, config: Mapping[str, Any]) -> Dict[str, Any]:
+        return self._client._request("PUT", f"/v1/plugins/{plugin_id}", dict(config))
+
+
+class _Account:
+    def __init__(self, client: "Mayia") -> None:
+        self._client = client
+
+    def me(self) -> Dict[str, Any]:
+        return self._client._request("GET", "/v1/account")
+
+
+class Mayia:
+    """Official Mayia API client.
+
+    Keep API keys server-side. Do not embed secret keys into public browser/game client code.
+    """
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 60.0,
+        user_agent: str = "mayia-python/0.1.1",
+    ) -> None:
+        self.api_key = api_key or os.getenv("MAYIA_API_KEY")
+        if not self.api_key:
+            raise MayiaError("Missing Mayia API key. Pass api_key=... or set MAYIA_API_KEY.")
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.user_agent = user_agent
+        self.chat = _Chat(self)
+        self.plugins = _Plugins(self)
+        self.account = _Account(self)
+
+    def health(self) -> Dict[str, Any]:
+        return self._request("GET", "/health", auth=False)
+
+    def models(self) -> Dict[str, Any]:
+        return self._request("GET", "/v1/models")
+
+    def verify(self) -> Dict[str, Any]:
+        return self._request("POST", "/v1/verify", {"message": "Mayia SDK verification"})
+
+    def ask(self, message: str, *, model: str = "mayia-1", system: Optional[str] = None) -> MayiaResponse:
+        messages: List[Dict[str, str]] = []
+        if system:
+            messages.append({"role": "system", "content": system})
+        messages.append({"role": "user", "content": message})
+        return self.chat.completions.create(model=model, messages=messages)
+
+    def _request(self, method: str, path: str, body: Optional[Mapping[str, Any]] = None, *, auth: bool = True) -> Dict[str, Any]:
+        url = self.base_url + (path if path.startswith("/") else "/" + path)
+        data = None if body is None else json.dumps(dict(body)).encode("utf-8")
+        headers = {
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+            "User-Agent": self.user_agent,
+        }
+        if auth:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+            headers["X-Mayia-API-Key"] = self.api_key
+        req = urllib.request.Request(url, data=data, headers=headers, method=method.upper())
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as response:
+                text = response.read().decode("utf-8")
+                if not text:
+                    return {}
+                parsed = json.loads(text)
+                return parsed if isinstance(parsed, dict) else {"data": parsed}
+        except urllib.error.HTTPError as exc:
+            payload_text = exc.read().decode("utf-8", errors="replace")
+            try:
+                payload = json.loads(payload_text)
+            except Exception:
+                payload = payload_text
+            message = payload.get("error") if isinstance(payload, dict) else payload_text
+            if isinstance(message, dict):
+                message = message.get("message") or str(message)
+            raise MayiaError(str(message or f"Mayia API returned HTTP {exc.code}"), status=exc.code, payload=payload) from exc
+        except urllib.error.URLError as exc:
+            raise MayiaError(f"Could not reach Mayia API at {self.base_url}: {exc.reason}") from exc
+        except json.JSONDecodeError as exc:
+            raise MayiaError("Mayia API returned invalid JSON.") from exc
+
+
+def _to_response(raw: Dict[str, Any]) -> MayiaResponse:
+    content = ""
+    try:
+        content = raw["choices"][0]["message"]["content"]
+    except Exception:
+        content = raw.get("content") or raw.get("response") or raw.get("message") or ""
+        if isinstance(content, dict):
+            content = content.get("content", "")
+    return MayiaResponse(
+        id=raw.get("id"),
+        model=raw.get("model"),
+        content=str(content),
+        raw=raw,
+    )
+
+
+def api(api_key: Optional[str] = None, **kwargs: Any) -> Mayia:
+    """Short factory matching `from mayia import api` usage."""
+    return Mayia(api_key=api_key, **kwargs)

mayia_ai-0.1.1/src/mayia_ai.egg-info/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: mayia-ai
+Version: 0.1.1
+Summary: Official Python SDK for the Mayia AI API
+Author: ORF (Filip O.)
+License: MIT
+Project-URL: Homepage, https://ai-mayia.web.app
+Project-URL: Documentation, https://ai-mayia.web.app/api-center
+Keywords: mayia,ai,sdk,api,llm
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Mayia Python SDK
+
+Official Python client for the Mayia API.
+
+## Install
+
+```bash
+pip install mayia-ai
+```
+
+## Quick start
+
+```python
+from mayia import api
+
+client = api(api_key="mayia_sk_...")
+print(client.ask("Explain quantum computing simply."))
+```
+
+OpenAI-style chat:
+
+```python
+from mayia import Mayia
+
+client = Mayia(api_key="mayia_sk_...")
+response = client.chat.completions.create(
+    model="mayia-1",
+    messages=[{"role": "user", "content": "Build a Flask API."}],
+)
+print(response.content)
+```
+
+Environment variables:
+
+- `MAYIA_API_KEY`
+- `MAYIA_API_URL` (default: `https://ai-mayia.web.app/api`)
+
+> Keep API keys server-side. Never ship a secret Mayia API key in a public website, Roblox LocalScript, downloadable game client, or mobile bundle.

mayia_ai-0.1.1/src/mayia_ai.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/mayia/__init__.py
+src/mayia/cli.py
+src/mayia/client.py
+src/mayia_ai.egg-info/PKG-INFO
+src/mayia_ai.egg-info/SOURCES.txt
+src/mayia_ai.egg-info/dependency_links.txt
+src/mayia_ai.egg-info/entry_points.txt
+src/mayia_ai.egg-info/top_level.txt

mayia_ai-0.1.1/src/mayia_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mayia_ai-0.1.1/src/mayia_ai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mayia = mayia.cli:main

mayia_ai-0.1.1/src/mayia_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+mayia