euriai 0.2.0__py3-none-any.whl

euriai/__init__.py

@@ -0,0 +1 @@
+from .client import EuriaiClient

euriai/cli.py

@@ -0,0 +1,66 @@
+import argparse
+from euriai import EuriaiClient
+
+def show_model_help():
+    print("\n📚 Available Models & Recommendations:\n")
+    print(f"{'Provider':<10} {'Model Name':<30} {'ID':<40} {'Best For'}")
+    print("-" * 110)
+    models = [
+        ("OpenAI", "GPT 4.1 Nano", "gpt-4.1-nano", "Fast replies, chatbots"),
+        ("OpenAI", "GPT 4.1 Mini", "gpt-4.1-mini", "Smarter gen, code"),
+        ("Google", "Gemini 2.5 Pro Exp", "gemini-2.5-pro-exp-03-25", "Complex tasks, code, LLM agents"),
+        ("Google", "Gemini 2.0 Flash", "gemini-2.0-flash-001", "Summarization, short Q&A"),
+        ("Meta", "Llama 4 Scout", "llama-4-scout-17b-16e-instruct", "Light assistant, ideas"),
+        ("Meta", "Llama 4 Maverick", "llama-4-maverick-17b-128e-instruct", "Heavy reasoning, long answers"),
+        ("Meta", "Llama 3.3 70B", "llama-3.3-70b-versatile", "Balanced all-round use"),
+        ("DeepSeek", "Deepseek R1 Distilled 70B", "deepseek-r1-distill-llama-70b", "Creative, brainstorming"),
+        ("Qwen", "Qwen QwQ 32B", "qwen-qwq-32b", "Multilingual, logic"),
+        ("Mistral", "Mistral Saba 24B", "mistral-saba-24b", "Summarization, code"),
+    ]
+    for provider, name, model_id, task in models:
+        print(f"{provider:<10} {name:<30} {model_id:<40} {task}")
+    
+    print("\n🌡️ Suggested Temperatures:")
+    print("- 0.2 – 0.4: Deterministic (facts, code)")
+    print("- 0.5 – 0.7: Balanced (Q&A, general content) [Default: 0.7]")
+    print("- 0.8 – 1.0: Creative (poems, storytelling)")
+
+    print("\n🔢 Suggested Max Tokens:")
+    print("- 100–300: Short answers / classification")
+    print("- 300–600: Summarization / Q&A")
+    print("- 800–2000: Long-form content")
+
+    print("\n💡 Use:")
+    print("euriai --api_key <KEY> --prompt 'Hello AI' --model gpt-4.1-nano --temperature 0.7\n")
+
+def main():
+    parser = argparse.ArgumentParser(description="Run euriai client")
+    parser.add_argument("--api_key", help="Your EURI API Key")
+    parser.add_argument("--prompt", help="Prompt to send to the model")
+    parser.add_argument("--model", default="gpt-4.1-nano", help="Model ID to use")
+    parser.add_argument("--temperature", type=float, default=0.7, help="Sampling temperature")
+    parser.add_argument("--max_tokens", type=int, default=500, help="Max number of tokens")
+    parser.add_argument("--stream", action="store_true", help="Enable streaming output")
+    parser.add_argument("--models", action="store_true", help="Show all model IDs and suggestions")
+
+    args = parser.parse_args()
+
+    if args.models:
+        show_model_help()
+        return
+
+    if not args.api_key or not args.prompt:
+        parser.error("--api_key and --prompt are required unless using --models")
+
+    client = EuriaiClient(api_key=args.api_key, model=args.model)
+
+    if args.stream:
+        print("🔁 Streaming response:\n")
+        for chunk in client.stream_completion(args.prompt, temperature=args.temperature, max_tokens=args.max_tokens):
+            print(chunk, end='', flush=True)
+    else:
+        result = client.generate_completion(args.prompt, temperature=args.temperature, max_tokens=args.max_tokens)
+        print("✅ Response:\n", result)
+
+if __name__ == "__main__":
+    main()

euriai/client.py

