tinyagent-py 0.0.8__tar.gz → 0.0.9__tar.gz

{tinyagent_py-0.0.8/tinyagent_py.egg-info → tinyagent_py-0.0.9}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: tinyagent-py
-Version: 0.0.8
-Summary: Tiny Agent with MCP Client and Extendable Hooks, Tiny but powerful
+Version: 0.0.9
+Summary: TinyAgent with MCP Client, Code Agent (Thinking, Planning, and Executing in Python), and Extendable Hooks, Tiny but powerful
 Author-email: Mahdi Golchin <golchin@askdev.ai>
 Project-URL: Homepage, https://github.com/askbudi/tinyagent
 Project-URL: Bug Tracker, https://github.com/askbudi/tinyagent/issues
@@ -25,10 +25,19 @@ Provides-Extra: sqlite
 Requires-Dist: aiosqlite>=0.18.0; extra == "sqlite"
 Provides-Extra: gradio
 Requires-Dist: gradio>=3.50.0; extra == "gradio"
+Provides-Extra: code
+Requires-Dist: jinja2; extra == "code"
+Requires-Dist: pyyaml; extra == "code"
+Requires-Dist: cloudpickle; extra == "code"
+Requires-Dist: modal; extra == "code"
 Provides-Extra: all
 Requires-Dist: asyncpg>=0.27.0; extra == "all"
 Requires-Dist: aiosqlite>=0.18.0; extra == "all"
 Requires-Dist: gradio>=3.50.0; extra == "all"
+Requires-Dist: jinja2; extra == "all"
+Requires-Dist: pyyaml; extra == "all"
+Requires-Dist: cloudpickle; extra == "all"
+Requires-Dist: modal; extra == "all"
 Dynamic: license-file
 
 # TinyAgent
