grasp_agents 0.1.10__py3-none-any.whl → 0.1.13__py3-none-any.whl

grasp_agents-0.1.13.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: grasp_agents
+Version: 0.1.13
+Summary: Grasp Agents Library
+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
+Description-Content-Type: text/markdown
+
+# Grasp Agents
+
+<br/>
+<img src="./.assets/grasp.svg" alt="Grasp Agents" width="320" />
+<br/>
+<br/>
+
+[![PyPI version](https://badge.fury.io/py/grasp_agents.svg)](https://badge.fury.io/py/grasp-agents)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](https://mit-license.org/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/grasp-agents?style=flat-square)](https://pypi.org/project/grasp-agents/)
+[![GitHub Stars](https://img.shields.io/github/stars/grasp-technologies/grasp-agents?style=social)](https://github.com/grasp-technologies/grasp-agents/stargazers)
+[![GitHub Forks](https://img.shields.io/github/forks/grasp-technologies/grasp-agents?style=social)](https://github.com/grasp-technologies/grasp-agents/network/members)
+
+## Overview
+
+**Grasp Agents** is a modular Python framework for building agentic AI pipelines and applications. It provides reusable agent classes, message handling, LLM integration, memory, and orchestration utilities. The framework is designed for flexibility, composability, and clarity, enabling rapid prototyping and robust development of multi-agent systems.
+
+## Features
+
+- Modular agent base classes
+- Message and memory management
+- LLM and tool orchestration
+- Logging and usage tracking
+- Extensible architecture
+
+## Project Structure
+
+- `src/grasp_agents/` — Core framework modules
+  - `base_agent.py`, `llm_agent.py`, `comm_agent.py`: Agent classes
+  - `agent_message.py`, `agent_message_pool.py`: Messaging
+  - `memory.py`: Memory management
+  - `cloud_llm.py`, `llm.py`: LLM integration
+  - `tool_orchestrator.py`: Tool orchestration
+  - `usage_tracker.py`, `grasp_logging.py`: Usage and logging
+  - `data_retrieval/`, `openai/`, `typing/`, `workflow/`: Extensions and utilities
+- `configs/` — Configuration files
+- `data/` — Logs and datasets
+
+## Quickstart & Installation Variants (UV Package manager)
+
+### 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. There are also [examples](src/grasp_agents/examples/demo/) for other package managers.
+
+#### 1. Prerequisites
+
+Install the [UV Package Manager](https://github.com/astral-sh/uv):
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+#### 2. Create Project & Install Dependencies
+
+```bash
+mkdir my-test-uv-app
+cd my-test-uv-app
+uv init .
+```
+
+Create and activate a virtual environment:
+
+```bash
+uv venv
+source .venv/bin/activate
+```
+
+Add and sync dependencies:
+
+```bash
+uv add grasp_agents
+uv sync
+```
+
+#### 3. Example Usage
+
+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.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
+
+
+chatbot = LLMAgent[Any, Response, None](
+    agent_id="chatbot",
+    llm=OpenAILLM(
+        model_name="gpt-4o",
+        llm_settings=OpenAILLMSettings(),
+    ),
+    sys_prompt=None,
+    out_schema=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
+uv run hello.py
+```

{grasp_agents-0.1.10.dist-info → grasp_agents-0.1.13.dist-info}/RECORD

@@ -38,8 +38,7 @@ grasp_agents/workflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 grasp_agents/workflow/looped_agent.py,sha256=YBOgOIvy3_NwKvEoGgzQJ2fY9SNG66MQk6obSBGWvCc,3896
 grasp_agents/workflow/sequential_agent.py,sha256=yDt2nA-b1leVByD8jsKrWD6bHe0o9z33jrOJGOLwbyk,2004
 grasp_agents/workflow/workflow_agent.py,sha256=9U94IQ39Vb1W_5u8aoqHb65ikdarEhEJkexDz8xwHD4,2294
-grasp_agents-0.1.10.dist-info/METADATA,sha256=XOMAmMxZc3EP2fKPSME19AAufaakNKdh0NGmVC8Q-cY,7411
-grasp_agents-0.1.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-grasp_agents-0.1.10.dist-info/licenses/LICENSE,sha256=GRDob7--af0SOT8BRgu7Ds1NqhunPyxGjyETcCk-o7s,1062
-grasp_agents-0.1.10.dist-info/licenses/LICENSE.md,sha256=Kfeo0gdlLS6tLQiWwO9UWhjp9-f93a5kShSiBp2FG-c,1201
-grasp_agents-0.1.10.dist-info/RECORD,,
+grasp_agents-0.1.13.dist-info/METADATA,sha256=oIAw7WeZopDvWOFIQLo-PmSsnlDtHYVtSceKI0J5GEU,4272
+grasp_agents-0.1.13.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+grasp_agents-0.1.13.dist-info/licenses/LICENSE.md,sha256=Kfeo0gdlLS6tLQiWwO9UWhjp9-f93a5kShSiBp2FG-c,1201
+grasp_agents-0.1.13.dist-info/RECORD,,

grasp_agents-0.1.10.dist-info/METADATA

@@ -1,318 +0,0 @@
-Metadata-Version: 2.4
-Name: grasp_agents
-Version: 0.1.10
-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
-Description-Content-Type: text/markdown
-
-# Grasp Agents
-
-<br/>
-<img src="./.assets/grasp.png" alt="Grasp Agents" width="320" />
-<br/>
-<br/>
-
-[![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)](https://mit-license.org/)
-
-## Overview
-
-**Grasp Agents** is a modular Python framework for building agentic AI pipelines and applications. It provides reusable agent classes, message handling, LLM integration, memory, and orchestration utilities. The framework is designed for flexibility, composability, and clarity, enabling rapid prototyping and robust development of multi-agent systems.
-
-## Features
-
-- Modular agent base classes
-- Message and memory management
-- LLM and tool orchestration
-- Logging and usage tracking
-- Extensible architecture
-
-## Project Structure
-
-- `src/grasp_agents/` — Core framework modules
-  - `base_agent.py`, `llm_agent.py`, `comm_agent.py`: Agent classes
-  - `agent_message.py`, `agent_message_pool.py`: Messaging
-  - `memory.py`: Memory management
-  - `cloud_llm.py`, `llm.py`: LLM integration
-  - `tool_orchestrator.py`: Tool orchestration
-  - `usage_tracker.py`, `grasp_logging.py`: Usage and logging
-  - `data_retrieval/`, `openai/`, `typing/`, `workflow/`: Extensions and utilities
-- `configs/` — Configuration files
-- `data/` — Logs and datasets
-
-## Quickstart & Installation Variants
-
-### 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):
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-#### 2. Create Project & Install Dependencies
-
-```bash
-mkdir my-test-uv-app
-cd my-test-uv-app
-uv init .
-```
-
-Create and activate a virtual environment:
-
-```bash
-uv venv
-source .venv/bin/activate
-```
-
-Add and sync dependencies:
-
-```bash
-uv add grasp_agents
-uv sync
-```
-
-#### 3. Example Usage
-
-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.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
-
-
-chatbot = LLMAgent[Any, Response, None](
-    agent_id="chatbot",
-    llm=OpenAILLM(
-        model_name="gpt-4o",
-        llm_settings=OpenAILLMSettings(),
-    ),
-    sys_prompt=None,
-    out_schema=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
-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
-mkdir my-test-pip-app
-cd my-test-pip-app
-```
-
-#### 2. Install Python 3.11.9 (Recommended)
-
-If using [pyenv](https://github.com/pyenv/pyenv):
-
-```bash
-brew install pyenv
-pyenv install 3.11.9
-pyenv local 3.11.9
-```
-
-Open a new terminal after setting the Python version.
-
-#### 3. Create & Activate Virtual Environment
-
-```bash
-python -m venv .venv
-source .venv/bin/activate
-```
-
-#### 4. Install Grasp Agents SDK
-
-If you have a `requirements.txt` file:
-
-```bash
-pip install -r requirements.txt
-```
-
-Or install directly:
-
-```bash
-pip install grasp-agents
-```
-
-#### 5. Example Usage
-
-Create a file, e.g., `hello.py`, and use the same code as above.
-
-#### 6. Run the App
-
-```bash
-python hello.py
-```
-
----
-
-### Option 3: Poetry-based Project
-
-> **Note:** You can check this sample project code in the [src/grasp_agents/examples/demo/poetry](src/grasp_agents/examples/demo/poetry) folder. Feel free to copy and paste the code from there to a separate project.
-
-#### 1. Create Project Folder
-
-```bash
-mkdir my-test-poetry-app
-cd my-test-poetry-app
-```
-
-#### 2. Install Python 3.11.9 via pyenv
-
-```bash
-brew install pyenv
-pyenv install 3.11.9
-pyenv local 3.11.9
-```
-
-#### 3. Install Poetry Package Manager
-
-If you don't have Poetry, install it:
-
-```bash
-curl -sSL https://install.python-poetry.org | python3 -
-```
-
-Open a new terminal after installing Poetry.
-
-#### 4. Create and Activate a Virtual Environment
-
-```bash
-python -m venv .venv
-source .venv/bin/activate
-```
-
-#### 5. Make Poetry Use the Virtual Environment's Python
-
-```bash
-poetry env use $(which python)
-```
-
-#### 6. Install the Grasp Agents SDK
-
-```bash
-poetry install
-```
-
-#### 7. Example Usage
-
-Create a file, e.g., `hello.py`, and use the same code as above.
-
-#### 8. Environment Variables
-
-Ensure you have a `.env` file with your OpenAI API key set:
-
-```
-OPENAI_API_KEY=your_openai_api_key
-```
-
-#### 9. Run the App
-
-```bash
-poetry run python hello.py
-```
-
-## Development
-
-To develop and test the library locally, follow these steps:
-
-### 1. Install UV Package Manager
-
-Make sure [UV](https://github.com/astral-sh/uv) is installed on your system:
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-### 2. Install Dependencies
-
-Create a new virtual environment and install dependencies:
-
-```bash
-uv venv
-source .venv/bin/activate
-uv sync
-```
-
-### 3. Test Example for VS Code
-
-- 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.10.dist-info/licenses/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Grasp
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE 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
-AUTHORS OR COPYRIGHT HOLDERS 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 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.