Release v3.10.25

Author: MervinPraison

docker/Dockerfile.chat

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.10.24" \
+    "praisonai>=3.10.25" \
     "praisonai[chat]" \
     "embedchain[github,youtube]"
 

docker/Dockerfile.dev

@@ -20,7 +20,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.10.24" \
+    "praisonai>=3.10.25" \
     "praisonai[ui]" \
     "praisonai[chat]" \
     "praisonai[realtime]" \

docker/Dockerfile.ui

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.10.24" \
+    "praisonai>=3.10.25" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

examples/python/save_output/01_write_file_tool.py

@@ -0,0 +1,22 @@
+"""
+Example 1: Save Agent Output Using write_file Tool
+
+The agent decides when and what to save based on the task.
+"""
+
+from praisonaiagents import Agent
+from praisonaiagents.tools import write_file
+
+# Create agent with write_file tool
+agent = Agent(
+    name="ContentWriter",
+    role="Technical Writer",
+    goal="Create and save technical documentation",
+    tools=[write_file]
+)
+
+# Agent will use write_file tool to save the content
+result = agent.start("Write a short poem about coding and save it to poem.txt")
+
+print("✅ Task completed!")
+print(f"Result: {result}")

examples/python/save_output/02_task_output_file.py

@@ -0,0 +1,30 @@
+"""
+Example 2: Save Agent Output Using Task.output_file
+
+Task output is automatically saved to the specified file.
+"""
+
+from praisonaiagents import Agent, Task, Agents
+
+# Create agent
+writer = Agent(
+    name="ContentWriter",
+    role="Writer",
+    goal="Create engaging content"
+)
+
+# Task with output_file - auto-saves result
+task = Task(
+    description="Write a short blog post about the benefits of AI assistants",
+    expected_output="A well-structured blog post in markdown format",
+    agent=writer,
+    output_file="blog_post.md",
+    create_directory=True
+)
+
+# Run
+agents = Agents(agents=[writer], tasks=[task])
+result = agents.start()
+
+print("✅ Task completed!")
+print("Output saved to: blog_post.md")

examples/python/save_output/03_workflow_output_file.py

@@ -0,0 +1,41 @@
+"""
+Example 3: Save Agent Output Using Workflow output_file
+
+Workflow step output is automatically saved with variable substitution.
+"""
+
+from praisonaiagents import Workflow
+
+# Define workflow with output_file
+workflow_config = {
+    "metadata": {
+        "name": "content-generator",
+        "version": "1.0"
+    },
+    "variables": {
+        "output_dir": "generated",
+        "topic": "Python programming"
+    },
+    "agents": {
+        "writer": {
+            "role": "Content Writer",
+            "goal": "Create engaging content",
+            "llm": "gpt-4o-mini"
+        }
+    },
+    "steps": [
+        {
+            "agent": "writer",
+            "action": "Write a short tutorial about Python basics",
+            "expected_output": "A beginner-friendly tutorial",
+            "output_file": "{{output_dir}}/tutorial.md"
+        }
+    ]
+}
+
+# Run workflow
+workflow = Workflow(config=workflow_config)
+result = workflow.run()
+
+print("✅ Workflow completed!")
+print("Output saved to: generated/tutorial.md")

examples/python/save_output/04_manual_save.py

@@ -0,0 +1,27 @@
+"""
+Example 4: Save Agent Output Manually
+
+Capture the response and save it with full control.
+"""
+
+from praisonaiagents import Agent
+from pathlib import Path
+
+# Create agent
+agent = Agent(
+    name="StoryWriter",
+    instructions="You are a creative writer who writes short stories."
+)
+
+# Get response
+response = agent.start("Write a very short story about a robot learning to paint")
+
+# Save manually with error handling
+output_path = Path("stories/robot_story.txt")
+output_path.parent.mkdir(parents=True, exist_ok=True)
+
+try:
+    output_path.write_text(response)
+    print(f"✅ Saved to {output_path}")
+except IOError as e:
+    print(f"❌ Failed to save: {e}")

examples/python/save_output/README.md

