euriai 1.0.4__py3-none-any.whl → 1.0.6__py3-none-any.whl

euriai/__init__.py

@@ -1,30 +1,204 @@
-from .client import EuriaiClient
-from .langchain import EuriaiChatModel, EuriaiEmbeddings, EuriaiLLM, create_chat_model, create_embeddings, create_llm
-from .embedding import EuriaiEmbeddingClient
-from .euri_chat import EuriaiLlamaIndexLLM
-from .euri_embed import EuriaiLlamaIndexEmbedding
-from .crewai import EuriaiCrewAI
-from .autogen import EuriaiAutoGen
-from .llamaindex import EuriaiLlamaIndex
-from .langgraph import EuriaiLangGraph
-from .smolagents import EuriaiSmolAgent
-from .n8n import EuriaiN8N
-
-__all__ = [
-    "EuriaiClient",
-    "EuriaiEmbeddingClient",
-    "EuriaiLlamaIndexLLM",
-    "EuriaiLlamaIndexEmbedding",
-    "EuriaiCrewAI",
-    "EuriaiAutoGen",
-    "EuriaiLlamaIndex",
-    "EuriaiLangGraph",
-    "EuriaiSmolAgent",
-    "EuriaiN8N",
-    "EuriaiChatModel",
-    "EuriaiEmbeddings",
-    "EuriaiLLM",
-    "create_chat_model",
-    "create_embeddings",
-    "create_llm",
-]
+"""
+Euri AI Python SDK
+
+A comprehensive Python SDK for the Euri AI API with integrations for popular frameworks.
+"""
+
+__version__ = "1.0.6"
+
+# Core imports that should always work
+try:
+    from .client import EuriaiClient
+except ImportError as e:
+    print(f"Warning: Could not import EuriaiClient: {e}")
+    EuriaiClient = None
+
+try:
+    from .embedding import EuriaiEmbeddingClient
+    # Backward compatibility alias
+    EuriaiEmbedding = EuriaiEmbeddingClient
+except ImportError as e:
+    print(f"Warning: Could not import EuriaiEmbeddingClient: {e}")
+    EuriaiEmbeddingClient = None
+    EuriaiEmbedding = None
+
+# Main exports (only include what was successfully imported)
+__all__ = []
+if EuriaiClient is not None:
+    __all__.append("EuriaiClient")
+if EuriaiEmbeddingClient is not None:
+    __all__.extend(["EuriaiEmbeddingClient", "EuriaiEmbedding"])
+
+
+# Helper functions for optional dependencies
+def check_optional_dependency(package_name: str, integration_name: str, install_extra: str = None) -> bool:
+    """
+    Check if an optional dependency is installed and provide helpful installation instructions.
+    
+    Args:
+        package_name: The actual package name to import
+        integration_name: The friendly name for the integration
+        install_extra: The extras_require key for pip install euriai[extra]
+    
+    Returns:
+        bool: True if package is available, False otherwise
+        
+    Raises:
+        ImportError: With helpful installation instructions
+    """
+    try:
+        __import__(package_name)
+        return True
+    except ImportError:
+        extra_option = f"euriai[{install_extra}]" if install_extra else f"euriai[{integration_name.lower()}]"
+        
+        error_msg = (
+            f"{integration_name} is not installed. Please install it using one of these methods:\n\n"
+            f"Option 1 (Recommended): Install with euriai extras:\n"
+            f"  pip install {extra_option}\n\n"
+            f"Option 2: Install {integration_name} directly:\n"
+            f"  pip install {package_name}\n\n"
+            f"Option 3: Install all euriai integrations:\n"
+            f"  pip install euriai[all]\n"
+        )
+        
+        raise ImportError(error_msg)
+
+
+def install_optional_dependency(package_name: str, integration_name: str, install_extra: str = None) -> bool:
+    """
+    Attempt to automatically install an optional dependency (USE WITH CAUTION).
+    
+    This function is provided for convenience but automatic installation can be risky.
+    It's generally better to install dependencies manually.
+    
+    Args:
+        package_name: The actual package name to install
+        integration_name: The friendly name for the integration  
+        install_extra: The extras_require key for pip install euriai[extra]
+    
+    Returns:
+        bool: True if installation succeeded, False otherwise
+    """
+    import subprocess
+    import sys
+    
+    try:
+        # Try to import first
+        __import__(package_name)
+        print(f"✓ {integration_name} is already installed")
+        return True
+    except ImportError:
+        pass
+    
+    # Ask user for confirmation
+    extra_option = f"euriai[{install_extra}]" if install_extra else f"euriai[{integration_name.lower()}]"
+    
+    print(f"🔍 {integration_name} is not installed.")
+    print(f"📦 Recommended installation: pip install {extra_option}")
+    
+    response = input(f"Would you like to automatically install {package_name}? (y/N): ").lower()
+    
+    if response in ['y', 'yes']:
+        try:
+            print(f"📥 Installing {package_name}...")
+            subprocess.check_call([sys.executable, "-m", "pip", "install", package_name])
+            print(f"✅ {integration_name} installed successfully!")
+            return True
+        except subprocess.CalledProcessError as e:
+            print(f"❌ Failed to install {package_name}: {e}")
+            print(f"💡 Try manually: pip install {extra_option}")
+            return False
+    else:
+        print(f"💡 To install manually run: pip install {extra_option}")
+        return False
+
+
+# Lazy loading functions for optional integrations
+def _get_langchain():
+    """Lazy import for LangChain integration."""
+    try:
+        from . import langchain
+        return langchain
+    except ImportError:
+        check_optional_dependency("langchain-core", "LangChain", "langchain")
+
+def _get_crewai():
+    """Lazy import for CrewAI integration."""
+    try:
+        from . import crewai
+        return crewai
+    except ImportError:
+        check_optional_dependency("crewai", "CrewAI", "crewai")
+
+def _get_autogen():
+    """Lazy import for AutoGen integration."""
+    try:
+        from . import autogen
+        return autogen
+    except ImportError:
+        check_optional_dependency("pyautogen", "AutoGen", "autogen")
+
+def _get_smolagents():
+    """Lazy import for SmolAgents integration."""
+    try:
+        from . import smolagents
+        return smolagents
+    except ImportError:
+        check_optional_dependency("smolagents", "SmolAgents", "smolagents")
+
+def _get_langgraph():
+    """Lazy import for LangGraph integration."""
+    try:
+        from . import langgraph
+        return langgraph
+    except ImportError:
+        check_optional_dependency("langgraph", "LangGraph", "langgraph")
+
+def _get_llamaindex():
+    """Lazy import for LlamaIndex integration."""
+    try:
+        from . import llamaindex
+        return llamaindex
+    except ImportError:
+        check_optional_dependency("llama-index", "LlamaIndex", "llama-index")
+
+
+# Create lazy loading properties
+class _LazyLoader:
+    """Lazy loader for optional integrations."""
+    
+    @property
+    def langchain(self):
+        return _get_langchain()
+    
+    @property
+    def crewai(self):
+        return _get_crewai()
+    
+    @property
+    def autogen(self):
+        return _get_autogen()
+    
+    @property
+    def smolagents(self):
+        return _get_smolagents()
+    
+    @property
+    def langgraph(self):
+        return _get_langgraph()
+    
+    @property
+    def llamaindex(self):
+        return _get_llamaindex()
+
+
+# Create the lazy loader instance
+_lazy = _LazyLoader()
+
+# Make the integrations available as module-level attributes
+def __getattr__(name: str):
+    """Handle lazy loading of optional integrations."""
+    if hasattr(_lazy, name):
+        return getattr(_lazy, name)
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")

