grasp_agents 0.1.7__tar.gz → 0.1.9__tar.gz

grasp_agents-0.1.9/LICENSE.md

@@ -0,0 +1,11 @@
+Grasp Agents itself is [MIT](https://mit-license.org/)-licensed.
+
+Package production dependencies are licensed under the following terms:
+
+| Name      | Version | License                                           | URL                                     |
+| --------- | ------- | ------------------------------------------------- | --------------------------------------- |
+| httpx     | 0.28.1  | BSD License                                       | https://github.com/encode/httpx         |
+| openai    | 1.77.0  | Apache Software License                           | https://github.com/openai/openai-python |
+| tenacity  | 9.1.2   | Apache Software License                           | https://github.com/jd/tenacity          |
+| termcolor | 2.5.0   | MIT License                                       | https://github.com/termcolor/termcolor  |
+| tqdm      | 4.67.1  | MIT License; Mozilla Public License 2.0 (MPL 2.0) | https://tqdm.github.io                  |

{grasp_agents-0.1.7 → grasp_agents-0.1.9}/PKG-INFO

@@ -1,11 +1,14 @@
 Metadata-Version: 2.4
 Name: grasp_agents
-Version: 0.1.7
+Version: 0.1.9
 Summary: Grasp Agents Library
 License-File: LICENSE
+License-File: LICENSE.md
 Requires-Python: <3.12,>=3.11.4
+Requires-Dist: dotenv>=0.9.9
 Requires-Dist: httpx<1,>=0.27.0
 Requires-Dist: openai<2,>=1.68.2
+Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: tenacity>=9.1.2
 Requires-Dist: termcolor<3,>=2.4.0
 Requires-Dist: tqdm<5,>=4.66.2
@@ -20,7 +23,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI version](https://badge.fury.io/py/grasp_agents.svg)](https://badge.fury.io/py/grasp_agents)
 [![Python Versions](https://img.shields.io/pypi/pyversions/grasp_agents?style=flat-square)](https://pypi.org/project/grasp_agents/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](https://mit-license.org/)
 
 ## Overview
 
@@ -51,6 +54,8 @@ grasp-agents is a modular Python framework for building agentic AI pipelines and
 
 ### Option 1: UV Package Manager Project
 
+> **Note:** You can check this sample project code in the [src/grasp_agents/examples/demo/uv](src/grasp_agents/examples/demo/uv) folder. Feel free to copy and paste the code from there to a separate project.
+
 #### 1. Prerequisites
 
 Install the [UV Package Manager](https://github.com/astral-sh/uv):
@@ -85,31 +90,72 @@ uv sync
 
 Create a file, e.g., `hello.py`:
 
+Ensure you have a `.env` file with your OpenAI and Google AI Studio API keys set
+
+```
+OPENAI_API_KEY=your_openai_api_key
+GOOGLE_AI_STUDIO_API_KEY=your_google_ai_studio_api_key
+```
+
 ```python
+import asyncio
+from typing import Any
+
 from grasp_agents.llm_agent import LLMAgent
-from grasp_agents.base_agent import BaseAgentConfig
+from grasp_agents.openai.openai_llm import (
+    OpenAILLM,
+    OpenAILLMSettings,
+)
+from grasp_agents.typing.io import (
+    AgentPayload,
+)
+from grasp_agents.run_context import RunContextWrapper
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+class Response(AgentPayload):
+    response: str
 
-agent = LLMAgent(
-    config=BaseAgentConfig(
-        model="gpt-4o-mini",
-        memory=None,  # or your memory implementation
-    )
+
+chatbot = LLMAgent[Any, Response, None](
+    agent_id="chatbot",
+    llm=OpenAILLM(
+        model_name="gpt-4o",
+        llm_settings=OpenAILLMSettings(),
+    ),
+    sys_prompt=None,
+    out_schema=Response,
 )
 
-response = agent.run("Hello, agent!")
-print(response)
+
+@chatbot.parse_output_handler
+def output_handler(conversation, ctx, **kwargs) -> Response:
+    return Response(response=conversation[-1].content)
+
+
+async def main():
+    ctx = RunContextWrapper(print_messages=True)
+    out = await chatbot.run("Hello, agent!", ctx=ctx)
+    print(out.payloads[0].response)
+
+
+asyncio.run(main())
 ```
 
 Run your script:
 
 ```bash
-python hello.py
+uv run hello.py
 ```
 
 ---
 
 ### Option 2: PIP-only (requirements.txt-based) Project
 
+> **Note:** You can check this sample project code in the [src/grasp_agents/examples/demo/pip](src/grasp_agents/examples/demo/pip) folder. Feel free to copy and paste the code from there to a separate project.
+
 #### 1. Create Project Folder
 
 ```bash
@@ -168,10 +214,6 @@ python hello.py
 
 ---
 
-## License
-
-MIT License. See [LICENSE](LICENSE) for details.
-
 ## Development
 
 To develop and test the library locally, follow these steps:
@@ -194,10 +236,23 @@ source .venv/bin/activate
 uv sync
 ```
 
-### 3. Test Example
+### 3. Test Example for VS Code
 
-- Install the Jupyter Notebook extension for VS Code.
-- Open `src/grasp_agents/examples/notebooks/agents_demo.ipynb` in VS Code.
-- Ensure you have a `.env` file with your OpenAI and Google AI Studio API keys set (see `.env.example`).
+- Install the [Jupyter Notebook extension](https://marketplace.visualstudio.com/items/?itemName=ms-toolsai.jupyter).
+
+- Ensure you have a `.env` file with your OpenAI and Google AI Studio API keys set (see [.env.example](.env.example)).
+
+```
+OPENAI_API_KEY=your_openai_api_key
+GOOGLE_AI_STUDIO_API_KEY=your_google_ai_studio_api_key
+```
+
+- Open [src/grasp_agents/examples/notebooks/agents_demo.ipynb](src/grasp_agents/examples/notebooks/agents_demo.ipynb).
 
 You're now ready to run and experiment with the example notebook.
+
+### 4. Recommended VS Code Extensions
+
+- [Ruff](https://marketplace.visualstudio.com/items/?itemName=charliermarsh.ruff) -- for formatting and code analysis
+- [Pylint](https://marketplace.visualstudio.com/items/?itemName=ms-python.pylint) -- for linting
+- [Pylance](https://marketplace.visualstudio.com/items/?itemName=ms-python.vscode-pylance) -- for type checking

{grasp_agents-0.1.7 → grasp_agents-0.1.9}/README.md

@@ -7,7 +7,7 @@
 
 [![PyPI version](https://badge.fury.io/py/grasp_agents.svg)](https://badge.fury.io/py/grasp_agents)
 [![Python Versions](https://img.shields.io/pypi/pyversions/grasp_agents?style=flat-square)](https://pypi.org/project/grasp_agents/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](https://mit-license.org/)
 
 ## Overview
 
@@ -38,6 +38,8 @@ grasp-agents is a modular Python framework for building agentic AI pipelines and
 
 ### Option 1: UV Package Manager Project
 
+> **Note:** You can check this sample project code in the [src/grasp_agents/examples/demo/uv](src/grasp_agents/examples/demo/uv) folder. Feel free to copy and paste the code from there to a separate project.
+
 #### 1. Prerequisites
 
 Install the [UV Package Manager](https://github.com/astral-sh/uv):
@@ -72,31 +74,72 @@ uv sync
 
 Create a file, e.g., `hello.py`:
 
+Ensure you have a `.env` file with your OpenAI and Google AI Studio API keys set
+
+```
+OPENAI_API_KEY=your_openai_api_key
+GOOGLE_AI_STUDIO_API_KEY=your_google_ai_studio_api_key
+```
+
 ```python
+import asyncio
+from typing import Any
+
 from grasp_agents.llm_agent import LLMAgent
-from grasp_agents.base_agent import BaseAgentConfig
+from grasp_agents.openai.openai_llm import (
+    OpenAILLM,
+    OpenAILLMSettings,
+)
+from grasp_agents.typing.io import (
+    AgentPayload,
+)
+from grasp_agents.run_context import RunContextWrapper
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+class Response(AgentPayload):
+    response: str
 
-agent = LLMAgent(
-    config=BaseAgentConfig(
-        model="gpt-4o-mini",
-        memory=None,  # or your memory implementation
-    )
+
+chatbot = LLMAgent[Any, Response, None](
+    agent_id="chatbot",
+    llm=OpenAILLM(
+        model_name="gpt-4o",
+        llm_settings=OpenAILLMSettings(),
+    ),
+    sys_prompt=None,
+    out_schema=Response,
 )
 
-response = agent.run("Hello, agent!")
-print(response)
+
+@chatbot.parse_output_handler
+def output_handler(conversation, ctx, **kwargs) -> Response:
+    return Response(response=conversation[-1].content)
+
+
+async def main():
+    ctx = RunContextWrapper(print_messages=True)
+    out = await chatbot.run("Hello, agent!", ctx=ctx)
+    print(out.payloads[0].response)
+
+
+asyncio.run(main())
 ```
 
 Run your script:
 
 ```bash
-python hello.py
+uv run hello.py
 ```
 
 ---
 
 ### Option 2: PIP-only (requirements.txt-based) Project
 
+> **Note:** You can check this sample project code in the [src/grasp_agents/examples/demo/pip](src/grasp_agents/examples/demo/pip) folder. Feel free to copy and paste the code from there to a separate project.
+
 #### 1. Create Project Folder
 
 ```bash
@@ -155,10 +198,6 @@ python hello.py
 
 ---
 
-## License
-
-MIT License. See [LICENSE](LICENSE) for details.
-
 ## Development
 
 To develop and test the library locally, follow these steps:
@@ -181,10 +220,23 @@ source .venv/bin/activate
 uv sync
 ```
 
-### 3. Test Example
+### 3. Test Example for VS Code
 
-- Install the Jupyter Notebook extension for VS Code.
-- Open `src/grasp_agents/examples/notebooks/agents_demo.ipynb` in VS Code.
-- Ensure you have a `.env` file with your OpenAI and Google AI Studio API keys set (see `.env.example`).
+- Install the [Jupyter Notebook extension](https://marketplace.visualstudio.com/items/?itemName=ms-toolsai.jupyter).
+
+- Ensure you have a `.env` file with your OpenAI and Google AI Studio API keys set (see [.env.example](.env.example)).
+
+```
+OPENAI_API_KEY=your_openai_api_key
+GOOGLE_AI_STUDIO_API_KEY=your_google_ai_studio_api_key
+```
+
+- Open [src/grasp_agents/examples/notebooks/agents_demo.ipynb](src/grasp_agents/examples/notebooks/agents_demo.ipynb).
 
 You're now ready to run and experiment with the example notebook.
+
+### 4. Recommended VS Code Extensions
+
+- [Ruff](https://marketplace.visualstudio.com/items/?itemName=charliermarsh.ruff) -- for formatting and code analysis
+- [Pylint](https://marketplace.visualstudio.com/items/?itemName=ms-python.pylint) -- for linting
+- [Pylance](https://marketplace.visualstudio.com/items/?itemName=ms-python.vscode-pylance) -- for type checking

{grasp_agents-0.1.7 → grasp_agents-0.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "grasp_agents"
-version = "0.1.7"
+version = "0.1.9"
 description = "Grasp Agents Library"
 readme = "README.md"
 requires-python = ">=3.11.4,<3.12"
@@ -10,6 +10,8 @@ dependencies = [
     "tenacity>=9.1.2",
     "termcolor>=2.4.0,<3",
     "tqdm>=4.66.2,<5",
+    "dotenv>=0.9.9",
+    "pyyaml>=6.0.2",
 ]
 
 [dependency-groups]