@@ -0,0 +1,35 @@
+# Save Agent Output Examples
+
+Examples demonstrating different methods to save agent output to files.
+
+## Examples
+
+| File | Method | Description |
+|------|--------|-------------|
+| `01_write_file_tool.py` | write_file Tool | Agent decides when/what to save |
+| `02_task_output_file.py` | Task.output_file | Auto-save task result |
+| `03_workflow_output_file.py` | Workflow output_file | Save workflow step output |
+| `04_manual_save.py` | Manual | Full control over saving |
+
+## Setup
+
+```bash
+pip install praisonaiagents
+export OPENAI_API_KEY="your-key"
+```
+
+## Run Examples
+
+```bash
+python 01_write_file_tool.py
+python 02_task_output_file.py
+python 03_workflow_output_file.py
+python 04_manual_save.py
+```
+
+## Which Method to Use?
+
+- **write_file Tool**: When agent needs to decide what to save
+- **Task.output_file**: For task-based workflows with auto-save
+- **Workflow output_file**: For YAML workflows with variable substitution
+- **Manual**: When you need full control over the saving process

src/praisonai-agents/praisonaiagents/__init__.py

@@ -213,6 +213,14 @@ def _get_lazy_cache():
     'PromptExpanderAgent': ('praisonaiagents.agent.prompt_expander_agent', 'PromptExpanderAgent'),
     'ExpandStrategy': ('praisonaiagents.agent.prompt_expander_agent', 'ExpandStrategy'),
     'ExpandResult': ('praisonaiagents.agent.prompt_expander_agent', 'ExpandResult'),
+    'VisionAgent': ('praisonaiagents.agent.vision_agent', 'VisionAgent'),
+    'VisionConfig': ('praisonaiagents.agent.vision_agent', 'VisionConfig'),
+    'EmbeddingAgent': ('praisonaiagents.agent.embedding_agent', 'EmbeddingAgent'),
+    'EmbeddingConfig': ('praisonaiagents.agent.embedding_agent', 'EmbeddingConfig'),
+    'RealtimeAgent': ('praisonaiagents.agent.realtime_agent', 'RealtimeAgent'),
+    'RealtimeConfig': ('praisonaiagents.agent.realtime_agent', 'RealtimeConfig'),
+    'CodeAgent': ('praisonaiagents.agent.code_agent', 'CodeAgent'),
+    'CodeConfig': ('praisonaiagents.agent.code_agent', 'CodeConfig'),
 
     # Agents
     'Agents': ('praisonaiagents.agents.agents', 'Agents'),

src/praisonai-agents/praisonaiagents/agent/__init__.py

@@ -55,6 +55,38 @@ def __getattr__(name):
         from .router_agent import RouterAgent
         _lazy_cache[name] = RouterAgent
         return RouterAgent
+    elif name == 'VisionAgent':
+        from .vision_agent import VisionAgent
+        _lazy_cache[name] = VisionAgent
+        return VisionAgent
+    elif name == 'VisionConfig':
+        from .vision_agent import VisionConfig
+        _lazy_cache[name] = VisionConfig
+        return VisionConfig
+    elif name == 'EmbeddingAgent':
+        from .embedding_agent import EmbeddingAgent
+        _lazy_cache[name] = EmbeddingAgent
+        return EmbeddingAgent
+    elif name == 'EmbeddingConfig':
+        from .embedding_agent import EmbeddingConfig
+        _lazy_cache[name] = EmbeddingConfig
+        return EmbeddingConfig
+    elif name == 'RealtimeAgent':
+        from .realtime_agent import RealtimeAgent
+        _lazy_cache[name] = RealtimeAgent
+        return RealtimeAgent
+    elif name == 'RealtimeConfig':
+        from .realtime_agent import RealtimeConfig
+        _lazy_cache[name] = RealtimeConfig
+        return RealtimeConfig
+    elif name == 'CodeAgent':
+        from .code_agent import CodeAgent
+        _lazy_cache[name] = CodeAgent
+        return CodeAgent
+    elif name == 'CodeConfig':
+        from .code_agent import CodeConfig
+        _lazy_cache[name] = CodeConfig
+        return CodeConfig
 
     # Handoff - lightweight
     _handoff_names = {
@@ -120,6 +152,14 @@ def __getattr__(name):
     'AudioConfig',
     'OCRAgent',
     'OCRConfig',
+    'VisionAgent',
+    'VisionConfig',
+    'EmbeddingAgent',
+    'EmbeddingConfig',
+    'RealtimeAgent',
+    'RealtimeConfig',
+    'CodeAgent',
+    'CodeConfig',
     'ContextAgent',
     'create_context_agent',
     'Handoff',