euriai/autogen.py

@@ -198,7 +198,8 @@ class EuriaiAutoGen:
             default_model: Default model to use
         """
         if autogen is None:
-            raise ImportError("AutoGen is not installed. Please install with `pip install pyautogen`.")
+            from . import check_optional_dependency
+            check_optional_dependency("pyautogen", "AutoGen", "autogen")
         
         self.api_key = api_key
         self.default_model = default_model

euriai/direct.py

@@ -0,0 +1,82 @@
+"""
+Direct Import Module for Euri AI SDK
+
+This module provides direct access to integrations without going through the main __init__.py,
+which can be useful if there are import issues with the main package.
+
+Usage:
+    # Instead of: from euriai.langchain import EuriaiChatModel
+    # Use: from euriai.direct import langchain_chat_model
+    
+    from euriai.direct import langchain_chat_model, langchain_embeddings
+    
+    chat_model = langchain_chat_model(
+        api_key="your-key",
+        model="gpt-4.1-nano"
+    )
+"""
+
+# Direct imports that bypass __init__.py
+def langchain_chat_model(api_key: str, model: str = "gpt-4.1-nano", **kwargs):
+    """Create a LangChain chat model directly."""
+    from .langchain import EuriaiChatModel
+    return EuriaiChatModel(api_key=api_key, model=model, **kwargs)
+
+def langchain_llm(api_key: str, model: str = "gpt-4.1-nano", **kwargs):
+    """Create a LangChain LLM directly."""
+    from .langchain import EuriaiLLM
+    return EuriaiLLM(api_key=api_key, model=model, **kwargs)
+
+def langchain_embeddings(api_key: str, model: str = "text-embedding-3-small", **kwargs):
+    """Create LangChain embeddings directly."""
+    from .langchain import EuriaiEmbeddings
+    return EuriaiEmbeddings(api_key=api_key, model=model, **kwargs)
+
+def autogen_instance(api_key: str, default_model: str = "gpt-4.1-nano"):
+    """Create an AutoGen instance directly."""
+    from .autogen import EuriaiAutoGen
+    return EuriaiAutoGen(api_key=api_key, default_model=default_model)
+
+def crewai_instance(api_key: str, default_model: str = "gpt-4.1-nano", **kwargs):
+    """Create a CrewAI instance directly."""
+    from .crewai import EuriaiCrewAI
+    return EuriaiCrewAI(api_key=api_key, default_model=default_model, **kwargs)
+
+def client(api_key: str, model: str = "gpt-4.1-nano", **kwargs):
+    """Create a basic Euri client directly."""
+    from .client import EuriaiClient
+    return EuriaiClient(api_key=api_key, model=model, **kwargs)
+
+def embedding_client(api_key: str, model: str = "text-embedding-3-small"):
+    """Create an embedding client directly."""
+    from .embedding import EuriaiEmbeddingClient
+    return EuriaiEmbeddingClient(api_key=api_key, model=model)
+
+# Class exports for direct import
+def get_langchain_classes():
+    """Get LangChain classes for direct import."""
+    from .langchain import EuriaiChatModel, EuriaiLLM, EuriaiEmbeddings
+    return {
+        'EuriaiChatModel': EuriaiChatModel,
+        'EuriaiLLM': EuriaiLLM,
+        'EuriaiEmbeddings': EuriaiEmbeddings
+    }
+
+def get_autogen_classes():
+    """Get AutoGen classes for direct import."""
+    from .autogen import EuriaiAutoGen
+    return {'EuriaiAutoGen': EuriaiAutoGen}
+
+def get_crewai_classes():
+    """Get CrewAI classes for direct import."""
+    from .crewai import EuriaiCrewAI
+    return {'EuriaiCrewAI': EuriaiCrewAI}
+
+def get_core_classes():
+    """Get core classes for direct import."""
+    from .client import EuriaiClient
+    from .embedding import EuriaiEmbeddingClient
+    return {
+        'EuriaiClient': EuriaiClient,
+        'EuriaiEmbeddingClient': EuriaiEmbeddingClient
+    } 

euriai-1.0.6.dist-info/METADATA

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: euriai
+Version: 1.0.6
+Summary: Python client for Euri API (euron.one) with CLI, LangChain, and LlamaIndex integration
+Author: Euri
+Author-email: tech@euron.one
+License: MIT
+Keywords: euriai,llm,langchain,llamaindex,langgraph,smolagents,n8n,agents,ai,sdk
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: numpy
+Requires-Dist: pyyaml
+Provides-Extra: langchain-core
+Requires-Dist: langchain-core; extra == "langchain-core"
+Provides-Extra: langchain
+Requires-Dist: langchain; extra == "langchain"
+Provides-Extra: llama-index
+Requires-Dist: llama-index>=0.10.0; extra == "llama-index"
+Provides-Extra: langgraph
+Requires-Dist: langgraph; extra == "langgraph"
+Provides-Extra: smolagents
+Requires-Dist: smolagents; extra == "smolagents"
+Provides-Extra: n8n
+Requires-Dist: requests; extra == "n8n"
+Provides-Extra: crewai
+Requires-Dist: crewai; extra == "crewai"
+Provides-Extra: autogen
+Requires-Dist: pyautogen; extra == "autogen"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: all
+Requires-Dist: langchain-core; extra == "all"
+Requires-Dist: langchain; extra == "all"
+Requires-Dist: llama-index>=0.10.0; extra == "all"
+Requires-Dist: langgraph; extra == "all"
+Requires-Dist: smolagents; extra == "all"
+Requires-Dist: crewai; extra == "all"
+Requires-Dist: pyautogen; extra == "all"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Euri AI Python SDK
+
+A comprehensive Python SDK for the Euri AI API with integrations for popular AI frameworks.
+
+## Installation
+
+### Basic Installation
+```bash
+pip install euriai
+```
+
+### With Optional Integrations
+```bash
+# Install specific integrations
+pip install euriai[autogen]    # AutoGen integration
+pip install euriai[crewai]     # CrewAI integration  
+pip install euriai[langchain]  # LangChain integration
+pip install euriai[smolagents] # SmolAgents integration
+pip install euriai[langgraph]  # LangGraph integration
+pip install euriai[llama-index] # LlamaIndex integration
+
+# Install all integrations
+pip install euriai[all]
+```
+
+## Quick Start
+
+### Basic Usage
+```python
+from euriai import EuriaiClient
+
+# Initialize client
+client = EuriaiClient(
+    api_key="your-euri-api-key",
+    model="gpt-4.1-nano"
+)
+
+# Generate completion
+response = client.generate_completion(
+    prompt="What is artificial intelligence?",
+    temperature=0.7,
+    max_tokens=1000
+)
+
+print(response["choices"][0]["message"]["content"])
+```
+
+### Framework Integrations
+
+The SDK provides seamless integrations with popular AI frameworks. Each integration is optional and can be installed separately.
+
+#### AutoGen Integration
+```python
+# This will automatically check if AutoGen is installed
+# and provide helpful installation instructions if not
+from euriai.autogen import EuriaiAutoGen
+
+autogen = EuriaiAutoGen(
+    api_key="your-euri-api-key",
+    default_model="gpt-4.1-nano"
+)
+```
+
+#### CrewAI Integration
+```python
+from euriai.crewai import EuriaiCrewAI
+
+crew = EuriaiCrewAI(
+    api_key="your-euri-api-key",
+    default_model="gpt-4.1-nano"
+)
+```
+
+#### LangChain Integration
+```python
+from euriai.langchain import EuriaiChatModel
+
+chat_model = EuriaiChatModel(
+    api_key="your-euri-api-key",
+    model="gpt-4.1-nano"
+)
+```
+
+### Handling Optional Dependencies
+
+If you try to use an integration without installing its dependencies, you'll get helpful error messages:
+
+```python
+try:
+    from euriai.autogen import EuriaiAutoGen
+except ImportError as e:
+    print(e)
+    # This will show:
+    # AutoGen is not installed. Please install it using one of these methods:
+    # 
+    # Option 1 (Recommended): Install with euriai extras:
+    #   pip install euriai[autogen]
+    # 
+    # Option 2: Install AutoGen directly:
+    #   pip install pyautogen
+    # 
+    # Option 3: Install all euriai integrations:
+    #   pip install euriai[all]
+```
+
+### Semi-Automatic Installation (Optional)
+
+For convenience, you can use the helper function to prompt for automatic installation:
+
+```python
+from euriai import install_optional_dependency
+
+# This will ask user permission before installing
+if install_optional_dependency("pyautogen", "AutoGen", "autogen"):
+    from euriai.autogen import EuriaiAutoGen
+    # Now you can use AutoGen integration
+```
+
+## Available Models
+
+- `gpt-4.1-nano` - Fast and efficient model
+- `gpt-4.1-mini` - Balanced performance model  
+- `gemini-2.5-flash` - Google's Gemini model
+- And more...
+
+## Framework Support
+
+| Framework | Installation | Description |
+|-----------|-------------|-------------|
+| **AutoGen** | `pip install euriai[autogen]` | Multi-agent conversation framework |
+| **CrewAI** | `pip install euriai[crewai]` | Role-playing AI agent framework |
+| **LangChain** | `pip install euriai[langchain]` | Building applications with LLMs |
+| **LangGraph** | `pip install euriai[langgraph]` | Building stateful, multi-actor applications |
+| **SmolAgents** | `pip install euriai[smolagents]` | Minimalist agent framework |
+| **LlamaIndex** | `pip install euriai[llama-index]` | Data framework for LLM applications |
+
+## Examples
+
+### AutoGen Multi-Agent Chat
+```python
+from euriai.autogen import EuriaiAutoGen
+
+autogen = EuriaiAutoGen(api_key="your-api-key")
+
+assistant = autogen.create_assistant_agent(
+    name="Assistant",
+    model="gpt-4.1-nano"
+)
+
+user_proxy = autogen.create_user_proxy_agent(
+    name="User",
+    human_input_mode="NEVER"
+)
+
+result = autogen.run_chat(
+    agent1=user_proxy,
+    agent2=assistant,
+    message="Explain quantum computing",
+    max_turns=3
+)
+```
+
+### CrewAI Workflow
+```python
+from euriai.crewai import EuriaiCrewAI
+
+crew = EuriaiCrewAI(api_key="your-api-key")
+
+crew.add_agent("researcher", {
+    "role": "Researcher",
+    "goal": "Research {topic}",
+    "backstory": "Expert researcher with analytical skills",
+    "model": "gpt-4.1-nano"
+})
+
+crew.add_task("research_task", {
+    "description": "Research the given topic",
+    "expected_output": "Comprehensive research report",
+    "agent": "researcher"
+})
+
+result = crew.run(inputs={"topic": "AI in Healthcare"})
+```
+
+## API Reference
+
+For detailed API documentation, visit: [https://euron.one/euri](https://euron.one/euri)
+
+## Support
+
+- **Documentation**: [https://docs.euron.one](https://euron.one/euri)
+- **GitHub**: [https://github.com/euri-ai/euriai-python-sdk](https://github.com/euri-ai/euriai-python-sdk)
+- **Email**: tech@euron.one
+
+## License
+
+MIT License - see LICENSE file for details.

{euriai-1.0.4.dist-info → euriai-1.0.6.dist-info}/RECORD

@@ -1,8 +1,9 @@
-euriai/__init__.py,sha256=WE4zl0HNxDm4zwR3d0uRyjl3fjcD_pccKvPsbtuDysw,916
-euriai/autogen.py,sha256=4YAHrY65YYOKVsBjQa9G8pr-_Xxss1uR08qLAFzo7Rk,16023
+euriai/__init__.py,sha256=9m4dUESDsDNgIxkzoZBSR7oNOCFD2YzLX-1IY3UR__E,6629
+euriai/autogen.py,sha256=a_uKUn1FTxlFx7d7LwFnsM6TsdGbdecYxwujIp6xU0w,16044
 euriai/cli.py,sha256=hF1wiiL2QQSfWf8WlLQyNVDBd4YkbiwmMSoPxVbyPTM,3290
 euriai/client.py,sha256=L-o6hv9N3md-l-hz-kz5nYVaaZqnrREZlo_0jguhF7E,4066
 euriai/crewai.py,sha256=nfMMOOhKiCIc2v42nj2Zf9rP0U5m4GrfK_6zkXL77gw,7594
+euriai/direct.py,sha256=u0U_25r4866a2VsyqR2Q-cHJ6dgROOtmHkM-XoHmo68,3105
 euriai/embedding.py,sha256=uP66Ph1k9Ou6J5RAkztJxlfyj0S0MESOvZ4ulhnVo-o,1270
 euriai/euri_chat.py,sha256=DEAiet1ReRwB4ljkPYaTl1Nb5uc20-JF-3PQjGQZXk4,3567
 euriai/euri_embed.py,sha256=g7zs1G-ZBDJjOGJtkkfIcV4LPtRcm9wpVWmrfMGn5EM,2919
@@ -11,8 +12,8 @@ euriai/langgraph.py,sha256=sw9e-PnfwAwmp_tUCnAGIUB78GyJsMkAzxOGvFUafiM,34128
 euriai/llamaindex.py,sha256=c-ujod2bjL6QIvfAyuIxm1SvSCS00URFElYybKQ5Ew0,26551
 euriai/n8n.py,sha256=hjkckqyW_hZNL78UkBCof1WvKCKCIjwdvZdAgx6NrB8,3764
 euriai/smolagents.py,sha256=xlixGx2IWzAPTpSJGsYIK2L-SHGY9Mw1-8GbwVsEYtU,28507
-euriai-1.0.4.dist-info/METADATA,sha256=W-vrzgWEy1eDQLuzM31kI278KnEl6rVP81LBwPN1Db8,8417
-euriai-1.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-euriai-1.0.4.dist-info/entry_points.txt,sha256=9OkET8KIGcsjQn8UlnpPKRT75s2KW34jq1__1SXtpMA,43
-euriai-1.0.4.dist-info/top_level.txt,sha256=TG1htJ8cuD62MXn-NJ7DVF21QHY16w6M_QgfF_Er_EQ,7
-euriai-1.0.4.dist-info/RECORD,,
+euriai-1.0.6.dist-info/METADATA,sha256=zY0bdGDLoGfz-o-eY9mGWmC1AIS1E0QPOWZIdNbyO9Y,6806
+euriai-1.0.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+euriai-1.0.6.dist-info/entry_points.txt,sha256=9OkET8KIGcsjQn8UlnpPKRT75s2KW34jq1__1SXtpMA,43
+euriai-1.0.6.dist-info/top_level.txt,sha256=TG1htJ8cuD62MXn-NJ7DVF21QHY16w6M_QgfF_Er_EQ,7
+euriai-1.0.6.dist-info/RECORD,,

euriai-1.0.4.dist-info/METADATA

@@ -1,331 +0,0 @@
-Metadata-Version: 2.4
-Name: euriai
-Version: 1.0.4
-Summary: Python client for Euri API (euron.one) with CLI, LangChain, and LlamaIndex integration
-Author: Euri
-Author-email: tech@euron.one
-License: MIT
-Keywords: euriai,llm,langchain,llamaindex,langgraph,smolagents,n8n,agents,ai,sdk
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: requests
-Requires-Dist: numpy
-Requires-Dist: pyyaml
-Provides-Extra: langchain-core
-Requires-Dist: langchain-core; extra == "langchain-core"
-Provides-Extra: langchain
-Requires-Dist: langchain; extra == "langchain"
-Provides-Extra: llama-index
-Requires-Dist: llama-index>=0.10.0; extra == "llama-index"
-Provides-Extra: langgraph
-Requires-Dist: langgraph; extra == "langgraph"
-Provides-Extra: smolagents
-Requires-Dist: smolagents; extra == "smolagents"
-Provides-Extra: n8n
-Requires-Dist: requests; extra == "n8n"
-Provides-Extra: crewai
-Requires-Dist: crewai; extra == "crewai"
-Provides-Extra: autogen
-Requires-Dist: pyautogen; extra == "autogen"
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: license
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# euriai 🧠 
-
-**EURI AI Python Client** – A simple wrapper and CLI tool for the [Euri API](https://euron.one/euri). Supports completions, streaming responses, embeddings, CLI interaction, and an interactive guided wizard!
-
----
-
-## 🔧 Installation 
-
-### Basic Installation
-```bash
-pip install euriai
-```
-
-### Framework-Specific Installation
-For framework integrations, install the specific extras you need:
-
-```bash
-# For LangChain integration
-pip install euriai[langchain]
-
-# For LlamaIndex integration  
-pip install euriai[llama-index]
-
-# For LangGraph integration
-pip install euriai[langgraph]
-
-# For CrewAI integration
-pip install euriai[crewai]
-
-# For AutoGen integration
-pip install euriai[autogen]
-
-# For SmolAgents integration
-pip install euriai[smolagents]
-
-# Install multiple frameworks
-pip install euriai[langchain,llama-index,langgraph]
-
-# Install all frameworks
-pip install euriai[langchain,llama-index,langgraph,crewai,autogen,smolagents]
-```
-
-> **Note**: The n8n integration only requires the base installation as it uses standard HTTP requests.
-
----
-
-## 🚀 Python Usage
-
-### Text Generation
-
-```python
-from euriai import EuriaiClient
-
-client = EuriaiClient(
-    api_key="your_api_key_here",
-    model="gpt-4.1-nano"  # You can also try: "gemini-2.0-flash-001", "llama-4-maverick", etc.
-)
-
-response = client.generate_completion(
-    prompt="Write a short poem about artificial intelligence.",
-    temperature=0.7,
-    max_tokens=300
-)
-
-print(response)
-```
-
-### Embeddings
-
-```python
-from euriai.embedding import EuriaiEmbeddingClient
-
-client = EuriaiEmbeddingClient(api_key="your_key")
-embedding = client.embed("Hello world")
-print(embedding[:5])  # Print first 5 dimensions of the embedding vector
-```
-
-## 💻 Command-Line Interface (CLI) Usage
-
-Run prompts directly from the terminal:
-
-```bash
-euriai --api_key YOUR_API_KEY --prompt "Tell me a joke"
-```
-
-Enable streaming output (if supported by the model):
-
-```bash
-euriai --api_key YOUR_API_KEY --prompt "Stream a fun fact" --stream
-```
-
-List all supported model IDs with recommended use-cases and temperature/token advice:
-
-```bash
-euriai --models
-```
-
-## 🤖 Framework Integrations
-
-### LangChain Integration
-
-**Installation**: `pip install euriai[langchain]`
-
-#### Text Generation
-
-Use Euriai with LangChain directly:
-
-```python
-from euriai import EuriaiChatModel
-
-llm = EuriaiChatModel(
-    api_key="your_api_key",
-    model="gpt-4.1-nano", 
-    temperature=0.7,
-    max_tokens=300
-)
-
-print(llm.invoke("Write a poem about time travel."))
-```
-
-#### Embeddings
-
-Use Euriai embeddings with LangChain:
-
-```python
-from euriai import EuriaiEmbeddings
-
-embedding_model = EuriaiEmbeddings(api_key="your_key")
-print(embedding_model.embed_query("What's AI?")[:5])  # Print first 5 dimensions
-```
-
-### LlamaIndex Integration
-
-**Installation**: `pip install euriai[llama-index]`
-
-```python
-from euriai import EuriaiLlamaIndex
-
-llama = EuriaiLlamaIndex(api_key="your_api_key")
-llama.add_documents([
-    "Abraham Lincoln was the 16th President of the United States.",
-    "He led the country during the American Civil War."
-])
-llama.build_index()
-response = llama.query("Who was Abraham Lincoln?")
-print(response)
-```
-
-### LangGraph Integration
-
-**Installation**: `pip install euriai[langgraph]`
-
-```python
-from euriai import EuriaiLangGraph
-
-def greet_node(state):
-    print(f"Hello, {state['name']}!")
-    state['greeted'] = True
-    return state
-
-def farewell_node(state):
-    if state.get('greeted'):
-        print(f"Goodbye, {state['name']}!")
-    return state
-
-# Create the graph
-graph = EuriaiLangGraph(api_key="your_api_key")
-graph.add_node("greet", greet_node)
-graph.add_node("farewell", farewell_node)
-graph.add_edge("greet", "farewell")
-graph.set_entry_point("greet")
-graph.set_finish_point("farewell")
-result = graph.run({"name": "Alice"})
-print(result)
-```
-
-### CrewAI Integration
-
-**Installation**: `pip install euriai[crewai]`
-
-```python
-from euriai import EuriaiCrewAI
-
-# Example: Create a crew from YAML config files
-crew = EuriaiCrewAI(api_key="your_api_key")
-crew.add_agent("researcher", {
-    "role": "Researcher",
-    "goal": "Find information about {topic}",
-    "backstory": "You are an expert researcher"
-})
-crew.add_task("research_task", {
-    "description": "Research the topic {topic}",
-    "agent": "researcher"
-})
-crew.build_crew()
-result = crew.run(inputs={"topic": "AI in Healthcare"})
-print(result)
-```
-
-### AutoGen Integration
-
-**Installation**: `pip install euriai[autogen]`
-
-```python
-from euriai import EuriaiAutoGen
-
-autogen = EuriaiAutoGen(api_key="your_api_key")
-# Add an agent (see AutoGen docs for agent config details)
-agent = autogen.create_assistant_agent(
-    name="assistant",
-    system_message="You are a helpful assistant",
-    model="gpt-4.1-nano"
-)
-# Run a chat
-response = autogen.initiate_chat(agent, message="Hello, what is the weather today?")
-print(response)
-```
-
-### SmolAgents Integration
-
-**Installation**: `pip install euriai[smolagents]`
-
-```python
-from euriai import EuriaiSmolAgent
-
-# Define a tool using the @tool decorator
-from smolagents import tool
-
-@tool
-def add(a: int, b: int) -> int:
-    """Add two numbers."""
-    return a + b
-
-# Create the agent with the tool
-agent = EuriaiSmolAgent(api_key="your_api_key", tools=[add])
-response = agent.run("What is 2 + 3?")
-print(response)
-```
-
-### n8n Integration
-
-**Installation**: Basic installation only (`pip install euriai`)
-
-```python
-from euriai import EuriaiN8N
-
-# Initialize with your n8n instance URL and (optionally) API key
-n8n = EuriaiN8N(base_url="http://localhost:5678", api_key="YOUR_N8N_API_KEY")
-
-# Trigger a workflow by its webhook ID, passing data as needed
-workflow_id = "your-workflow-webhook-id"
-data = {"message": "Hello from EURI SDK!"}
-result = n8n.trigger_workflow(workflow_id, data)
-print(result)
-```
-
----
-
-## 🔍 Framework Status
-
-| Framework | Status | Installation Command | Notes |
-|-----------|--------|---------------------|-------|
-| LangChain | ✅ Working | `pip install euriai[langchain]` | Full compatibility |
-| LlamaIndex | ✅ Working | `pip install euriai[llama-index]` | Full compatibility |
-| n8n | ✅ Working | `pip install euriai` | No extra dependencies |
-| LangGraph | ⚠️ Requires Install | `pip install euriai[langgraph]` | Install required |
-| CrewAI | ⚠️ Requires Install | `pip install euriai[crewai]` | Install required |
-| AutoGen | ⚠️ Requires Install | `pip install euriai[autogen]` | Install required |
-| SmolAgents | ⚠️ Requires Install | `pip install euriai[smolagents]` | Install required |
-
-## 📘 Documentation
-
-For full documentation, visit our [official docs site](https://euron.one/euri).
-
-## 🔑 Getting an API Key
-
-Sign up for an API key at [Euron AI Platform](https://euron.one/euri).
-
-## 🤝 Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## 📄 License
-
-This project is licensed under the MIT License - see the LICENSE file for details.