@@ -0,0 +1,115 @@
+import requests
+from typing import Optional, Dict, Any
+
+class EuriaiClient:
+    def __init__(
+        self,
+        api_key: str,
+        model: str = "gpt-4.1-nano",
+        endpoint: str = "https://api.euron.one/api/v1/euri/alpha/chat/completions"
+    ):
+        """
+        Initializes the EuriaiClient.
+
+        Args:
+            api_key (str): Your EURI API key.
+            model (str, optional): Model ID to use (e.g., 'gpt-4.1-nano', 'gemini-2.0-flash-001').
+            endpoint (str, optional): API endpoint URL.
+        """
+        self.api_key = api_key
+        self.model = model
+        self.endpoint = endpoint
+
+    def generate_completion(
+        self,
+        prompt: str,
+        temperature: float = 0.7,
+        max_tokens: int = 500,
+        top_p: Optional[float] = None,
+        frequency_penalty: Optional[float] = None,
+        presence_penalty: Optional[float] = None,
+        stop: Optional[list[str]] = None,
+    ) -> Dict[str, Any]:
+        """
+        Generates a non-streamed completion from the model.
+
+        Args:
+            prompt (str): The user's prompt to send to the model.
+            temperature (float, optional): Sampling temperature (0.2–1.0). Defaults to 0.7.
+            max_tokens (int, optional): Maximum number of output tokens. Defaults to 500.
+            top_p (float, optional): Nucleus sampling value.
+            frequency_penalty (float, optional): Penalizes repetition.
+            presence_penalty (float, optional): Encourages new topic generation.
+            stop (list of str, optional): Stop sequences to end generation.
+
+        Returns:
+            dict: JSON response from the API.
+        """
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.api_key}"
+        }
+
+        payload: Dict[str, Any] = {
+            "model": self.model,
+            "messages": [{"role": "user", "content": prompt}],
+            "temperature": temperature,
+            "max_tokens": max_tokens,
+        }
+
+        if top_p is not None:
+            payload["top_p"] = top_p
+        if frequency_penalty is not None:
+            payload["frequency_penalty"] = frequency_penalty
+        if presence_penalty is not None:
+            payload["presence_penalty"] = presence_penalty
+        if stop is not None:
+            payload["stop"] = stop
+
+        response = requests.post(self.endpoint, headers=headers, json=payload)
+        response.raise_for_status()
+        return response.json()
+
+    def stream_completion(
+        self,
+        prompt: str,
+        temperature: float = 0.7,
+        max_tokens: int = 500,
+        top_p: Optional[float] = None,
+        frequency_penalty: Optional[float] = None,
+        presence_penalty: Optional[float] = None,
+        stop: Optional[list[str]] = None,
+    ):
+        """
+        Streams a response token-by-token (if the model supports streaming).
+
+        Yields:
+            str: Each chunk of the streamed output.
+        """
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.api_key}"
+        }
+
+        payload: Dict[str, Any] = {
+            "model": self.model,
+            "messages": [{"role": "user", "content": prompt}],
+            "temperature": temperature,
+            "max_tokens": max_tokens,
+            "stream": True
+        }
+
+        if top_p is not None:
+            payload["top_p"] = top_p
+        if frequency_penalty is not None:
+            payload["frequency_penalty"] = frequency_penalty
+        if presence_penalty is not None:
+            payload["presence_penalty"] = presence_penalty
+        if stop is not None:
+            payload["stop"] = stop
+
+        with requests.post(self.endpoint, headers=headers, json=payload, stream=True) as response:
+            response.raise_for_status()
+            for line in response.iter_lines():
+                if line:
+                    yield line.decode("utf-8")

euriai-0.2.0.dist-info/METADATA

@@ -0,0 +1,24 @@
+Metadata-Version: 2.1
+Name: euriai
+Version: 0.2.0
+Summary: Python client for EURI LLM API (euron.one) with CLI and interactive wizard
+Author: euron.one
+Author-email: sudhanshu@euron.one
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# euriai 🧠
+
+EURI AI Python Client – Simple wrapper and CLI tool for the Euron LLM API.
+
+## 🔧 Install
+
+```bash
+pip install euriai

euriai-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+euriai/__init__.py,sha256=jyfCq3Mc-PrsIK2SGU49o7ATy834G74oDfiKJsYa-A4,34
+euriai/cli.py,sha256=hF1wiiL2QQSfWf8WlLQyNVDBd4YkbiwmMSoPxVbyPTM,3290
+euriai/client.py,sha256=USiqdMULgAiky7nkrJKF3FyKcOS2DtDmUdbeBSnyLYk,4076
+euriai-0.2.0.dist-info/METADATA,sha256=FYbi-QQCfsjFujbtFdT1a_tKK2sroPAPBOJLQB0qGV4,681
+euriai-0.2.0.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+euriai-0.2.0.dist-info/entry_points.txt,sha256=9OkET8KIGcsjQn8UlnpPKRT75s2KW34jq1__1SXtpMA,43
+euriai-0.2.0.dist-info/top_level.txt,sha256=TG1htJ8cuD62MXn-NJ7DVF21QHY16w6M_QgfF_Er_EQ,7
+euriai-0.2.0.dist-info/RECORD,,

euriai-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.1.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

euriai-0.2.0.dist-info/entry_points.txt

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

euriai-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+euriai