[Fix] PyPI dependency issues and Name change (#38)

* Fix pypi dependency issues

* Removed pyyaml version for python 3.9 support

* Updated library name

* Fixed formatting issues

* feat: rename the project from GraSP to SyGra

* Update README.md

Change SYGRA to SyGra

Co-authored-by: Vipul Mittal <118464422+vipul-mittal@users.noreply.github.com>

---------

Co-authored-by: Surajit Dasgupta <surajit.dasgupta@servicenow.com>
Co-authored-by: Vipul Mittal <118464422+vipul-mittal@users.noreply.github.com>

Author: 3 people

.github/pull_request_template.md

@@ -1,4 +1,4 @@
 Please go to the `Preview` tab and select the appropriate sub-template:
 
-* [Feature Template](https://github.com/ServiceNow/GraSP/blob/main/.github/PULL_REQUEST_TEMPLATE/feature_template.md)
-* [Issue Template](https://github.com/ServiceNow/GraSP/blob/main/.github/PULL_REQUEST_TEMPLATE/issue_template.md)
+* [Feature Template](https://github.com/ServiceNow/SyGra/blob/main/.github/PULL_REQUEST_TEMPLATE/feature_template.md)
+* [Issue Template](https://github.com/ServiceNow/SyGra/blob/main/.github/PULL_REQUEST_TEMPLATE/issue_template.md)

.github/workflows/ci.yaml

@@ -14,7 +14,7 @@ permissions:
 
 jobs:
   # Just one lightweight setup job to warm the cache
-  setup_grasp:
+  setup_sygra:
     if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
     runs-on: ubuntu-latest
     steps:
@@ -35,7 +35,7 @@ jobs:
 
   # Run Formatting
   format:
-    needs: setup_grasp
+    needs: setup_sygra
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -54,7 +54,7 @@ jobs:
       - run: make format
   # Run Linting
   lint:
-    needs: setup_grasp
+    needs: setup_sygra
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -73,7 +73,7 @@ jobs:
       - run: make lint
   # Run Tests
   test:
-    needs: setup_grasp
+    needs: setup_sygra
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -92,7 +92,7 @@ jobs:
       - run: make test
   # Build Docs
   docs_build:
-    needs: setup_grasp
+    needs: setup_sygra
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

.gitignore

@@ -8,5 +8,7 @@ logs/*
 .vscode/
 .env
 poetry.lock
-**/grasp.egg-info/*
+*.egg-info/*
 site/
+build/
+dist/

CITATION.cff

@@ -1,5 +1,5 @@
 cff-version: 1.2.0
-message: "If you use GraSP in your projects, please cite it as below."
+message: "If you use SyGra in your projects, please cite it as below."
 authors:
   - family-names: Pradhan
     given-names: Bidyapati
@@ -15,11 +15,11 @@ authors:
     given-names: Vipul
   - family-names: Gopal
     given-names: Sarda
-title: "GraSP, an open-source GRAph-oriented Synthetic data generation Pipeline"
+title: "SyGra, an open-source GRAph-oriented Synthetic data generation Pipeline"
 version: "1.0"
 date-released: "2025-09-15"
-url: "https://servicenow.github.io/grasp"
-repository-code: "https://github.com/ServiceNow/grasp"
+url: "https://servicenow.github.io/sygra"
+repository-code: "https://github.com/ServiceNow/sygra"
 license: "Apache-2.0"
 
 # identifiers:
@@ -28,7 +28,7 @@ license: "Apache-2.0"
 
 preferred-citation:
   type: article
-  title: "GraSP: An open-source GRAph-oriented Synthetic data generation Pipeline"
+  title: "SyGra: An open-source GRAph-oriented Synthetic data generation Pipeline"
   authors:
     - family-names: Pradhan
       given-names: Bidyapati

CODE_OF_CONDUCT.md

@@ -39,7 +39,7 @@ ServiceNow suggests the following technical support pathways for open-source pro
 
 **Enforcement and reporting**
 
-We encourage community members and users to help each other and to resolve issues amongst themselves as much as possible. If a matter cannot be resolved in good faith within the means available, please reach out to a team member or email grasp_team@servicenow.com.
+We encourage community members and users to help each other and to resolve issues amongst themselves as much as possible. If a matter cannot be resolved in good faith within the means available, please reach out to a team member or email sygra_team@servicenow.com.
 
 **ServiceNow Disclaimer.**
 

CONTRIBUTING.md

@@ -1,19 +1,19 @@
-# Contributing to GraSP :telescope:
+# Contributing to SyGra :telescope:
 
-Thank you for your interest in contributing to GraSP!
+Thank you for your interest in contributing to SyGra!
 
 This document should be able to guide contributors in their different types of contributions.
 
-:information_source: Just want to ask a question? Open a topic on our [Discussion page](https://github.com/ServiceNow/grasp/discussions).
+:information_source: Just want to ask a question? Open a topic on our [Discussion page](https://github.com/ServiceNow/sygra/discussions).
 
 
 ## Get your environment setup
 
-GraSP is split in two components.
+SyGra is split in two components.
 Go to our [Installation](docs/installation.md) to get installation.
 
 
-[//]: # (It is encouraged to be familiar with our [development best practices](https://servicenow.github.io/grasp/development/dev-practices/).)
+[//]: # (It is encouraged to be familiar with our [development best practices](https://servicenow.github.io/sygra/development/dev-practices/).)
 
 
 When everything is set up, you can refer to the
@@ -25,7 +25,7 @@ sections to setup a synthetic data generation pipeline.
 
 ## How to submit a bug report
 
-[Open an issue on Github](https://github.com/ServiceNow/grasp/issues/new/choose) and select "Bug report". If you are not sure whether it is a bug or not, submit an issue and we will be able to help you.
+[Open an issue on Github](https://github.com/ServiceNow/sygra/issues/new/choose) and select "Bug report". If you are not sure whether it is a bug or not, submit an issue and we will be able to help you.
 
 Issues with reproducible examples are easier to work with. Do not hesitate to provide your configuration with generated data if need be.
 
@@ -37,11 +37,11 @@ First, open an issue describing your desired changes, if it does not exist alrea
 
 You can also self-assign an existing issue by commmenting #self-assign on the issue.
 
-1. [Fork the repo to your own account](https://github.com/ServiceNow/grasp/fork).
+1. [Fork the repo to your own account](https://github.com/ServiceNow/sygra/fork).
 2. Clone your fork of the repo locally.
 3. Make your changes (the fun part).
 4. Commit and push your changes to your fork.
-5. [Open a pull-request](https://github.com/ServiceNow/grasp/compare) with your branch.
+5. [Open a pull-request](https://github.com/ServiceNow/sygra/compare) with your branch.
 6. Once a team member approves your changes, we will merge the pull request promptly.
 
 ### Guidelines for a good pull-request
@@ -50,9 +50,9 @@ When coding, pay special attention to the following:
 * Do not expose any personal/sensitive data.
 * Add unit tests when a notable functionality has been added or changed.
 
-[//]: # (* Read our [development best practices](https://servicenow.github.io/grasp/development/dev-practices/) to set up `pre-commit`, and test your changes.)
+[//]: # (* Read our [development best practices](https://servicenow.github.io/sygra/development/dev-practices/) to set up `pre-commit`, and test your changes.)
 * Do not forget to notify the team in advance that you are working on an issue (Using #self-assign or by creating an issue). Mention it if you need to add/bump a dependency.
-* Check the [PR template](https://github.com/ServiceNow/grasp/blob/main/.github/pull_request_template.md) in advance to see the checklist of things to do.
+* Check the [PR template](https://github.com/ServiceNow/sygra/blob/main/.github/pull_request_template.md) in advance to see the checklist of things to do.
 
 ### Where to ask for help!
 
@@ -71,4 +71,4 @@ If the team member can't answer your question, they will find someone who can!
 
 We would love to add you to this list!
 
-[//]: # (To reach out to the owners of this project, please see our [About page](https://servicenow.github.io/grasp/about-us/).)
+[//]: # (To reach out to the owners of this project, please see our [About page](https://servicenow.github.io/sygra/about-us/).)

Makefile

@@ -16,22 +16,22 @@ POETRY = poetry
 
 .PHONY: setup
 setup: ## Install core dependencies
-	@echo "Installing GraSP core dependencies"
+	@echo "Installing SyGra core dependencies"
 	$(POETRY) install --no-interaction --no-root --without dev,ui
 
 .PHONY: setup-all
 setup-all: ## Install core and extra dependencies
-	@echo "Installing GraSP Core and extra dependencies"
+	@echo "Installing SyGra Core and extra dependencies"
 	$(POETRY) install --no-interaction --no-root --without dev
 
 .PHONY: setup-ui
 setup-ui: ## Install development dependencies
-	@echo "Installing GraSP UI dependencies"
+	@echo "Installing SyGra UI dependencies"
 	$(POETRY) install --no-interaction --no-root --without dev
 
 .PHONY: setup-dev
 setup-dev: ## Install development dependencies
-	@echo "Installing GraSP Core, Extra and Development dependencies"
+	@echo "Installing SyGra Core, Extra and Development dependencies"
 	$(POETRY) install --no-interaction --no-root
 
 ########################################################################################################################
@@ -48,7 +48,7 @@ test-verbose: ## Run tests in verbose mode
 
 .PHONY: test-coverage
 test-coverage: ## Run tests with coverage
-	$(POETRY) run $(PYTEST) --cov=grasp --cov-report=term --cov-report=xml
+	$(POETRY) run $(PYTEST) --cov=sygra --cov-report=term --cov-report=xml
 
 ########################################################################################################################
 # DOCUMENTATION

README.md

@@ -1,13 +1,13 @@
 <div align="center">
-  <img width=30% src="https://raw.githubusercontent.com/ServiceNow/GraSP/refs/heads/main/docs/resources/images/grasp_logo.png">
+  <img width=30% src="https://raw.githubusercontent.com/ServiceNow/SyGra/refs/heads/main/docs/resources/images/sygra_logo.png">
 
-  <h1>GRASP: GRAph-oriented Synthetic data generation Pipeline</h1>
+  <h1>SyGra: GRAph-oriented Synthetic data generation Pipeline</h1>
 
-<a href="https://github.com/ServiceNow/GraSP/actions/workflows/ci.yaml">
-    <img alt="CI" src="https://github.com/ServiceNow/GraSP/actions/workflows/ci.yaml/badge.svg"/></a>
-<a href="https://github.com/ServiceNow/GraSP/releases">
-    <img alt="Releases" src="https://img.shields.io/github/v/release/ServiceNow/GraSP?logo=bookstack&logoColor=white"/></a>
-<a href="https://servicenow.github.io/GraSP">
+<a href="https://github.com/ServiceNow/SyGra/actions/workflows/ci.yaml">
+    <img alt="CI" src="https://github.com/ServiceNow/SyGra/actions/workflows/ci.yaml/badge.svg"/></a>
+<a href="https://github.com/ServiceNow/SyGra/releases">
+    <img alt="Releases" src="https://img.shields.io/github/v/release/ServiceNow/SyGra?logo=bookstack&logoColor=white"/></a>
+<a href="https://servicenow.github.io/SyGra">
     <img alt="Documentation" src="https://img.shields.io/badge/MkDocs-Documentation-green.svg"/></a>
 <a href="http://arxiv.org/abs/2508.15432">
     <img src="https://img.shields.io/badge/arXiv-2508.15432-B31B1B.svg" alt="arXiv"></a>
@@ -30,55 +30,55 @@ kinds of computational graph which can be configured.
 
 ## Introduction
 
-GraSP Framework is created to generate synthetic data. As it is a complex process to define the flow, this design simplifies the synthetic data generation process. GraSP platform will support the following:
+SyGra Framework is created to generate synthetic data. As it is a complex process to define the flow, this design simplifies the synthetic data generation process. SyGra platform will support the following:
 - Defining the seed data configuration
 - Define a task, which involves graph node configuration, flow between nodes and conditions between the node
 - Define the output location to dump the generated data
 
-Seed data can be pulled from either Huggingface or file system. Once the seed data is loaded, GraSP platform allows datagen users to write any data processing using the data transformation module. When the data is ready, users can define the data flow with various types of nodes. A node can also be a subgraph defined in another yaml file.
+Seed data can be pulled from either Huggingface or file system. Once the seed data is loaded, SyGra platform allows datagen users to write any data processing using the data transformation module. When the data is ready, users can define the data flow with various types of nodes. A node can also be a subgraph defined in another yaml file.
 
 Each node can be defined with preprocessing, post processing, and LLM prompt with model parameters. Prompts can use seed data as python template keys.  
 Edges define the flow between nodes, which can be conditional or non-conditional, with support for parallel and one-to-many flows.
 
 At the end, generated data is collected in the graph state for a specific record, processed further to generate the final dictionary to be written to the configured data sink.
 
-![GraspFramework](https://raw.githubusercontent.com/ServiceNow/GraSP/refs/heads/main/docs/resources/images/grasp_architecture.png)
+![SygraFramework](https://raw.githubusercontent.com/ServiceNow/SyGra/refs/heads/main/docs/resources/images/sygra_architecture.png)
 
 ---
 
 # Installation
 
-Pick how you want to use **GraSP**:
+Pick how you want to use **SyGra**:
 
 <div align="center">
 
-<a href="https://servicenow.github.io/GraSP/installation/">
+<a href="https://servicenow.github.io/SyGra/installation/">
   <img src="https://img.shields.io/badge/Use%20as-Framework-4F46E5?style=for-the-badge" alt="Install as Framework">
 </a>
 &nbsp;&nbsp;
-<a href="https://servicenow.github.io/GraSP/grasp_library/">
+<a href="https://servicenow.github.io/SyGra/sygra_library/">
   <img src="https://img.shields.io/badge/Use%20as-Library-10B981?style=for-the-badge" alt="Install as Library">
 </a>
 
 </div>
 
 ### Which one should I choose?
 - **Framework** → Run end-to-end pipelines from YAML graphs + CLI tooling and project scaffolding.
-  (Start here: **[`Installation`](https://servicenow.github.io/GraSP/installation/)**)
+  (Start here: **[`Installation`](https://servicenow.github.io/SyGra/installation/)**)
 
-- **Library** → Import GraSP in your own Python app/notebook; call APIs directly.
-  (Start here: **[`GraSP Library`](https://servicenow.github.io/GraSP/grasp_library/)**)
+- **Library** → Import SyGra in your own Python app/notebook; call APIs directly.
+  (Start here: **[`SyGra Library`](https://servicenow.github.io/SyGra/sygra_library/)**)
 
 
 <details>
   <summary><strong>TL;DR – Framework Setup</strong></summary>
 
-See full steps in <a href="https://servicenow.github.io/GraSP/installation/">Installation</a>.
+See full steps in <a href="https://servicenow.github.io/SyGra/installation/">Installation</a>.
 
 ```bash
-git clone git@github.com:ServiceNow/GraSP.git
+git clone git@github.com:ServiceNow/SyGra.git
 
-cd GraSP
+cd SyGra
 
 poetry run python main.py --task examples.glaive_code_assistant --num_records=1
 ```
@@ -87,52 +87,52 @@ poetry run python main.py --task examples.glaive_code_assistant --num_records=1
 <details>
   <summary><strong>TL;DR – Library Setup</strong></summary>
 
-See full steps in <a href="https://servicenow.github.io/GraSP/grasp_library/">Grasp Library</a>.
+See full steps in <a href="https://servicenow.github.io/SyGra/sygra_library/">Sygra Library</a>.
 
 ```bash
-pip install grasp   
+pip install sygra   
 ```
 
 ```python
-import grasp
+import sygra
 
-workflow = grasp.Workflow("tasks/examples/glaive_code_assistant")
+workflow = sygra.Workflow("tasks/examples/glaive_code_assistant")
 workflow.run(num_records=1)
 ```
 </details>
 
 ---
 
 ## Components
-The GraSP architecture is composed of multiple components. The following diagrams illustrate the four primary components and their associated modules.
+The SyGra architecture is composed of multiple components. The following diagrams illustrate the four primary components and their associated modules.
 
 ### Data Handler
 Data handler is used for reading and writing the data. Currently, it supports file handler with various file types and huggingface handler.
 When reading data from huggingface, it can read the whole dataset and process, or it can stream chunk of data.
 
-<kbd> ![DataHandler](https://raw.githubusercontent.com/ServiceNow/GraSP/refs/heads/main/docs/resources/images/component_data_handler.png) </kbd>
+<kbd> ![DataHandler](https://raw.githubusercontent.com/ServiceNow/SyGra/refs/heads/main/docs/resources/images/component_data_handler.png) </kbd>
 
 ### Graph Node Module
 This module is responsible for building various kind of nodes like LLM node, Multi-LLM node, Lambda node, Agent node etc.
 Each node is defined for various task, for example multi-llm node is used to load-balance the data among various inference point running same model.
 
-<kbd> ![Nodes](https://raw.githubusercontent.com/ServiceNow/GraSP/refs/heads/main/docs/resources/images/component_nodes.png) </kbd>
+<kbd> ![Nodes](https://raw.githubusercontent.com/ServiceNow/SyGra/refs/heads/main/docs/resources/images/component_nodes.png) </kbd>
 
 ### Graph Edge Connection
 Once node are built, we can connect them with simple edge or conditional edge.
 Conditional edge uses python code to decide the path. Conditional edge helps implimenting if-else flow as well as loops in the graph.
 
-<kbd> ![Edges](https://raw.githubusercontent.com/ServiceNow/GraSP/refs/heads/main/docs/resources/images/component_edges.png) </kbd>
+<kbd> ![Edges](https://raw.githubusercontent.com/ServiceNow/SyGra/refs/heads/main/docs/resources/images/component_edges.png) </kbd>
 
 ### Model clients
-GraSP doesn't support inference within the framework, but it supports various clients, which helps connecting with different kind of servers.
+SyGra doesn't support inference within the framework, but it supports various clients, which helps connecting with different kind of servers.
 For example, openai client is being supported by Huggingface TGI, vLLM server and Azure services. However, model configuration does not allow to change clients, but it can be configured in models code.
 
-<kbd> ![ModelClient](https://raw.githubusercontent.com/ServiceNow/GraSP/refs/heads/main/docs/resources/images/component_model_client.png) </kbd>
+<kbd> ![ModelClient](https://raw.githubusercontent.com/ServiceNow/SyGra/refs/heads/main/docs/resources/images/component_model_client.png) </kbd>
 
 ## Task Components
 
-GraSP supports extendability and ease of implementation—most tasks are defined as graph configuration YAML files. Each task consists of two major components: a graph configuration and Python code to define conditions and processors.
+SyGra supports extendability and ease of implementation—most tasks are defined as graph configuration YAML files. Each task consists of two major components: a graph configuration and Python code to define conditions and processors.
 YAML contains various parts:
 
 - **Data configuration** : Configure file or huggingface as source and sink for the task.
@@ -147,12 +147,12 @@ LLM-based nodes require a model configured in `models.yaml` and runtime paramete
 
 As of now, LLM inference is supported for TGI, vLLM, Azure, Azure OpenAI, Ollama and Triton compatible servers. Model deployment is external and configured in `models.yaml`.
 
-<!-- ![GraspComponents](https://raw.githubusercontent.com/ServiceNow/GraSP/refs/heads/main/docs/resources/images/grasp_usecase2framework.png) -->
+<!-- ![SygraComponents](https://raw.githubusercontent.com/ServiceNow/SyGra/refs/heads/main/docs/resources/images/sygra_usecase2framework.png) -->
 
 
 ## Contact
 
-To contact us, please send us an [email](mailto:grasp_team@servicenow.com)!
+To contact us, please send us an [email](mailto:sygra_team@servicenow.com)!
 
 ## License
 
@@ -161,4 +161,4 @@ The package is licensed by ServiceNow, Inc. under the Apache 2.0 license. See [L
 ---
 
 **Questions?**  
-Open an [issue](https://github.com/ServiceNow/GraSP/issues) or start a [discussion](https://github.com/ServiceNow/GraSP/discussions)! Contributions are welcome.
+Open an [issue](https://github.com/ServiceNow/SyGra/issues) or start a [discussion](https://github.com/ServiceNow/SyGra/discussions)! Contributions are welcome.