tiny-agent-os 0.0.1__tar.gz

tiny_agent_os-0.0.1/.aider.conf.yml

@@ -0,0 +1,36 @@
+##########################################################
+# Aider Configuration
+##########################################################
+
+# this is just an example aider configs are highly configurable please take the time to learn this 
+# Model settings
+model: openrouter/deepseek/deepseek-chat
+timeout: 120
+
+# API settings/Same as openrouter
+env-file: .env
+
+# Cache settings
+cache-prompts: True
+cache-keepalive-pings: 2
+
+# History Files
+input-history-file: .aider.input.history
+chat-history-file: .aider.chat.history.md
+restore-chat-history: false
+llm-history-file: .aider.llm.history
+
+# Output settings
+dark-mode: True
+
+# Git settings
+gitignore: true
+auto-commits: true
+dirty-commits: true
+
+# Model aliases
+alias:
+  - "c:openrouter/anthropic/claude-3.5-sonnet"
+  - "d:openrouter/deepseek/deepseek-chat"
+
+

tiny_agent_os-0.0.1/.envexample

@@ -0,0 +1,9 @@
+# API Keys - Replace with your actual keys
+OPENROUTER_API_KEY=your_openrouter_key_here
+BRAVE=your_brave_key_here
+
+TINYAGENT_PROXY_USERNAME=proxyuser
+TINYAGENT_PROXY_PASSWORD=proxyuser_pw
+TINYAGENT_PROXY_COUNTRY=US
+
+

tiny_agent_os-0.0.1/.gitignore

