euriai 0.3.30__tar.gz → 0.4__tar.gz

euriai-0.4/PKG-INFO

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: euriai
+Version: 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 
+
+```bash
+pip install euriai
+```
+
+## 🚀 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
+```
+
+## 🤖 LangChain Integration
+
+### Text Generation
+
+Use Euriai with LangChain directly:
+
+```python
+from euriai import EuriaiLangChainLLM
+
+llm = EuriaiLangChainLLM(
+    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.langchain_embed import EuriaiEmbeddings
+
+embedding_model = EuriaiEmbeddings(api_key="your_key")
+print(embedding_model.embed_query("What's AI?")[:5])  # Print first 5 dimensions
+```
+
+## Usage Examples
+
+### CrewAI Integration
+```python
+from euriai import EuriaiCrewAI
+
+# Example: Create a crew from YAML config files
+crew = EuriaiCrewAI.from_yaml('agents.yaml', 'tasks.yaml')
+result = crew.run(inputs={"topic": "AI in Healthcare"})
+print(result)
+
+# Or programmatically
+crew = EuriaiCrewAI()
+crew.add_agent("researcher", {
+    "role": "Researcher",
+    "goal": "Find information about {topic}",
+    "llm": "openai/gpt-4o"
+})
+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
+```python
+from euriai import EuriaiAutoGen
+
+autogen = EuriaiAutoGen()
+# Add an agent (see AutoGen docs for agent config details)
+agent = autogen.add_agent({
+    "name": "assistant",
+    "llm_config": {"api_key": "YOUR_OPENAI_KEY", "model": "gpt-4o"}
+})
+# Run a chat
+response = autogen.run_chat("Hello, what is the weather today?")
+print(response)
+# Access chat history
+print(autogen.get_history())
+```
+
+### LlamaIndex Integration
+```python
+from euriai import EuriaiLlamaIndex
+
+llama = EuriaiLlamaIndex()
+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
+```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()
+graph.add_node("greet", greet_node)
+graph.add_node("farewell", farewell_node)
+graph.add_edge("greet", "farewell")
+graph.set_state({"name": "Alice"})
+result = graph.run()
+print(result)
+```
+
+---
+
+## 2. **SmolAgents Integration**
+
+```python
+from euriai import EuriaiSmolAgent
+
+# Define a tool using the @tool decorator
+try:
+    from smolagents import tool
+except ImportError:
+    raise ImportError("Please install smolagents: pip install smolagents")
+
+@tool
+def add(a: int, b: int) -> int:
+    """Add two numbers."""
+    return a + b
+
+# Create the agent with the tool
+agent = EuriaiSmolAgent(tools=[add])
+response = agent.run("What is 2 + 3?")
+print(response)
+```
+
+---
+
+## 3. **n8n Integration**
+
+```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)
+```
+
+---
+
+**You can copy-paste these code blocks into your client documentation or UI for user reference.**  
+If you want advanced examples (e.g., multi-tool SmolAgents, LangGraph with more nodes, or n8n with authentication), just let me know!
+
+## 📘 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.

euriai-0.4/README.md

@@ -0,0 +1,236 @@
+# 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 
+
+```bash
+pip install euriai
+```
+
+## 🚀 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
+```
+
+## 🤖 LangChain Integration
+
+### Text Generation
+
+Use Euriai with LangChain directly:
+
+```python
+from euriai import EuriaiLangChainLLM
+
+llm = EuriaiLangChainLLM(
+    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.langchain_embed import EuriaiEmbeddings
+
+embedding_model = EuriaiEmbeddings(api_key="your_key")
+print(embedding_model.embed_query("What's AI?")[:5])  # Print first 5 dimensions
+```
+
+## Usage Examples
+
+### CrewAI Integration
+```python
+from euriai import EuriaiCrewAI
+
+# Example: Create a crew from YAML config files
+crew = EuriaiCrewAI.from_yaml('agents.yaml', 'tasks.yaml')
+result = crew.run(inputs={"topic": "AI in Healthcare"})
+print(result)
+
+# Or programmatically
+crew = EuriaiCrewAI()
+crew.add_agent("researcher", {
+    "role": "Researcher",
+    "goal": "Find information about {topic}",
+    "llm": "openai/gpt-4o"
+})
+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
+```python
+from euriai import EuriaiAutoGen
+
+autogen = EuriaiAutoGen()
+# Add an agent (see AutoGen docs for agent config details)
+agent = autogen.add_agent({
+    "name": "assistant",
+    "llm_config": {"api_key": "YOUR_OPENAI_KEY", "model": "gpt-4o"}
+})
+# Run a chat
+response = autogen.run_chat("Hello, what is the weather today?")
+print(response)
+# Access chat history
+print(autogen.get_history())
+```
+
+### LlamaIndex Integration
+```python
+from euriai import EuriaiLlamaIndex
+
+llama = EuriaiLlamaIndex()
+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
+```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()
+graph.add_node("greet", greet_node)
+graph.add_node("farewell", farewell_node)
+graph.add_edge("greet", "farewell")
+graph.set_state({"name": "Alice"})
+result = graph.run()
+print(result)
+```
+
+---
+
+## 2. **SmolAgents Integration**
+
+```python
+from euriai import EuriaiSmolAgent
+
+# Define a tool using the @tool decorator
+try:
+    from smolagents import tool
+except ImportError:
+    raise ImportError("Please install smolagents: pip install smolagents")
+
+@tool
+def add(a: int, b: int) -> int:
+    """Add two numbers."""
+    return a + b
+
+# Create the agent with the tool
+agent = EuriaiSmolAgent(tools=[add])
+response = agent.run("What is 2 + 3?")
+print(response)
+```
+
+---
+
+## 3. **n8n Integration**
+
+```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)
+```
+
+---
+
+**You can copy-paste these code blocks into your client documentation or UI for user reference.**  
+If you want advanced examples (e.g., multi-tool SmolAgents, LangGraph with more nodes, or n8n with authentication), just let me know!
+
+## 📘 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.

