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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: grasp_agents
3
- Version: 0.1.10
3
+ Version: 0.1.12
4
4
  Summary: Grasp Agents Library
5
5
  License-File: LICENSE
6
6
  License-File: LICENSE.md
@@ -17,7 +17,7 @@ Description-Content-Type: text/markdown
17
17
  # Grasp Agents
18
18
 
19
19
  <br/>
20
- <img src="./.assets/grasp.png" alt="Grasp Agents" width="320" />
20
+ <img src="./.assets/grasp.svg" alt="Grasp Agents" width="320" />
21
21
  <br/>
22
22
  <br/>
23
23
 
@@ -50,11 +50,11 @@ Description-Content-Type: text/markdown
50
50
  - `configs/` — Configuration files
51
51
  - `data/` — Logs and datasets
52
52
 
53
- ## Quickstart & Installation Variants
53
+ ## Quickstart & Installation Variants (UV Package manager)
54
54
 
55
55
  ### Option 1: UV Package Manager Project
56
56
 
57
- > **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.
57
+ > **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.
58
58
 
59
59
  #### 1. Prerequisites
60
60
 
@@ -150,130 +150,6 @@ Run your script:
150
150
  uv run hello.py
151
151
  ```
152
152
 
153
- ---
154
-
155
- ### Option 2: PIP-only (requirements.txt-based) Project
156
-
157
- > **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.
158
-
159
- #### 1. Create Project Folder
160
-
161
- ```bash
162
- mkdir my-test-pip-app
163
- cd my-test-pip-app
164
- ```
165
-
166
- #### 2. Install Python 3.11.9 (Recommended)
167
-
168
- If using [pyenv](https://github.com/pyenv/pyenv):
169
-
170
- ```bash
171
- brew install pyenv
172
- pyenv install 3.11.9
173
- pyenv local 3.11.9
174
- ```
175
-
176
- Open a new terminal after setting the Python version.
177
-
178
- #### 3. Create & Activate Virtual Environment
179
-
180
- ```bash
181
- python -m venv .venv
182
- source .venv/bin/activate
183
- ```
184
-
185
- #### 4. Install Grasp Agents SDK
186
-
187
- If you have a `requirements.txt` file:
188
-
189
- ```bash
190
- pip install -r requirements.txt
191
- ```
192
-
193
- Or install directly:
194
-
195
- ```bash
196
- pip install grasp-agents
197
- ```
198
-
199
- #### 5. Example Usage
200
-
201
- Create a file, e.g., `hello.py`, and use the same code as above.
202
-
203
- #### 6. Run the App
204
-
205
- ```bash
206
- python hello.py
207
- ```
208
-
209
- ---
210
-
211
- ### Option 3: Poetry-based Project
212
-
213
- > **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.
214
-
215
- #### 1. Create Project Folder
216
-
217
- ```bash
218
- mkdir my-test-poetry-app
219
- cd my-test-poetry-app
220
- ```
221
-
222
- #### 2. Install Python 3.11.9 via pyenv
223
-
224
- ```bash
225
- brew install pyenv
226
- pyenv install 3.11.9
227
- pyenv local 3.11.9
228
- ```
229
-
230
- #### 3. Install Poetry Package Manager
231
-
232
- If you don't have Poetry, install it:
233
-
234
- ```bash
235
- curl -sSL https://install.python-poetry.org | python3 -
236
- ```
237
-
238
- Open a new terminal after installing Poetry.
239
-
240
- #### 4. Create and Activate a Virtual Environment
241
-
242
- ```bash
243
- python -m venv .venv
244
- source .venv/bin/activate
245
- ```
246
-
247
- #### 5. Make Poetry Use the Virtual Environment's Python
248
-
249
- ```bash
250
- poetry env use $(which python)
251
- ```
252
-
253
- #### 6. Install the Grasp Agents SDK
254
-
255
- ```bash
256
- poetry install
257
- ```
258
-
259
- #### 7. Example Usage
260
-
261
- Create a file, e.g., `hello.py`, and use the same code as above.
262
-
263
- #### 8. Environment Variables
264
-
265
- Ensure you have a `.env` file with your OpenAI API key set:
266
-
267
- ```
268
- OPENAI_API_KEY=your_openai_api_key
269
- ```
270
-
271
- #### 9. Run the App
272
-
273
- ```bash
274
- poetry run python hello.py
275
- ```
276
-
277
153
  ## Development
278
154
 
279
155
  To develop and test the library locally, follow these steps:
@@ -316,3 +192,25 @@ You're now ready to run and experiment with the example notebook.
316
192
  - [Ruff](https://marketplace.visualstudio.com/items/?itemName=charliermarsh.ruff) -- for formatting and code analysis
317
193
  - [Pylint](https://marketplace.visualstudio.com/items/?itemName=ms-python.pylint) -- for linting
318
194
  - [Pylance](https://marketplace.visualstudio.com/items/?itemName=ms-python.vscode-pylance) -- for type checking
195
+
196
+ ### Releasing: Maintainers Only
197
+
198
+ To release a new version of the package, follow these steps:
199
+
200
+ 1. Create a new branch for the release: `git checkout -b release-X.Y.Z`.
201
+
202
+ 2. Update the version in `pyproject.toml`.
203
+
204
+ 3. Commit the changes with a message like "Bump version to X.Y.Z". `git commit -m "Bump version to X.Y.Z"`.
205
+
206
+ 4. Make a pull request to the `master` branch.
207
+
208
+ 5. Once the pull request is approved and merged, checkout the `master` branch: `git checkout master`.
209
+
210
+ 6. Pull the latest changes: `git pull origin master`.
211
+
212
+ 7. Tag the release: `git tag vX.Y.Z`. Note that a tag name should be in the format `vX.Y.Z`.
213
+
214
+ 8. Push the tag to the remote repository: `git push --tags`.
215
+
216
+ 9. This will trigger the [release workflow](.github/workflows/workflow.yml), which will build and publish the package to PyPI.
@@ -38,8 +38,8 @@ grasp_agents/workflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
38
38
  grasp_agents/workflow/looped_agent.py,sha256=YBOgOIvy3_NwKvEoGgzQJ2fY9SNG66MQk6obSBGWvCc,3896
39
39
  grasp_agents/workflow/sequential_agent.py,sha256=yDt2nA-b1leVByD8jsKrWD6bHe0o9z33jrOJGOLwbyk,2004
40
40
  grasp_agents/workflow/workflow_agent.py,sha256=9U94IQ39Vb1W_5u8aoqHb65ikdarEhEJkexDz8xwHD4,2294
41
- grasp_agents-0.1.10.dist-info/METADATA,sha256=XOMAmMxZc3EP2fKPSME19AAufaakNKdh0NGmVC8Q-cY,7411
42
- grasp_agents-0.1.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
43
- grasp_agents-0.1.10.dist-info/licenses/LICENSE,sha256=GRDob7--af0SOT8BRgu7Ds1NqhunPyxGjyETcCk-o7s,1062
44
- grasp_agents-0.1.10.dist-info/licenses/LICENSE.md,sha256=Kfeo0gdlLS6tLQiWwO9UWhjp9-f93a5kShSiBp2FG-c,1201
45
- grasp_agents-0.1.10.dist-info/RECORD,,
41
+ grasp_agents-0.1.12.dist-info/METADATA,sha256=93QgmIVstmYfBgGI1WH4zgmEX4Gwd85yucmXPKn-l5c,6104
42
+ grasp_agents-0.1.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
43
+ grasp_agents-0.1.12.dist-info/licenses/LICENSE,sha256=GRDob7--af0SOT8BRgu7Ds1NqhunPyxGjyETcCk-o7s,1062
44
+ grasp_agents-0.1.12.dist-info/licenses/LICENSE.md,sha256=Kfeo0gdlLS6tLQiWwO9UWhjp9-f93a5kShSiBp2FG-c,1201
45
+ grasp_agents-0.1.12.dist-info/RECORD,,