@@ -0,0 +1,122 @@
+# Environment and configuration
+.pypirc
+.aider*
+.env
+.env.*
+.conf
+config.local.yml
+api-key
+openrouter=*
+*.pem
+*.key
+secrets/
+
+# Project specific
+tinyAgent_output/
+downloads/
+**/node_modules/
+EVAL/
+uv.lock
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+.pytest_cache/
+pytest_cache/
+.coverage.*
+coverage.*
+output/
+
+# Virtual Environment
+venv/
+ENV/
+env.bak/
+venv.bak/
+.venv/
+virtualenv/
+.python-version
+
+# IDEs and editors
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+*.sublime-project
+
+# Visual artifacts and UI
+node_modules/
+*.log
+logs/
+*.sqlite
+*.db
+*.out
+.cache/
+tmp/
+temp/
+.tmp/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Testing
+.coverage
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+.pytest_cache/
+orgDeploy.sh
+
+# Compiled files
+*.com
+*.class
+*.dll
+*.exe
+*.o
+*.a
+*.dylib
+
+# Package files
+*.7z
+*.dmg
+*.gz
+*.iso
+*.jar
+*.rar
+*.tar
+*.zip
+
+# OS generated files
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+output/research_results/*.json
+
+

tiny_agent_os-0.0.1/LICENSE

@@ -0,0 +1,53 @@
+# tinyAgent Business Source License 1.1
+
+License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.  
+"Business Source License" is a trademark of MariaDB Corporation Ab.  
+Adapted for tinyAgent by Alchemist Studios.
+
+---
+
+## Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work. The Licensor may make an Additional Use Grant, below, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly available distribution of a specific version of the Licensed Work under this License, whichever comes first, the Licensor hereby grants you rights under the terms of the Change License, and the rights granted in the paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the requirements currently in effect as described in this License, you must purchase a commercial license from the Licensor, its affiliated entities, or authorized resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of the Licensed Work, are subject to this License. This License applies separately for each version of the Licensed Work, and the Change Date may vary for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy of the Licensed Work. If you receive the Licensed Work in original or modified form from a third party, the terms and conditions set forth in this License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically terminate your rights under this License for the current and all other versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor or its affiliates (provided that you may use a trademark or logo of Licensor as expressly required by this License).
+
+THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE LICENSED WORK.
+
+---
+
+## Additional Use Grant
+
+You may make production use of the Licensed Work, provided such use does not include offering the Licensed Work to third parties on a hosted or embedded basis that is competitive with the Licensor's products.
+
+---
+
+## Change License
+
+MIT License
+
+---
+
+## Change Date
+
+No Change Date - License does not expire.
+
+---
+
+## Usage Limitation
+
+- **Free** for individuals and businesses with annual revenue below $1 million USD.
+- **Paid license required** for businesses with annual revenue exceeding $1 million USD.
+- For commercial licensing inquiries, contact: [admin@alchemiststudios.ai](mailto:admin@alchemiststudios.ai).
+
+---

tiny_agent_os-0.0.1/MANIFEST.in

@@ -0,0 +1,4 @@
+recursive-include src/tinyagent/prompts *.md
+recursive-include src/tinyagent/prompts/system *.md
+recursive-include src/tinyagent/prompts/tools *.md
+recursive-include src/tinyagent/prompts/workflows *.md

tiny_agent_os-0.0.1/PKG-INFO

@@ -0,0 +1,377 @@
+Metadata-Version: 2.4
+Name: tiny_agent_os
+Version: 0.0.1
+Summary: A streamlined framework for building powerful LLM-powered agents that can solve complex tasks through tool execution, orchestration, and dynamic capability creation.
+Author-email: "(x) @tunahorse21" <info@alchemiststudios.ai>
+License-Expression: BUSL-1.1
+Project-URL: Homepage, https://github.com/alchemiststudiosai/tinyAgent
+Project-URL: Bug Tracker, https://github.com/alchemiststudiosai/tinyAgent/issues
+Project-URL: Documentation, https://github.com/alchemiststudiosai/tinyAgent/blob/main/README.md
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+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
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+---
+
+# tinyAgent 🤖
+
+![tinyAgent Logo](static/images/tinyAgent_logo_v2.png)
+
+```
+   __  .__                _____                         __
+_/  |_|__| ____ ___.__. /  _  \    ____   ____   _____/  |_
+\   __\  |/    <   |  |/  /_\  \  / ___\_/ __ \ /    \   __\
+ |  | |  |   |  \___  /    |    \/ /_/  >  ___/|   |  \  |
+ |__| |__|___|  / ____\____|__  /\___  / \___  >___|  /__|
+              \/\/            \//_____/      \/     \/
+```
+
+**Made by (x) [@tunahorse21](https://x.com/tunahorse21) | A product of [alchemiststudios.ai](https://alchemiststudios.ai)**
+
+---
+
+## Heads Up
+
+tinyAgent is in **BETA** until V1. It's working but still evolving! I can't guarantee it's 100% bug-free, but 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!
+
+---
+
+## Overview
+
+tinyAgent is a streamlined framework for building powerful, LLM-powered agents that solve complex tasks through tool execution, orchestration, and dynamic capability creation. Convert any Python function into a useful tool and then into an agent with minimal configuration, unlocking a world of scalable, modular possibilities.
+
+---
+
+## Installation
+
+### Via pip (Recommended)
+
+```bash
+pip install tiny_agent_os
+```
+
+---
+
+## Post-Installation Configuration for Pip Users
+
+After installing via `pip`, you'll need to provide your own configuration files. For convenience, you can download the defaults directly:
+
+---
+
+### Download the Configuration File (`config.yml`)
+
+**Using `wget`:**
+
+```bash
+wget https://raw.githubusercontent.com/alchemiststudiosDOTai/tinyAgent/v0.65/config.yml
+```
+
+---
+
+### Download the Environment File (`.env`)
+
+Download the example environment file and rename it to `.env`:
+
+**Using `wget`:**
+
+```bash
+wget https://raw.githubusercontent.com/alchemiststudiosDOTai/tinyAgent/v0.65/.envexample -O .env
+```
+
+> **Note:** Be sure to edit the `.env` file with your actual API keys and any other required variables.
+
+---
+
+### Cloning for Development
+
+```bash
+git clone https://github.com/alchemiststudiosDOTai/tinyAgent.git
+cd tinyAgent
+```
+
+---
+
+## Post-Installation Configuration
+
+After installing (either via pip or from source), remember to configure your environment and `.env` files with relevant API keys from https://openrouter.ai
+
+Both the config.yml and env work out of the box with a openrouter API, you can use any openai API, and the config has an example of a local LLM.
+The /documentation folder has more details and is being updated.
+
+---
+
+## Tools and the `@tool` Decorator
+
+In tinyAgent, **any Python function** can be transformed into a usable "tool" by simply decorating it with `@tool`. This makes it discoverable by your agents, allowing them to execute that function in response to natural-language queries.
+
+### Example
+
+```python
+from tinyagent.decorators import tool
+
+@tool
+def greet_person(name: str) -> str:
+    """Return a friendly greeting."""
+    return f"Hello, {name}!"
+```
+
+That's it! Once decorated, `greet_person` can be included in an agent's list of tools, letting your LLM-driven agent call it as needed.
+
+### Example – `calculate_sum` Tool
+
+Turn a plain Python function into a natural-language skill with `@tool` and `tiny_agent`.
+
+```python
+from tinyagent.decorators import tool
+from tinyagent.agent import tiny_agent
+
+@tool
+def calculate_sum(a: int, b: int) -> int:
+    """Return the sum of two integers."""
+    return a + b
+
+if __name__ == "__main__":
+    agent = tiny_agent(tools=[calculate_sum])
+    query = "calculate the sum of 5 and 3"
+    result = agent.run(query, expected_type=int)
+    print(f"Query: '{query}' -> Result: {result}")
+```
+
+Console output:
+
+```
+Validating args for tool: calculate_sum
+Arguments provided: {'a': 5, 'b': 3}
+Query: 'calculate the sum of 5 and 3' -> Result: 8
+```
+
+---
+
+## Philosophy
+
+tinyAgent is built on two core ideas:
+
+### 1. Functions as Agents
+
+Any Python function can be turned into a tool—and then seamlessly integrated into an agent. This approach makes extending and innovating simple.
+
+```mermaid
+flowchart LR
+    A["Python Function"] --> B["Tool"]
+    B --> C["Agent"]
+    C --> D["Result"]
+```
+
+![Function to Agent Flow](static/images/func_agent.png)
+
+```python
+#!/usr/bin/env python3
+"""
+Example: Functions as Agents
+"""
+from tinyagent.decorators import tool
+from tinyagent.agent import tiny_agent
+
+@tool
+def calculate_sum(a: int, b: int) -> int:
+    """Calculate the sum of two integers."""
+    return a + b
+
+
+def main():
+    # Create an agent with the calculate_sum tool
+    agent = tiny_agent(tools=[calculate_sum])
+    query = "calculate the sum of 5 and 3"
+    result = agent.run(query, expected_type=int)
+    print(f"Query: '{query}' -> Result: {result}")
+
+
+if __name__ == "__main__":
+    main()
+```
+
+### 2. tiny_chain Orchesration
+
+- IN BETA
+
+tiny_chain is the main engine of tinyAgent's orchestration. It lets your agent solve complex tasks by chaining together multiple tools, using an LLM-powered "triage agent" to plan the best sequence. If the plan fails, tiny_chain falls back to running all tools in sequence, ensuring robustness and reliability.
+
+```mermaid
+flowchart LR
+    A["User Query"] --> B["Triage Agent"]
+    B --> C["Tool Planning"]
+    C --> D["Tool Execution"]
+    D --> E["Search"] --> F["Browser"] --> G["Summarize"]
+    G --> H["Final Result"]
+
+    style B fill:#f9f,stroke:#333,stroke-width:2px
+    style E fill:#bbf,stroke:#333,stroke-width:2px
+    style F fill:#bbf,stroke:#333,stroke-width:2px
+    style G fill:#bbf,stroke:#333,stroke-width:2px
+```
+
+- **Simple:** You describe your task in natural language. tiny_chain figures out which tools to use and in what order.
+- **Smart:** The triage agent (an LLM) analyzes your query and suggests a plan—sometimes a single tool, sometimes a multi-step chain.
+- **Robust:** If the triage agent can't make a good plan, tiny_chain just tries all tools, so you always get an answer.
+- **Extensible:** Add new tools or improve the triage agent to handle more complex workflows.
+
+**How it works (technical overview):**
+
+- When you submit a task, tiny_chain asks the triage agent for a plan (JSON: single tool or sequence).
+- If the plan is valid, tiny_chain executes the tools in order, passing results between them.
+- If the plan is invalid or fails, tiny_chain runs all tools as a fallback.
+- All errors are caught and logged, so you always get feedback.
+
+### tiny_chain Example – "Tariff Research Tool"
+
+Use this snippet (or drop-in file) anywhere in your docs to show **exactly how tiny_chain works** end-to-end.
+
+```python
+#!/usr/bin/env python3
+"""
+tiny_chain example: automatically find and summarise U.S. import-tariff data
+"""
+from tinyagent.factory.tiny_chain import tiny_chain
+from tinyagent.tools.duckduckgo_search import get_tool as search_tool
+from tinyagent.tools.custom_text_browser import get_tool as browser_tool
+from tinyagent.decorators import tool
+from tinyagent.agent import get_llm
+
+@tool(name="summarize", description="Summarize input text with the LLM")
+def summarize(text: str) -> str:
+    prompt = f"Summarize the following text:\n\n{text}\n\nSummary:"
+    return get_llm()(prompt).strip()
+
+# 1 – build the chain
+chain = tiny_chain.get_instance(
+    tools=[search_tool(), browser_tool(), summarize._tool]
+)
+
+# 2 – submit any natural-language task
+task_id = chain.submit_task(
+    "Find current US import tariffs and visit official trade websites for details"
+)
+
+# 3 – get structured results
+print(chain.get_task_status(task_id).result)
+```
+
+**What it demonstrates**
+
+| tiny_chain feature                        | Visible in run                                     |
+| ----------------------------------------- | -------------------------------------------------- |
+| 🔗 Automatic tool planning (triage agent) | Picks _search → browser → summarize_               |
+| 🛠 Pluggable tools                         | Search + browser + summarize tools in sequence     |
+| 📝 Structured trace                       | `steps`, `tools_used`, errors if any               |
+| 🤖 LLM-powered step                       | `summarize` converts page content → concise answer |
+
+Copy-paste, run, and you have a minimal yet complete example of tiny_chain orchestrating multiple tools to solve a real research task.
+
+### Key links
+
+- **Harmonized Tariff Schedule (USITC)**  
+  <https://hts.usitc.gov/>
+
+- **FTA Tariff Tool (International Trade Administration)**  
+  <https://www.trade.gov/fta-tariff-tool-home>
+
+- **CBP – Determining Duty Rates**  
+  <https://www.cbp.gov/trade/programs-administration/determining-duty-rates>
+
+### Console Output
+
+```text
+============================================================
+Tariff Research Tool
+============================================================
+
+Researching: 'Find current US import tariffs and use the browser to visit official trade websites to get details'
+------------------------------------------------------------
+
+Tool Chain Steps:
+
+=== Step 1 ===
+Tool: search
+Top hit → Harmonized Tariff Schedule (hts.usitc.gov)
+
+=== Step 2 ===
+Tool: browser
+Visited title → Harmonized Tariff Schedule
+
+=== Step 3 ===
+Tool: summarize
+Result →
+To find current US import tariffs, consult the **Harmonized Tariff Schedule (HTS)**
+on the USITC website.
+For Free‑Trade Agreement rates, use the **FTA Tariff Tool** on trade.gov.
+CBP also provides duty‑rate guidance.
+
+------------------------------------------------------------
+Tools used: search → browser → summarize
+```
+
+**What it demonstrates**
+
+| tiny_chain feature                        | Visible in run                                     |
+| ----------------------------------------- | -------------------------------------------------- |
+| 🔗 Automatic tool planning (triage agent) | Picks _search → browser → summarize_               |
+| 🛠 Pluggable tools                         | Search + browser + summarize tools in sequence     |
+| 📝 Structured trace                       | `steps`, `tools_used`, errors if any               |
+| 🤖 LLM-powered step                       | `summarize` converts page content → concise answer |
+
+Copy-paste, run, and you have a minimal yet complete example of tiny_chain orchestrating multiple tools to solve a real research task.
+
+---
+
+## Features
+
+- **Modular Design:** Easily convert any function into a tool.
+- **Flexible Agent Options:** Use the simple orchestrator or advanced `AgentFactory`.
+- **Robust Error Handling:** Improved debugging with custom exceptions.
+- **Structured Output:** Enforce JSON formats for consistent outputs.
+
+---
+
+## Acknowledgments & Inspirations
+
+- **my wife**
+- [HuggingFace SmoLAgents](https://github.com/huggingface/smolagents)
+- [Aider-AI](https://github.com/Aider-AI/aider)
+- And many other open-source contributors!
+
+---
+
+## Contact
+
+For questions, suggestions, or business inquiries:
+
+- **Email**: [info@alchemiststudios.ai](mailto:info@alchemiststudios.ai)
+- **X**: [@tunahorse21](https://x.com/tunahorse21)
+- **Website**: [alchemiststudios.ai](https://alchemiststudios.ai)
+
+---
+
+## License
+
+**Business Source License 1.1 (BSL)**
+This project is licensed under the Business Source License 1.1. It is **free for individuals and small businesses** (with annual revenues under $1M).
+For commercial use by larger businesses, an enterprise license is required.
+For licensing or usage inquiries, please contact: [info@alchemiststudios.ai](mailto:info@alchemiststudios.ai)