euriai-0.4/euriai/__init__.py

@@ -0,0 +1,27 @@
+from .client import EuriaiClient
+from .langchain_llm import EuriaiLangChainLLM
+from .embedding import EuriaiEmbeddingClient
+from .langchain_embed import EuriaiEmbeddings
+from .euri_chat import EuriaiLlamaIndexLLM
+from .euri_embed import EuriaiLlamaIndexEmbedding
+from .euri_crewai import EuriaiCrewAI
+from .euri_autogen import EuriaiAutoGen
+from .euri_llamaindex import EuriaiLlamaIndex
+from .euri_langgraph import EuriaiLangGraph
+from .euri_smolagents import EuriaiSmolAgent
+from .euri_n8n import EuriaiN8N
+
+__all__ = [
+    "EuriaiClient",
+    "EuriaiLangChainLLM",
+    "EuriaiEmbeddingClient",
+    "EuriaiEmbeddings",
+    "EuriaiLlamaIndexLLM",
+    "EuriaiLlamaIndexEmbedding",
+    "EuriaiCrewAI",
+    "EuriaiAutoGen",
+    "EuriaiLlamaIndex",
+    "EuriaiLangGraph",
+    "EuriaiSmolAgent",
+    "EuriaiN8N",
+]

{euriai-0.3.30 → euriai-0.4}/euriai/client.py

@@ -6,14 +6,14 @@ class EuriaiClient:
         self,
         api_key: str,
         model: str = "gpt-4.1-nano",
-        endpoint: str = "https://api.euron.one/api/v1/euri/alpha/chat/completions"
+        endpoint: str = "https://api.euron.one/api/v1/euri/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').
+            model (str, optional): Model ID to use (e.g., 'gpt-4.1-nano', 'gemini-2.5-flash').
             endpoint (str, optional): API endpoint URL.
         """
         self.api_key = api_key

{euriai-0.3.30 → euriai-0.4}/euriai/embedding.py

@@ -5,7 +5,7 @@ class EuriaiEmbeddingClient:
     def __init__(self, api_key: str, model: str = "text-embedding-3-small"):
         self.api_key = api_key
         self.model = model
-        self.url = "https://api.euron.one/api/v1/euri/alpha/embeddings"
+        self.url = "https://api.euron.one/api/v1/euri/embeddings"
 
     def embed(self, text: str) -> np.ndarray:
         headers = {

euriai-0.4/euriai/euri_autogen.py

@@ -0,0 +1,74 @@
+from typing import Optional, Dict, Any, List
+
+try:
+    import autogen
+except ImportError:
+    autogen = None
+
+class EuriaiAutoGen:
+    """
+    Full-featured wrapper for AutoGen integration in the EURI SDK.
+    Allows programmatic agent, tool, and workflow management, and chat execution.
+    """
+    def __init__(self, config: Optional[Dict[str, Any]] = None):
+        """
+        Initialize the AutoGen wrapper.
+        Args:
+            config: Dict of config options (API keys, model, etc.)
+        """
+        if autogen is None:
+            raise ImportError("AutoGen is not installed. Please install with `pip install pyautogen`.")
+        self.config = config or {}
+        self.agents: List[Any] = []
+        self.tools: List[Any] = []
+        self.memory: Optional[Any] = None
+        self.workflow: Optional[Any] = None
+        self.history: List[Dict[str, Any]] = []
+
+    def add_agent(self, agent_config: Dict[str, Any]) -> Any:
+        """Add an agent with config."""
+        agent = autogen.Agent(**agent_config)
+        self.agents.append(agent)
+        return agent
+
+    def add_tool(self, tool_config: Dict[str, Any]) -> Any:
+        """Add a tool with config."""
+        tool = autogen.Tool(**tool_config)
+        self.tools.append(tool)
+        return tool
+
+    def set_memory(self, memory_config: Dict[str, Any]) -> None:
+        """Set memory for the workflow."""
+        self.memory = autogen.Memory(**memory_config)
+
+    def run_chat(self, prompt: str, agent_idx: int = 0, **kwargs) -> str:
+        """
+        Run a chat with the specified agent and prompt.
+        Returns the agent's response.
+        """
+        if not self.agents:
+            raise ValueError("No agents defined. Use add_agent().")
+        agent = self.agents[agent_idx]
+        response = agent.chat(prompt, **kwargs)
+        self.history.append({"agent": agent, "prompt": prompt, "response": response})
+        return response
+
+    def run_workflow(self, workflow_config: Dict[str, Any], **kwargs) -> Any:
+        """
+        Run a custom workflow (advanced usage).
+        """
+        workflow = autogen.Workflow(**workflow_config)
+        self.workflow = workflow
+        result = workflow.run(**kwargs)
+        return result
+
+    def get_history(self) -> List[Dict[str, Any]]:
+        return self.history
+
+    def reset(self):
+        """Reset agents, tools, memory, and history."""
+        self.agents = []
+        self.tools = []
+        self.memory = None
+        self.workflow = None
+        self.history = [] 

{euriai-0.3.30 → euriai-0.4}/euriai/euri_chat.py

@@ -10,7 +10,7 @@ class EuriaiLlamaIndexLLM(LLM):
     model: str = "gpt-4.1-nano"
     temperature: float = 0.7
     max_tokens: int = 1000
-    url: str = "https://api.euron.one/api/v1/euri/alpha/chat/completions"
+    url: str = "https://api.euron.one/api/v1/euri/chat/completions"
 
     def __init__(
         self,