euriai 0.2.0__tar.gz

euriai-0.2.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,8 @@
+# euriai 🧠
+
+EURI AI Python Client – Simple wrapper and CLI tool for the Euron LLM API.
+
+## 🔧 Install
+
+```bash
+pip install euriai

euriai-0.2.0/euriai/__init__.py

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

euriai-0.2.0/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-0.2.0/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/euriai.egg-info/PKG-INFO

@@ -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/euriai.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+euriai/__init__.py
+euriai/cli.py
+euriai/client.py
+euriai.egg-info/PKG-INFO
+euriai.egg-info/SOURCES.txt
+euriai.egg-info/dependency_links.txt
+euriai.egg-info/entry_points.txt
+euriai.egg-info/requires.txt
+euriai.egg-info/top_level.txt

euriai-0.2.0/euriai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

euriai-0.2.0/euriai.egg-info/entry_points.txt

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

euriai-0.2.0/euriai.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

euriai-0.2.0/euriai.egg-info/top_level.txt

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

euriai-0.2.0/setup.cfg

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

euriai-0.2.0/setup.py

@@ -0,0 +1,29 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="euriai",
+    version="0.2.0",
+    description="Python client for EURI LLM API (euron.one) with CLI and interactive wizard",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="euron.one",
+    author_email="sudhanshu@euron.one",
+    packages=find_packages(),
+    install_requires=[
+        "requests"
+    ],
+    python_requires=">=3.6",
+    entry_points={
+        "console_scripts": [
+            "euriai=euriai.cli:main"
+        ]
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+        "License :: OSI Approved :: MIT License",
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+    ],
+    license="MIT",
+)