grasp_agents 0.1.9__tar.gz → 0.1.12__tar.gz

{grasp_agents-0.1.9 → grasp_agents-0.1.12}/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.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: grasp_agents
-Version: 0.1.9
+Version: 0.1.12
 Summary: Grasp Agents Library
 License-File: LICENSE
 License-File: LICENSE.md
@@ -14,7 +14,7 @@ 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" />
@@ -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
 
@@ -50,11 +50,11 @@ grasp-agents is a modular Python framework for building agentic AI pipelines and
 - `configs/` — Configuration files
 - `data/` — Logs and datasets
 
-## Quickstart & Installation Variants
+## 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.
+> **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
 
@@ -150,70 +150,6 @@ Run your script:
 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
-```
-
-If you see `ModuleNotFoundError: No module named 'yaml'`, run:
-
-```bash
-pip install pyyaml
-```
-
-#### 4. Install Grasp Agents SDK
-
-If you have a `requirements.txt`:
-
-```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
-```
-
----
-
 ## Development
 
 To develop and test the library locally, follow these steps:
@@ -256,3 +192,25 @@ You're now ready to run and experiment with the example notebook.
 - [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
+
+### Releasing: Maintainers Only
+
+To release a new version of the package, follow these steps:
+
+1. Create a new branch for the release: `git checkout -b release-X.Y.Z`.
+
+2. Update the version in `pyproject.toml`.
+
+3. Commit the changes with a message like "Bump version to X.Y.Z". `git commit -m "Bump version to X.Y.Z"`.
+
+4. Make a pull request to the `master` branch.
+
+5. Once the pull request is approved and merged, checkout the `master` branch: `git checkout master`.
+
+6. Pull the latest changes: `git pull origin master`.
+
+7. Tag the release: `git tag vX.Y.Z`. Note that a tag name should be in the format `vX.Y.Z`.
+
+8. Push the tag to the remote repository: `git push --tags`.
+
+9. This will trigger the [release workflow](.github/workflows/workflow.yml), which will build and publish the package to PyPI.

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

@@ -1,4 +1,4 @@
-# grasp_agents
+# Grasp Agents
 
 <br/>
 <img src="./.assets/grasp.svg" alt="Grasp Agents" width="320" />
@@ -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
 
@@ -34,11 +34,11 @@ grasp-agents is a modular Python framework for building agentic AI pipelines and
 - `configs/` — Configuration files
 - `data/` — Logs and datasets
 
-## Quickstart & Installation Variants
+## 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.
+> **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
 
@@ -134,70 +134,6 @@ Run your script:
 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
-```
-
-If you see `ModuleNotFoundError: No module named 'yaml'`, run:
-
-```bash
-pip install pyyaml
-```
-
-#### 4. Install Grasp Agents SDK
-
-If you have a `requirements.txt`:
-
-```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
-```
-
----
-
 ## Development
 
 To develop and test the library locally, follow these steps:
@@ -240,3 +176,25 @@ You're now ready to run and experiment with the example notebook.
 - [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
+
+### Releasing: Maintainers Only
+
+To release a new version of the package, follow these steps:
+
+1. Create a new branch for the release: `git checkout -b release-X.Y.Z`.
+
+2. Update the version in `pyproject.toml`.
+
+3. Commit the changes with a message like "Bump version to X.Y.Z". `git commit -m "Bump version to X.Y.Z"`.
+
+4. Make a pull request to the `master` branch.
+
+5. Once the pull request is approved and merged, checkout the `master` branch: `git checkout master`.
+
+6. Pull the latest changes: `git pull origin master`.
+
+7. Tag the release: `git tag vX.Y.Z`. Note that a tag name should be in the format `vX.Y.Z`.
+
+8. Push the tag to the remote repository: `git push --tags`.
+
+9. This will trigger the [release workflow](.github/workflows/workflow.yml), which will build and publish the package to PyPI.

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

@@ -1,6 +1,6 @@
 [project]
 name = "grasp_agents"
-version = "0.1.9"
+version = "0.1.12"
 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]