tiny-agent-os 0.65__py3-none-any.whl

tiny_agent_os-0.65.dist-info/METADATA

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: tiny_agent_os
+Version: 0.65
+Summary: A streamlined framework for building powerful LLM-powered agents
+Author-email: tinyagent <contact@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/tinyagent/tinyagent
+Project-URL: Bug Tracker, https://github.com/tinyagent/tinyagent/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: jinja2>=3.1.2
+Requires-Dist: click>=8.1.6
+Requires-Dist: rich>=13.7.1
+Requires-Dist: jsonschema>=4.10.3
+Requires-Dist: typing-extensions>=4.10.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: regex>=2023.0.0
+
+# tinyAgent 🤖
+
+A streamlined framework for building powerful LLM-powered agents that can solve complex tasks through tool execution, orchestration, and dynamic capability creation.
+
+**Made by (x) @tunahorse21 | A product of alchemiststudios.ai**
+
+> **Heads Up**: tinyAgent is in BETA until V1. It's working but still evolving!  
+> While I can't guarantee it's 100% bug-free, I'm actively improving it whenever I can between my day job and business.
+> Found something that could be better? Show off your skills and open an issue with a fix: I'd genuinely appreciate it!
+
+![tinyAgent Logo](tintAgentLogo.png)
+
+```
+   __  .__                _____                         __
+_/  |_|__| ____ ___.__. /  _  \    ____   ____   _____/  |_
+\   __\  |/    <   |  |/  /_\  \  / ___\_/ __ \ /    \   __\
+ |  | |  |   |  \___  /    |    \/ /_/  >  ___/|   |  \  |
+ |__| |__|___|  / ____\____|__  /\___  / \___  >___|  /__|
+              \/\/            \//_____/      \/     \/
+```
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/alchemiststudiosDOTai/tinyAgent.git
+
+cd tinyagent
+
+# Option 1: For Linux users, run the installation script
+chmod +x install/linuxInstall.sh && ./install/linuxInstall.sh
+
+# Option 2: Manual installation
+# Create a virtual environment (recommended)
+python3 -m venv .venv
+
+# Activate the virtual environment
+# On macOS/Linux
+source .venv/bin/activate
+# On Windows
+.\.venv\Scripts\activate
+
+# Install dependencies
+# Option 1: Using UV (recommended - see INSTALL.md for details)
+# Option 2: Using pip
+pip install -r requirements.txt
+
+# Set up required configuration files
+# 1. Environment variables
+cp .envexample .env
+# Edit .env to add your API keys (especially OpenRouter)
+
+# 2. Configuration file
+cp exampleconfig.yml config.yml
+# Edit config.yml to customize your settings
+```
+
+### Pip Installation
+
+```bash
+# Simple pip installation
+pip install tinyagent
+```
+
+**Note:** The orchestrator component is currently being built and is in beta.
+
+---
+
+## Philosophy
+
+1. **Functions as Agents**
+   - You can turn **any function** into a **tool** or **agent**.
+   - This makes it easy to add new capabilities.
+
+```mermaid
+flowchart LR
+    A["Python Function"] --> B["Tool"]
+    B --> C["Agent"]
+    C --> D["Result"]
+```
+
+![Function to Agent Flow](static/images/func_agent.png)
+
+```python
+# Define a simple calculator function and turn it into a tool
+@tool
+def calculate_sum(a: int, b: int) -> int:
+    """Calculate the sum of two integers."""
+    return a + b
+
+def main():
+    """Create a basic agent with a calculator tool."""
+    # One-liner: create agent with our tool directly
+    agent = AgentFactory.get_instance().create_agent(tools=[calculate_sum])
+    # Run the agent with a query
+    query = "calculate the sum of 5 and 3"
+    print(f"Running agent with query: '{query}'")
+    # you can also specify the expected type of the result
+    result = agent.run(query, expected_type=int)
+    print(f"Result: {result}")
+    print(f"Result Type: {type(result)}")
+```
+
+2. **Hierarchical Orchestration**
+   - You can **combine many agents** together.
+   - A **top-level agent** or **orchestrator** can **delegate tasks** to **specialized agents**.
+   - This helps solve **complex problems** by breaking them into parts.
+
+```mermaid
+flowchart TD
+    O["Research Orchestrator"] --> A1["Web Search Agent"]
+    O --> A2["Summarizer Agent"]
+    O --> A3["Code Snippet Agent"]
+```
+
+---
+
+## Features
+
+1. **Modular Design**
+
+   - Tools are defined with `@tool` and easily integrated or swapped.
+
+2. **Flexible Agent Options**
+
+   - **Orchestrator**: Simple task execution.
+   - **AgentFactory**: Fine-tuned control.
+   - **DynamicAgentFactory**: Dynamic agent creation.
+
+3. **Centralized Setup**
+
+   - Factory pattern streamlines configuration and logging.
+
+4. **Robust Error Handling**
+
+   - Custom exceptions (e.g., `ToolError`) improve debugging.
+
+5. **Clean Code Structure**
+
+   - Agents handle logic; tools handle execution.
+
+6. **Versatile Interaction**
+
+   - Use `agent.execute_tool()` for precision or `agent.run()` for broader tasks.
+
+7. **Structured Output**
+   - Enforce JSON structure on LLM responses for consistent parsing
+   - Enable with `output.structured: true` in config.yml
+   - Compatible with OpenRouter's JSON schema validation
+
+---
+
+## Acknowledgments & Inspo
+
+We'd like to thank the creators of these amazing projects that inspired TinyAgent:
+
+- My Wife
+- [HuggingFace SmoLAgents](https://github.com/huggingface/smolagents)
+- [Aider-AI](https://github.com/Aider-AI/aider)
+- [Kyon-eth](https://github.com/kyon-eth)
+- [RA.Aid](https://github.com/ai-christianson/RA.Aid)
+
+---
+
+## Key Takeaways
+
+- **tinyAgent** is perfect for scalable AI projects needing structured agent and tool management.
+- It offers **extensibility**, **error handling**, and **logging**, but may be overkill for simple tasks.
+
+_Important Note on Tools_:
+
+The aider tool integrated in TinyAgent is extremely powerful but requires proper understanding to use effectively. It's highly configurable with many advanced features that can dramatically enhance productivity when used correctly.
+
+**⚠️ We strongly recommend thoroughly learning aider before using it in any serious projects.**
+
+Invest time in studying the documentation at https://aider.chat/ to understand its capabilities, configuration options, and best practices. This investment will pay off significantly in your development workflow.

tiny_agent_os-0.65.dist-info/RECORD

@@ -0,0 +1,49 @@
+tinyagent/__init__.py,sha256=ihXSN3WrMmlmMGKf4l-0NFYXEwUrRuXxcHjdFWBcn1g,1681
+tinyagent/agent.py,sha256=3911u3i5eGkq1nHa-cuxQeIRNWXyUvmmQswT8gLL4-8,40031
+tinyagent/decorators.py,sha256=f_PCRZAzB8y_sQOCR0ImnEGGzd7oGIEguRHyc-Q-OoE,6174
+tinyagent/exceptions.py,sha256=EkwEDZ3iQT8WyieB_CiIORldSOFOx9W4WSmQm753qdA,2806
+tinyagent/logging.py,sha256=u8K4zQ9wLhhL0ZHHPDfdF_BFVT3snvk_xi-aP689fZQ,3203
+tinyagent/tool.py,sha256=HKsE3x-hzFLYlmB8aq8hjbY8-FAA0GGGzFlYTDq7g3I,7503
+tinyagent/chat/__init__.py,sha256=owc9w-CD15RjxT7hEU-pdFNykuFmNhsvMc2xb3wVDr8,284
+tinyagent/chat/chat_mode.py,sha256=0Ub1YTGvQxin1Be3xLzXX01SgltAnl6LHQJygcLtZtw,11115
+tinyagent/cli/__init__.py,sha256=6JNnHXyHi1-ukZK3elVFL8k7KKGC7nV1etH_MjBMaS8,343
+tinyagent/cli/colors.py,sha256=yr8wSfW13glywI8lySfvhDLhiXf9O6ULHZFO-1BrMFc,2996
+tinyagent/cli/main.py,sha256=hv8sMF74BZQb-Sma0FZ0_deuaYDQDtrHYDDrk1cGcrE,29859
+tinyagent/cli/spinner.py,sha256=rJvt6SEG-Gt6js-tzkhI1G3-06xzSns9d92y1JTYNdg,2934
+tinyagent/config/__init__.py,sha256=AFD7-AQOJsVBsSN3qmvcjDgdTJhwY3aM2h7VJ3AehwQ,367
+tinyagent/config/config.py,sha256=U-1bcjzm8Mww1XNowtoexrtgfedH0AXNwAmvVpM-tvI,8319
+tinyagent/factory/__init__.py,sha256=bHmJLXpTRZUFjVLGq_F3yl9av3ArHaABvzJ8oH2cM-Y,486
+tinyagent/factory/agent_factory.py,sha256=N-FWUrP82EChhJWULusEfAxUa3Oq-DWU2sUwRNq_0BE,14595
+tinyagent/factory/dynamic_agent_factory.py,sha256=dMjI3XFKIUYLQbGvV1v-Dy2A4kqtg9CQE9WzHpSCiOg,22362
+tinyagent/factory/orchestrator.py,sha256=NRXp34-VK1dM6nFAW1czuMjf1-zE5uhM17pVXdZR1Z0,66105
+tinyagent/mcp/__init__.py,sha256=69prCGimznH3qCPUv_5nQSuTrhTs7t56xvi8Vcg4zNo,367
+tinyagent/mcp/manager.py,sha256=J1WdJDm-31XJcRjbVGTdG2cJuAN1BQdZzaJRuZJNzoY,11084
+tinyagent/tools/__init__.py,sha256=UqvRXrWfF4a2pJJof6j9R_pb-DKqX7x1pbxfyzoHslQ,1537
+tinyagent/tools/aider.py,sha256=Uqe1F0o_Hrzs-OyycPqqqaKM0Ufs2S0Vbz_cGthmyT4,4365
+tinyagent/tools/anon_coder.py,sha256=AHu9KG_cxeHtzazCe2D0TEurImpP6D5yWNOJXcL4vQo,10980
+tinyagent/tools/boilerplate_tool.py,sha256=iNLHNscgNFz6jv4jPmfItCtuL1ZDM1zjAhG0Ngxi3g8,4606
+tinyagent/tools/brave_search.py,sha256=_2gLgI7BB9WWX3ukvqHi-0vCWhNwT7dGe_iyRlCv3Xo,3121
+tinyagent/tools/business_deepsearch.py,sha256=TWminnLJHh36IvyalJBMCjhrJ1xVGsisp-mN7412uZY,32918
+tinyagent/tools/codeagent_tool.py,sha256=npID8oDEn3NtvcF9FKWgvAJXBIxrktm8vbtl5VveKMo,6918
+tinyagent/tools/content_processor.py,sha256=PEuMUzbMvDd2ufc4zqhoiZnWJlyxPU4jeam_dAdEiN0,11211
+tinyagent/tools/custom_text_browser.py,sha256=XxsFeJ90g1WIwbxTLSzOnKaUmNVBxLPfLQr-0pL3Ryo,34922
+tinyagent/tools/duckduckgo_search.py,sha256=9G2eaM8toz-JKZMbALCIToXq8mVWVq0EV5fT8mN4PAI,5643
+tinyagent/tools/enhanced_deepsearch.py,sha256=mLu2MdEg4XxxbhCyumjHy0tv69y7S28IBFgYCByZVrk,63359
+tinyagent/tools/external.py,sha256=qF-ufyaYI9ZW7Fh2ZOyIxdHbXzxDFnU0re3aYoe1avw,12873
+tinyagent/tools/file_manipulator.py,sha256=v6LM384_Im-OM-KuqxaiHAbbMPWZRYSKVcm0xUQtd10,11377
+tinyagent/tools/final_extractor_tool.py,sha256=ofoeIINm8wIyP7N5HfbYdvqRs0RIpBATa_krr0eV8vE,9540
+tinyagent/tools/llm_serializer.py,sha256=12z-DXLm3MJl6eeSCPnAGieUHoSiApaOBDnm1js1LFE,4321
+tinyagent/tools/markdown_gen.py,sha256=Nr3mw0uJQsaCRLLWHHiZ0O4e9SSbybxHUS_zwGaRm_Q,10963
+tinyagent/tools/ripgrep.py,sha256=mrXraq-RbUAPCxrbXLDmWycAhCoyU4n1if_2IyzDh5A,4288
+tinyagent/utils/__init__.py,sha256=ZqqDlpSKbeBZ9XNIa4xUi-KE7de7btI3E69Irif4E20,309
+tinyagent/utils/json_parser.py,sha256=DF_x7ygz3xZwuK49GrKMO7vLa3hsZqw59wiUWGEuOeQ,7647
+tinyagent/utils/logging_utils.py,sha256=YxMCY9PNEXulxuzKR5PDMfyWf7-7o_g0-k5Qyb0X9MU,1998
+tinyagent/utils/openrouter_request.py,sha256=wfNjg-tzrgErKCAWZ0df0-0fmKUiKK7pt_WxxoMZzjU,3760
+tinyagent/utils/serialization.py,sha256=jd0b_Gf9sNyg0haUYw5oY0wc3EuobHOUa6TfhkYiFwc,5453
+tinyagent/utils/structured_outputs.py,sha256=IKkZSOHKorpiVc32fA-DtEiBjogTTwtKVyCEFxmsm3A,4843
+tinyagent/utils/type_converter.py,sha256=imPyWYmTIZHDDBwLAdGJHojYLWFERz4Yjl9kKHPtp3Y,7183
+tiny_agent_os-0.65.dist-info/METADATA,sha256=aKcyqN5siaEmwjrkYRPSI9muqtDGAHKha7rPcqrcSV4,6384
+tiny_agent_os-0.65.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+tiny_agent_os-0.65.dist-info/entry_points.txt,sha256=_haUtRmoC4JvXuzSJfRQXaMd7mpC1AbL_DTRpXRYa0w,50
+tiny_agent_os-0.65.dist-info/top_level.txt,sha256=Ny8aJNchZpc2Vvhp3306L5vjceJakvFxBk-UjjVeA_I,10
+tiny_agent_os-0.65.dist-info/RECORD,,

tiny_agent_os-0.65.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (78.1.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tiny_agent_os-0.65.dist-info/entry_points.txt

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

tiny_agent_os-0.65.dist-info/top_level.txt

@@ -0,0 +1 @@
+tinyagent

tinyagent/__init__.py

@@ -0,0 +1,71 @@
+"""
+Core components for the tinyAgent framework.
+
+This package contains the core components of the tinyAgent framework, including
+the Agent class, Tool framework, configuration management, and utilities.
+"""
+
+__version__ = "0.65"
+
+# Core components
+from .agent import Agent, get_llm
+from .tool import Tool, ParamType
+from .decorators import tool
+from .exceptions import (
+    TinyAgentError, ConfigurationError, 
+    ToolError, ToolNotFoundError, ToolExecutionError,
+    RateLimitExceeded, ParsingError, 
+    AgentRetryExceeded, OrchestratorError, AgentNotFoundError
+)
+
+# Factory components
+from .factory import (
+    AgentFactory, DynamicAgentFactory, 
+    Orchestrator, TaskStatus
+)
+
+# Logging utilities
+from .logging import configure_logging, get_logger
+
+# Configuration utilities
+from .config import load_config, get_config_value
+
+# CLI utilities
+from .cli import (
+    main as CLI,  # Use main function as CLI for backward compatibility
+    Colors, 
+    Spinner
+)
+
+# Chat mode
+from .chat import run_chat_mode
+
+# Public exports
+__all__ = [
+    # Core components
+    'Agent', 'get_llm', 
+    'Tool', 'ParamType',
+    'tool',
+    
+    # Exception classes
+    'TinyAgentError',
+    'ConfigurationError',
+    'ToolError', 'ToolNotFoundError', 'ToolExecutionError',
+    'RateLimitExceeded',
+    'ParsingError',
+    'AgentRetryExceeded',
+    'OrchestratorError', 'AgentNotFoundError',
+    
+    # Factory components
+    'AgentFactory', 'DynamicAgentFactory',
+    'Orchestrator', 'TaskStatus',
+    
+    # Utilities
+    'configure_logging', 'get_logger',
+    'load_config', 'get_config_value',
+    'Colors', 'Spinner', 'CLI',
+    'run_chat_mode',
+    
+    # Version
+    '__version__'
+]