grasp_agents 0.1.9__tar.gz → 0.1.10__tar.gz

{grasp_agents-0.1.9 → grasp_agents-0.1.10}/LICENSE.md

@@ -4,6 +4,8 @@ Package production dependencies are licensed under the following terms:
 
 | Name      | Version | License                                           | URL                                     |
 | --------- | ------- | ------------------------------------------------- | --------------------------------------- |
+| PyYAML    | 6.0.2   | MIT License                                       | https://pyyaml.org/                     |
+| dotenv    | 0.9.9   | BSD-3-Clause license                              | https://github.com/pedroburon/dotenv    |
 | 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          |

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: grasp_agents
-Version: 0.1.9
+Version: 0.1.10
 Summary: Grasp Agents Library
 License-File: LICENSE
 License-File: LICENSE.md
@@ -14,10 +14,10 @@ Requires-Dist: termcolor<3,>=2.4.0
 Requires-Dist: tqdm<5,>=4.66.2
 Description-Content-Type: text/markdown
 
-# grasp_agents
+# Grasp Agents
 
 <br/>
-<img src="./.assets/grasp.svg" alt="Grasp Agents" width="320" />
+<img src="./.assets/grasp.png" alt="Grasp Agents" width="320" />
 <br/>
 <br/>
 
@@ -27,7 +27,7 @@ Description-Content-Type: text/markdown
 
 ## 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.
+**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
 
@@ -182,15 +182,9 @@ python -m venv .venv
 source .venv/bin/activate
 ```
 
-If you see `ModuleNotFoundError: No module named 'yaml'`, run:
-
-```bash
-pip install pyyaml
-```
-
 #### 4. Install Grasp Agents SDK
 
-If you have a `requirements.txt`:
+If you have a `requirements.txt` file:
 
 ```bash
 pip install -r requirements.txt
@@ -214,6 +208,72 @@ 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:

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

@@ -1,7 +1,7 @@
-# grasp_agents
+# Grasp Agents
 
 <br/>
-<img src="./.assets/grasp.svg" alt="Grasp Agents" width="320" />
+<img src="./.assets/grasp.png" alt="Grasp Agents" width="320" />
 <br/>
 <br/>
 
@@ -11,7 +11,7 @@
 
 ## 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.
+**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
 
@@ -166,15 +166,9 @@ python -m venv .venv
 source .venv/bin/activate
 ```
 
-If you see `ModuleNotFoundError: No module named 'yaml'`, run:
-
-```bash
-pip install pyyaml
-```
-
 #### 4. Install Grasp Agents SDK
 
-If you have a `requirements.txt`:
+If you have a `requirements.txt` file:
 
 ```bash
 pip install -r requirements.txt
@@ -198,6 +192,72 @@ 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:

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

@@ -1,6 +1,6 @@
 [project]
 name = "grasp_agents"
-version = "0.1.9"
+version = "0.1.10"
 description = "Grasp Agents Library"
 readme = "README.md"
 requires-python = ">=3.11.4,<3.12"
@@ -27,6 +27,7 @@ dev = [
     "twine>=5.1.1,<6",
     "ruff>=0.11.8",
     "pyright>=1.1.400",
+    "pip-licenses>=5.0.0",
 ]
 
 [build-system]