@@ -52,7 +61,11 @@ Inspired by:
 - [Build your own Tiny Agent](https://askdev.ai/github/askbudi/tinyagent)
 
 ## Overview
-This is a tiny agent that uses MCP and LiteLLM to interact with a model. You have full control over the agent, you can add any tools you like from MCP and extend the agent using its event system.
+This is a tiny agent framework that uses MCP and LiteLLM to interact with language models. You have full control over the agent, you can add any tools you like from MCP and extend the agent using its event system.
+
+**Two Main Components:**
+- **TinyAgent**: Core agent with MCP tool integration and extensible hooks
+- **TinyCodeAgent**: Specialized agent for secure Python code execution with pluggable providers
 
 ## Installation
 
@@ -64,6 +77,10 @@ pip install tinyagent-py
 # Install with all optional dependencies
 pip install tinyagent-py[all]
 
+# Install with Code Agent support
+pip install tinyagent-py[code]
+
+
 # Install with PostgreSQL support
 pip install tinyagent-py[postgres]
 
@@ -73,6 +90,10 @@ pip install tinyagent-py[sqlite]
 # Install with Gradio UI support
 pip install tinyagent-py[gradio]
 
+
+
+
+
 ```
 
 ### Using uv
@@ -80,6 +101,10 @@ pip install tinyagent-py[gradio]
 # Basic installation
 uv pip install tinyagent-py
 
+# Install with Code Agent support
+uv pip install tinyagent-py[code]
+
+
 # Install with PostgreSQL support
 uv pip install tinyagent-py[postgres]
 
@@ -92,11 +117,11 @@ uv pip install tinyagent-py[gradio]
 # Install with all optional dependencies
 uv pip install tinyagent-py[all]
 
-# Install with development tools
-uv pip install tinyagent-py[dev]
 ```
 
 ## Usage
+
+### TinyAgent (Core Agent)
 [![AskDev.AI | Chat with TinyAgent](https://img.shields.io/badge/AskDev.AI-Chat_with_TinyAgent-blue?style=flat-square)](https://askdev.ai/github/askbudi/tinyagent)
 
 
@@ -133,6 +158,114 @@ I need accommodation in Toronto between 15th to 20th of May. Give me 5 options f
 await test_agent(task, model="gpt-4.1-mini")
 ```
 
+## TinyCodeAgent - Code Execution Made Easy
+
+TinyCodeAgent is a specialized agent for executing Python code with enterprise-grade reliability and extensible execution providers.
+
+### Quick Start with TinyCodeAgent
+
+```python
+import asyncio
+from tinyagent import TinyCodeAgent
+
+async def main():
+    # Initialize with minimal configuration
+    agent = TinyCodeAgent(
+        model="gpt-4.1-mini",
+        api_key="your-openai-api-key"
+    )
+    
+    try:
+        # Ask the agent to solve a coding problem
+        result = await agent.run("Calculate the factorial of 10 and explain the algorithm")
+        print(result)
+    finally:
+        await agent.close()
+
+asyncio.run(main())
+```
+
+### TinyCodeAgent with Gradio UI
+
+Launch a complete web interface for interactive code execution:
+
+```python
+from tinyagent.code_agent.example import run_example
+import asyncio
+
+# Run the full example with Gradio interface
+asyncio.run(run_example())
+```
+
+### Key Features
+
+- **🔒 Secure Execution**: Sandboxed Python code execution using Modal.com or other providers
+- **🔧 Extensible Providers**: Switch between Modal, Docker, local execution, or cloud functions
+- **🎯 Built for Enterprise**: Production-ready with proper logging, error handling, and resource cleanup  
+- **📁 File Support**: Upload and process files through the Gradio interface
+- **🛠️ Custom Tools**: Add your own tools and functions easily
+- **📊 Session Persistence**: Code state persists across executions
+
+### Provider System
+
+TinyCodeAgent uses a pluggable provider system - change execution backends with minimal code changes:
+
+```python
+# Use Modal (default) - great for production
+agent = TinyCodeAgent(provider="modal")
+
+# Future providers (coming soon)
+# agent = TinyCodeAgent(provider="docker")
+# agent = TinyCodeAgent(provider="local") 
+# agent = TinyCodeAgent(provider="lambda")
+```
+
+### Example Use Cases
+
+**Web Scraping:**
+```python
+result = await agent.run("""
+What are trending spaces on huggingface today?
+""")
+# Agent will create a python tool to request HuggingFace API and find trending spaces
+```
+
+**Use code to solve a task:**
+```python
+response = await agent.run(dedent("""
+Suggest me 13 tags for my Etsy Listing, each tag should be multiworded and maximum 20 characters. Each word should be used only once in the whole corpus, And tags should cover different ways people are searching for the product on Etsy.
+- You should use your coding abilities to check your answer pass the criteria and continue your job until you get to the answer.
+                                
+My Product is **Wedding Invitation Set of 3, in sage green color, with a gold foil border.**
+"""),max_turns=20)
+
+print(response)
+# LLM is not good at this task, counting characters, avoid duplicates, but with the power of code, tiny model like gpt-4.1-mini can do it without any problem.
+```
+
+
+### Configuration Options
+
+```python
+from tinyagent import TinyCodeAgent
+from tinyagent.code_agent.tools import get_weather, get_traffic
+
+# Full configuration example
+agent = TinyCodeAgent(
+    model="gpt-4.1-mini",
+    api_key="your-api-key", 
+    provider="modal",
+    tools=[get_weather, get_traffic],
+    authorized_imports=["requests", "pandas", "numpy"],
+    provider_config={
+        "pip_packages": ["requests", "pandas"],
+        "sandbox_name": "my-code-sandbox"
+    }
+)
+```
+
+For detailed documentation, see the [TinyCodeAgent README](tinyagent/code_agent/README.md).
+
 ## How the TinyAgent Hook System Works
 
 TinyAgent is designed to be **extensible** via a simple, event-driven hook (callback) system. This allows you to add custom logic, logging, UI, memory, or any other behavior at key points in the agent's lifecycle.

{tinyagent_py-0.0.8 → tinyagent_py-0.0.9}/README.md

@@ -19,7 +19,11 @@ Inspired by:
 - [Build your own Tiny Agent](https://askdev.ai/github/askbudi/tinyagent)
 
 ## Overview
-This is a tiny agent that uses MCP and LiteLLM to interact with a model. You have full control over the agent, you can add any tools you like from MCP and extend the agent using its event system.
+This is a tiny agent framework that uses MCP and LiteLLM to interact with language models. You have full control over the agent, you can add any tools you like from MCP and extend the agent using its event system.
+
+**Two Main Components:**
+- **TinyAgent**: Core agent with MCP tool integration and extensible hooks
+- **TinyCodeAgent**: Specialized agent for secure Python code execution with pluggable providers
 
 ## Installation
 
@@ -31,6 +35,10 @@ pip install tinyagent-py
 # Install with all optional dependencies
 pip install tinyagent-py[all]
 
+# Install with Code Agent support
+pip install tinyagent-py[code]
+
+
 # Install with PostgreSQL support
 pip install tinyagent-py[postgres]
 
@@ -40,6 +48,10 @@ pip install tinyagent-py[sqlite]
 # Install with Gradio UI support
 pip install tinyagent-py[gradio]
 
+
+
+
+
 ```
 
 ### Using uv
@@ -47,6 +59,10 @@ pip install tinyagent-py[gradio]
 # Basic installation
 uv pip install tinyagent-py
 
+# Install with Code Agent support
+uv pip install tinyagent-py[code]
+
+
 # Install with PostgreSQL support
 uv pip install tinyagent-py[postgres]
 
@@ -59,11 +75,11 @@ uv pip install tinyagent-py[gradio]
 # Install with all optional dependencies
 uv pip install tinyagent-py[all]
 
-# Install with development tools
-uv pip install tinyagent-py[dev]
 ```
 
 ## Usage
+
+### TinyAgent (Core Agent)
 [![AskDev.AI | Chat with TinyAgent](https://img.shields.io/badge/AskDev.AI-Chat_with_TinyAgent-blue?style=flat-square)](https://askdev.ai/github/askbudi/tinyagent)
 
 
@@ -100,6 +116,114 @@ I need accommodation in Toronto between 15th to 20th of May. Give me 5 options f
 await test_agent(task, model="gpt-4.1-mini")
 ```
 
+## TinyCodeAgent - Code Execution Made Easy
+
+TinyCodeAgent is a specialized agent for executing Python code with enterprise-grade reliability and extensible execution providers.
+
+### Quick Start with TinyCodeAgent
+
+```python
+import asyncio
+from tinyagent import TinyCodeAgent
+
+async def main():
+    # Initialize with minimal configuration
+    agent = TinyCodeAgent(
+        model="gpt-4.1-mini",
+        api_key="your-openai-api-key"
+    )
+    
+    try:
+        # Ask the agent to solve a coding problem
+        result = await agent.run("Calculate the factorial of 10 and explain the algorithm")
+        print(result)
+    finally:
+        await agent.close()
+
+asyncio.run(main())
+```
+
+### TinyCodeAgent with Gradio UI
+
+Launch a complete web interface for interactive code execution:
+
+```python
+from tinyagent.code_agent.example import run_example
+import asyncio
+
+# Run the full example with Gradio interface
+asyncio.run(run_example())
+```
+
+### Key Features
+
+- **🔒 Secure Execution**: Sandboxed Python code execution using Modal.com or other providers
+- **🔧 Extensible Providers**: Switch between Modal, Docker, local execution, or cloud functions
+- **🎯 Built for Enterprise**: Production-ready with proper logging, error handling, and resource cleanup  
+- **📁 File Support**: Upload and process files through the Gradio interface
+- **🛠️ Custom Tools**: Add your own tools and functions easily
+- **📊 Session Persistence**: Code state persists across executions
+
+### Provider System
+
+TinyCodeAgent uses a pluggable provider system - change execution backends with minimal code changes:
+
+```python
+# Use Modal (default) - great for production
+agent = TinyCodeAgent(provider="modal")
+
+# Future providers (coming soon)
+# agent = TinyCodeAgent(provider="docker")
+# agent = TinyCodeAgent(provider="local") 
+# agent = TinyCodeAgent(provider="lambda")
+```
+
+### Example Use Cases
+
+**Web Scraping:**
+```python
+result = await agent.run("""
+What are trending spaces on huggingface today?
+""")
+# Agent will create a python tool to request HuggingFace API and find trending spaces
+```
+
+**Use code to solve a task:**
+```python
+response = await agent.run(dedent("""
+Suggest me 13 tags for my Etsy Listing, each tag should be multiworded and maximum 20 characters. Each word should be used only once in the whole corpus, And tags should cover different ways people are searching for the product on Etsy.
+- You should use your coding abilities to check your answer pass the criteria and continue your job until you get to the answer.
+                                
+My Product is **Wedding Invitation Set of 3, in sage green color, with a gold foil border.**
+"""),max_turns=20)
+
+print(response)
+# LLM is not good at this task, counting characters, avoid duplicates, but with the power of code, tiny model like gpt-4.1-mini can do it without any problem.
+```
+
+
+### Configuration Options
+
+```python
+from tinyagent import TinyCodeAgent
+from tinyagent.code_agent.tools import get_weather, get_traffic
+
+# Full configuration example
+agent = TinyCodeAgent(
+    model="gpt-4.1-mini",
+    api_key="your-api-key", 
+    provider="modal",
+    tools=[get_weather, get_traffic],
+    authorized_imports=["requests", "pandas", "numpy"],
+    provider_config={
+        "pip_packages": ["requests", "pandas"],
+        "sandbox_name": "my-code-sandbox"
+    }
+)
+```
+
+For detailed documentation, see the [TinyCodeAgent README](tinyagent/code_agent/README.md).
+
 ## How the TinyAgent Hook System Works
 
 TinyAgent is designed to be **extensible** via a simple, event-driven hook (callback) system. This allows you to add custom logic, logging, UI, memory, or any other behavior at key points in the agent's lifecycle.

{tinyagent_py-0.0.8 → tinyagent_py-0.0.9}/pyproject.toml

@@ -9,8 +9,8 @@ exclude = ["public", "public.*"]
 
 [project]
 name = "tinyagent-py"
-version = "0.0.8"
-description = "Tiny Agent with MCP Client and Extendable Hooks, Tiny but powerful"
+version = "0.0.9"
+description = "TinyAgent with MCP Client, Code Agent (Thinking, Planning, and Executing in Python), and Extendable Hooks, Tiny but powerful"
 readme = "README.md"
 authors = [
   {name="Mahdi Golchin", email="golchin@askdev.ai"}
@@ -41,10 +41,21 @@ sqlite = [
 gradio = [
   "gradio>=3.50.0"
 ]
+code = [
+  "jinja2",
+  "pyyaml",
+  "cloudpickle",
+  "modal"
+]
 all = [
   "asyncpg>=0.27.0",
   "aiosqlite>=0.18.0",
-  "gradio>=3.50.0"
+  "gradio>=3.50.0",
+  "jinja2",
+  "pyyaml",
+  "cloudpickle",
+  "modal"
+
 ]
 [project.urls]
 "Homepage" = "https://github.com/askbudi/tinyagent"

tinyagent_py-0.0.9/tinyagent/__init__.py

@@ -0,0 +1,5 @@
+from .tiny_agent import TinyAgent,tool
+from .mcp_client import MCPClient
+from .code_agent import TinyCodeAgent
+
+__all__ = ["TinyAgent", "MCPClient","tool", "TinyCodeAgent"]

tinyagent_py-0.0.9/tinyagent/code_agent/__init__.py

@@ -0,0 +1,12 @@
+from .tiny_code_agent import TinyCodeAgent
+from .providers.base import CodeExecutionProvider
+from .providers.modal_provider import ModalProvider
+from .tools.example_tools import get_weather, get_traffic
+
+__all__ = [
+    "TinyCodeAgent",
+    "CodeExecutionProvider", 
+    "ModalProvider",
+    "get_weather",
+    "get_traffic"
+]

tinyagent_py-0.0.9/tinyagent/code_agent/example.py

@@ -0,0 +1,176 @@
+"""
+Example usage of TinyCodeAgent with Gradio UI.
+
+This example demonstrates how to initialize and use TinyCodeAgent
+following the guidelines from gradio_agent.md and README.md.
+"""
+
+import asyncio
+import os
+import sys
+import tempfile
+import shutil
+import logging
+from typing import Dict, Any, Union
+
+from tinyagent.hooks.logging_manager import LoggingManager
+from tinyagent.hooks.gradio_callback import GradioCallback
+from .tiny_code_agent import TinyCodeAgent
+from .tools.example_tools import get_weather, get_traffic
+
+
+async def run_example():
+    """Example usage of TinyCodeAgent with GradioCallback."""
+    
+    # --- Logging Setup ---
+    log_manager = LoggingManager(default_level=logging.INFO)
+    log_manager.set_levels({
+        'tinyagent.hooks.gradio_callback': logging.DEBUG,
+        'tinyagent.tiny_agent': logging.DEBUG,
+        'tinyagent.mcp_client': logging.DEBUG,
+        'tinyagent.code_agent': logging.DEBUG,
+    })
+    
+    console_handler = logging.StreamHandler(sys.stdout)
+    log_manager.configure_handler(
+        console_handler,
+        format_string='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+        level=logging.DEBUG
+    )
+    
+    ui_logger = log_manager.get_logger('tinyagent.hooks.gradio_callback')
+    agent_logger = log_manager.get_logger('tinyagent.code_agent')
+    ui_logger.info("--- Starting TinyCodeAgent Example ---")
+    
+    # --- Configuration ---
+    model = "gpt-4.1-mini"
+    api_key = os.environ.get("OPENAI_API_KEY")
+    if not api_key:
+        ui_logger.error("OPENAI_API_KEY environment variable not set.")
+        return
+
+    # Create a temporary folder for file uploads
+    upload_folder = tempfile.mkdtemp(prefix="gradio_uploads_")
+    ui_logger.info(f"Created temporary upload folder: {upload_folder}")
+    
+    # --- Modal Configuration ---
+    modal_secrets: Dict[str, Union[str, None]] = {
+        "OPENAI_API_KEY": api_key,
+        # Add other secrets as needed
+    }
+    
+    provider_config = {
+        "modal_secrets": modal_secrets,
+        "pip_packages": ["tinyagent-py[all]", "requests", "cloudpickle"],
+        "default_python_codes": [
+            "import random",
+            "import requests", 
+            "import cloudpickle",
+            "import tempfile",
+            "import shutil",
+            "import asyncio",
+            "import logging",
+            "import time"
+        ]
+    }
+    
+    try:
+        # --- Initialize TinyCodeAgent ---
+        agent = TinyCodeAgent(
+            model=model,
+            api_key=api_key,
+            log_manager=log_manager,
+            provider="modal",
+            tools=[get_weather, get_traffic],
+            provider_config=provider_config
+        )
+        
+        # --- Create Gradio UI ---
+        gradio_ui = GradioCallback(
+            file_upload_folder=upload_folder,
+            show_thinking=True,
+            show_tool_calls=True,
+            logger=ui_logger
+        )
+        agent.add_callback(gradio_ui)
+        
+        # --- Connect to MCP servers (as per contribution guide) ---
+        try:
+            ui_logger.info("Connecting to MCP servers...")
+            await agent.connect_to_server("npx", ["-y", "@modelcontextprotocol/server-sequential-thinking"])
+            ui_logger.info("Connected to MCP servers.")
+        except Exception as e:
+            ui_logger.warning(f"Failed to connect to MCP servers: {e}")
+            # Continue without servers - we still have the local tools
+        
+        # --- Launch Gradio Interface ---
+        ui_logger.info("Launching Gradio interface...")
+        try:
+            gradio_ui.launch(
+                agent.agent,  # Pass the underlying TinyAgent
+                title="TinyCodeAgent Chat Interface",
+                description="Chat with TinyCodeAgent. Try asking: 'I need to know the weather and traffic in Toronto, Montreal, New York, Paris and San Francisco.'",
+                share=False,
+                prevent_thread_lock=True,
+                show_error=True,
+                mcp_server=True,
+            )
+            ui_logger.info("Gradio interface launched (non-blocking).")
+            
+            # Keep the event loop running
+            while True:
+                await asyncio.sleep(1)
+                
+        except KeyboardInterrupt:
+            ui_logger.info("Received keyboard interrupt, shutting down...")
+        except Exception as e:
+            ui_logger.error(f"Failed to launch or run Gradio app: {e}", exc_info=True)
+            
+    finally:
+        # Clean up
+        ui_logger.info("Cleaning up resources...")
+        if os.path.exists(upload_folder):
+            ui_logger.info(f"Removing temporary upload folder: {upload_folder}")
+            shutil.rmtree(upload_folder)
+        
+        if 'agent' in locals():
+            await agent.close()
+        
+        ui_logger.info("--- TinyCodeAgent Example Finished ---")
+
+
+def simple_example():
+    """Simple example without Gradio UI."""
+    async def _simple_example():
+        # Basic setup
+        api_key = os.environ.get("OPENAI_API_KEY")
+        if not api_key:
+            print("OPENAI_API_KEY environment variable not set.")
+            return
+        
+        # Initialize TinyCodeAgent
+        agent = TinyCodeAgent(
+            model="gpt-4.1-mini",
+            api_key=api_key,
+            tools=[get_weather, get_traffic]
+        )
+        
+        try:
+            # Run a simple query
+            result = await agent.run(
+                "I need to check the weather and traffic in Toronto. Can you help me?"
+            )
+            print(f"\nResult: {result}")
+            
+        finally:
+            await agent.close()
+    
+    asyncio.run(_simple_example())
+
+
+if __name__ == "__main__":
+    # Run the full example with Gradio
+    asyncio.run(run_example())
+    
+    # Uncomment to run the simple example instead
+    # simple_example()