qumat 0.0.1__tar.gz → 0.5.0rc1__tar.gz

qumat-0.5.0rc1/.asf.yaml

@@ -0,0 +1,36 @@
+
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features
+
+publish:
+  whoami:    asf-site
+
+notifications:
+  discussions: issues@mahout.apache.org
+
+github:
+  features:
+    # Enable wiki for documentation
+    wiki: true
+    # Enable issue management
+    issues: true
+    # Enable projects for project management boards
+    projects: true
+    # Enable discussions
+    discussions: true

qumat-0.5.0rc1/.claude/settings.local.json

@@ -0,0 +1,108 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(rustc:*)",
+      "Bash(cargo --version:*)",
+      "Bash(nvcc:*)",
+      "Bash(source ~/.zshrc)",
+      "Bash(export PATH=\"$HOME/.cargo/bin:$PATH\")",
+      "Bash(export CUDA_HOME=\"$HOME/local/cuda-12.2\")",
+      "Bash(export PATH=\"$CUDA_HOME/bin:$PATH\")",
+      "Bash(export LD_LIBRARY_PATH:*)",
+      "Bash(cargo build:*)",
+      "Bash(cargo test:*)",
+      "Bash(cargo doc:*)",
+      "Bash(gh api:*)",
+      "Bash(gh pr diff:*)",
+      "Bash(source .venv/bin/activate)",
+      "Bash(uv sync:*)",
+      "Bash(python:*)",
+      "Bash(nvidia-smi:*)",
+      "Bash(uv run maturin develop:*)",
+      "Bash(git fetch:*)",
+      "Bash(git checkout:*)",
+      "Bash(git pull:*)",
+      "Bash(git stash:*)",
+      "Bash(git reset:*)",
+      "Bash(git branch:*)",
+      "Bash(source:*)",
+      "Bash(cargo clippy:*)",
+      "Bash(cat:*)",
+      "Bash(pre-commit run:*)",
+      "Bash(uv run pre-commit run:*)",
+      "Bash(pip show:*)",
+      "Bash(uv pip show:*)",
+      "Bash(uv pip install:*)",
+      "Bash(pre-commit --version:*)",
+      "Bash(uv run pytest:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:docs.astral.sh)",
+      "WebSearch",
+      "Bash(uvx ty check:*)",
+      "Bash(grep:*)",
+      "Bash(python3:*)",
+      "Bash(maturin develop:*)",
+      "Bash(.venv/bin/python:*)",
+      "Bash(PYTHONPATH=/home/gmchiu/Documents/GitHub/mahout /home/gmchiu/Documents/GitHub/mahout/qdp/qdp-python/.venv/bin/python:*)",
+      "Bash(PYTHONPATH=/home/gmchiu/Documents/GitHub/mahout .venv/bin/pytest:*)",
+      "Bash(.venv/bin/pytest tests/ -v)",
+      "Bash(git add:*)",
+      "Bash(git commit --amend -m \"$\\(cat <<''EOF''\nIntegrate Quantum Data Plane \\(QDP\\) into QuMat\n\n- Add qumat/qdp.py as public API for `import qumat.qdp as qdp`\n- Rename native module from mahout_qdp to _qdp\n- Rename package from qdp-python to qumat-qdp\n- Update all imports in tests/benchmarks/docs\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git commit --amend -m \"$\\(cat <<''EOF''\nIntegrate Quantum Data Plane \\(QDP\\) into QuMat\n\n- Add qumat/qdp.py as public API for `import qumat.qdp as qdp`\n- Rename native module from mahout_qdp to _qdp\n- Rename package from qdp-python to qumat-qdp\n- Add qumat-qdp as optional dependency: `uv sync --group qdp`\n- Update all imports in tests/benchmarks/docs\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git commit:*)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(gh pr view:*)",
+      "Bash(cargo check:*)",
+      "Bash(uv run python:*)",
+      "Bash(bundle install:*)",
+      "Bash(bundle exec jekyll serve:*)",
+      "Bash(pytest:*)",
+      "Bash(find:*)",
+      "Bash(git push:*)",
+      "Bash(git -C /home/gmchiu/Documents/GitHub/mahout log --all --oneline --grep=basis)",
+      "Bash(git -C /home/gmchiu/Documents/GitHub/mahout show 63ef825bc --stat)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/qdp/qdp-python/.venv/bin/maturin develop)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/.venv/bin/maturin develop:*)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/qdp/qdp-python/.venv/bin/maturin develop:*)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/qdp/qdp-python/.venv/bin/maturin build --release)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/.venv/bin/python -m pytest:*)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/.venv/bin/python:*)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/qdp/qdp-python/.venv/bin/python -m pytest:*)",
+      "Bash(VIRTUAL_ENV=/home/gmchiu/Documents/GitHub/mahout/.venv PATH=/home/gmchiu/Documents/GitHub/mahout/.venv/bin:$PATH /home/gmchiu/Documents/GitHub/mahout/qdp/qdp-python/.venv/bin/maturin develop:*)",
+      "Bash(export PATH=/home/gmchiu/.cargo/bin:$PATH)",
+      "Bash(/home/gmchiu/Documents/GitHub/mahout/.venv/bin/maturin:*)",
+      "Bash(.venv/bin/maturin develop:*)",
+      "Bash(uv --version:*)",
+      "Bash(make install_benchmark:*)",
+      "Bash(~/.bashrc)",
+      "Bash(export LIBTORCH_USE_PYTORCH=1)",
+      "Bash(LIBTORCH_USE_PYTORCH=1 cargo clippy:*)",
+      "Bash(~/.profile)",
+      "Bash(LIBTORCH_USE_PYTORCH=1 pre-commit run:*)",
+      "Bash(pre-commit clean:*)",
+      "Bash(uv run:*)",
+      "Bash(pip install:*)",
+      "Bash(pip uninstall:*)",
+      "Bash(.venv/bin/pre-commit run:*)",
+      "Bash(LIBTORCH_USE_PYTORCH=1 .venv/bin/pre-commit run clippy:*)",
+      "Bash(LIBTORCH_USE_PYTORCH=1 LIBTORCH_BYPASS_VERSION_CHECK=1 .venv/bin/pre-commit run clippy:*)",
+      "Bash(pre-commit install:*)",
+      "Bash(LIBTORCH=/home/gmchiu/Documents/GitHub/mahout/.venv/lib/python3.11/site-packages/torch LD_LIBRARY_PATH=/home/gmchiu/Documents/GitHub/mahout/.venv/lib/python3.11/site-packages/torch/lib:$LD_LIBRARY_PATH uv run:*)",
+      "Bash(echo:*)",
+      "Bash(chmod:*)",
+      "Bash(cargo clean:*)",
+      "Bash(LIBTORCH=/home/gmchiu/Documents/GitHub/mahout/.venv/lib/python3.11/site-packages/torch LD_LIBRARY_PATH=/home/gmchiu/Documents/GitHub/mahout/.venv/lib/python3.11/site-packages/torch/lib cargo build:*)",
+      "Bash(LIBTORCH=/home/gmchiu/Documents/GitHub/mahout/.venv/lib/python3.11/site-packages/torch LD_LIBRARY_PATH=/home/gmchiu/Documents/GitHub/mahout/.venv/lib/python3.11/site-packages/torch/lib uv run pre-commit run:*)",
+      "Bash(uv python list:*)",
+      "Bash(uv pip list:*)",
+      "Bash(gh pr checks:*)",
+      "Bash(make install:*)",
+      "Bash(ls:*)",
+      "WebFetch(domain:pre-commit.com)",
+      "WebFetch(domain:pypi.org)",
+      "Bash(uv build:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

qumat-0.5.0rc1/.devcontainer/devcontainer.json

@@ -0,0 +1,29 @@
+{
+    "name": "CUDA Python + Rust Dev",
+    "image": "nvidia/cuda:12.4.1-devel-ubuntu22.04",
+    // Give container full GPU access
+    "runArgs": [
+        "--gpus",
+        "all"
+    ],
+    // Auto mount your GitHub repo as workspace
+    "workspaceFolder": "/workspace",
+    "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind",
+    // Install Python via devcontainers-features
+    "features": {
+        "ghcr.io/devcontainers/features/python:1": {
+            "version": "3.10"
+        }
+    },
+    // Additional setup (Rust, CUDA tools, etc.)
+    "postCreateCommand": "bash /workspace/.devcontainer/setup.sh",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-python.python",
+                "tamasfe.even-better-toml",
+                "rust-lang.rust-analyzer"
+            ]
+        }
+    }
+}

qumat-0.5.0rc1/.devcontainer/setup.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -eux
+
+# Install Rust + Cargo
+if ! command -v cargo >/dev/null 2>&1; then
+    curl https://sh.rustup.rs -sSf | sh -s -- -y
+    echo 'source $HOME/.cargo/env' >> ~/.bashrc
+fi
+
+# Common dev tools
+apt-get update
+apt-get install -y \
+    build-essential \
+    pkg-config \
+    git \
+    vim
+
+
+# uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+source $HOME/.local/bin/env
+
+# setup pre-commit hooks
+cd /workspaces/mahout
+uv sync --group dev
+uv run pre-commit install

qumat-0.5.0rc1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: "Bug Report"
+about: "Report a bug to help us improve"
+title: "[Bug] "
+labels: ["bug"]
+assignees: []
+---
+
+### Description
+A clear and concise description of the bug.
+
+### Steps to Reproduce
+1. Step 1
+2. Step 2
+3. Step 3
+
+### Expected Behavior
+What should have happened?
+
+### Actual Behavior
+What actually happened?
+
+### Screenshots or Logs
+Add screenshots or log output if applicable.
+
+### Environment
+- **OS:** e.g., Windows, Linux
+- **Browser/Tool Version:** e.g., Chrome 96, Python 3.8
+
+### Additional Context
+Any other information that may be helpful.

qumat-0.5.0rc1/.github/ISSUE_TEMPLATE/documentation_issue.md

@@ -0,0 +1,19 @@
+---
+name: "Documentation Issue"
+about: "Report issues related to documentation"
+title: "[Docs] "
+labels: ["docs"]
+assignees: []
+---
+
+### Description
+What is unclear, incorrect, or missing?
+
+### Location of the Issue
+Provide links or file paths where the issue exists.
+
+### Suggested Improvement
+How should this be fixed?
+
+### Additional Context
+Anything else that would help improve the documentation.

qumat-0.5.0rc1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: "Feature Request"
+about: "Suggest a new feature"
+title: "[Feature] "
+labels: ["enhancement"]
+assignees: []
+---
+
+### Summary
+A brief description of the feature.
+
+### Use Case
+Explain why this feature is useful.
+
+### Proposed Implementation
+How do you propose implementing this feature?
+
+### Alternatives Considered
+Have you thought of other ways to solve the same problem?
+
+### Additional Context
+Any other relevant information or resources.

qumat-0.5.0rc1/.github/ISSUE_TEMPLATE/issue_template.md

@@ -0,0 +1,32 @@
+## Issue Title
+Provide a clear and concise title for the issue
+
+### Description
+Describe the issue in detail. Include what the current behavior is and provide any relevant examples or screenshots.
+
+### Steps to Reproduce
+1. First step
+2. Second step
+3. Third step
+
+### Expected Behavior
+What do you expect to happen?
+
+### Actual Behavior
+What actually happens? Include any error messages or logs if applicable.
+
+### Environment
+- **OS:** e.g. Windows, MacOS, Linux
+- **Browser:** e.g. Chrome, Firefox, Safari
+- **Version:** e.g. 1.0.0
+
+### Suggested Fix
+If you have an idea for a fix, please provide details here.
+
+### Additional Context
+Add any other context about the problem here. For example, links to related issues or discussions.
+
+### Checklist
+- [ ] I have searched the existing issues for duplicates.
+- [ ] I have provided the information as detailed as possible.
+- [ ] I provided relevant screenshots or files if necessary.

qumat-0.5.0rc1/.github/PULL_REQUEST_TEMPLATE

@@ -0,0 +1,33 @@
+### Purpose of PR
+<!-- Describe what this PR does. -->
+
+### Related Issues or PRs
+<!-- Add links to related issues or PRs. -->
+<!-- - Closes #123  -->
+<!-- - Related to #123   -->
+
+### Changes Made
+<!-- Please mark one with an "x"   -->
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactoring
+- [ ] Documentation
+- [ ] Test
+- [ ] CI/CD pipeline
+- [ ] Other
+
+### Breaking Changes
+<!-- Does this PR introduce a breaking change? -->
+- [ ] Yes
+- [ ] No
+
+### Checklist
+<!-- Please mark each item with an "x" when complete -->
+<!-- If not all items are complete, please open this as a **Draft PR**.
+Once all requirements are met, mark as ready for review. -->
+
+- [ ] Added or updated unit tests for all changes
+- [ ] Added or updated documentation for all changes
+- [ ] Successfully built and ran all unit tests or manual tests locally
+- [ ] PR title follows "MAHOUT-XXX: Brief Description" format (if related to an issue)
+- [ ] Code follows ASF guidelines

qumat-0.5.0rc1/.github/labeler.yml

@@ -0,0 +1,13 @@
+# Label configuration for GitHub Actions labeler
+
+bug:
+  - '/(bug|error|fix|not working|broken)/i'
+
+enhancement:
+  - '/(feature|enhancement|improvement|add|new)/i'
+
+docs:
+  - '/(doc|readme|guide|tutorial)/i'
+
+question:
+  - '/(question|help|how to|\?)/i'

qumat-0.5.0rc1/.github/scripts/checks/__init__.py

@@ -0,0 +1,16 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#

qumat-0.5.0rc1/.github/scripts/checks/general_review.py

@@ -0,0 +1,124 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import ast
+
+
+class GeneralReviewCheck:
+    def __init__(self, client, model_name):
+        self.client = client
+        self.model_name = model_name
+
+    def process_pr_file(self, file, repo, pr):
+        comments = []
+        analyzed = False
+
+        if file.filename.endswith(".py"):
+            analyzed = True
+            content = repo.get_contents(
+                file.filename, ref=pr.head.sha
+            ).decoded_content.decode()
+
+            # Basic code analysis
+            try:
+                tree = ast.parse(content)
+                analysis = self.analyze_code_structure(tree)
+                if analysis:
+                    comments.append(
+                        {"path": file.filename, "body": analysis, "line": 1}
+                    )
+            except SyntaxError as e:
+                comments.append(
+                    {
+                        "path": file.filename,
+                        "body": f"⚠️ Syntax error found:\n{e}",
+                        "line": 1,
+                    }
+                )
+
+        return comments, analyzed
+
+    def analyze_code_structure(self, tree):
+        analysis = []
+
+        # Check for large classes
+        for node in ast.walk(tree):
+            if isinstance(node, ast.ClassDef):
+                methods = [n for n in node.body if isinstance(n, ast.FunctionDef)]
+                if len(methods) > 10:
+                    analysis.append(
+                        f"- Class '{node.name}' has {len(methods)} methods. Consider splitting into smaller classes."
+                    )
+
+                    # Check for long functions
+        for node in ast.walk(tree):
+            if isinstance(node, ast.FunctionDef):
+                lines = node.end_lineno - node.lineno if node.end_lineno else 0
+                if lines > 50:
+                    analysis.append(
+                        f"- Function '{node.name}' is {lines} lines long. Consider breaking it into smaller functions."
+                    )
+
+                    # Check for TODO comments
+        for node in ast.walk(tree):
+            if isinstance(node, ast.Expr) and isinstance(node.value, ast.Constant):
+                if (
+                    isinstance(node.value.value, str)
+                    and "TODO" in node.value.value.upper()
+                ):
+                    analysis.append(f"- TODO comment found: {node.value.value}")
+
+        if analysis:
+            return "🔍 Code structure analysis:\n" + "\n".join(analysis)
+        return None
+
+    def generate_general_impression(self, pr):
+        prompt = f"""Provide a general impression of this pull request. Consider:
+- Overall code quality
+- Code organization
+- Documentation
+- Potential improvements
+- Areas that need special attention
+
+Pull Request Details:
+Title: {pr.title}
+Description: {pr.body}
+Files Changed: {pr.changed_files}
+Additions: {pr.additions}
+Deletions: {pr.deletions}
+
+Provide your analysis in markdown format with these sections:
+1. Overall Impression
+2. Strengths
+3. Areas for Improvement
+4. Special Attention Needed"""
+
+        response = self.client.chat.completions.create(
+            model=self.model_name,
+            messages=[
+                {
+                    "role": "system",
+                    "content": "You are an experienced code reviewer. Provide a high-level analysis of pull requests.",
+                },
+                {"role": "user", "content": prompt},
+            ],
+        )
+
+        return response.choices[0].message.content
+
+    def process_pr(self, pr):
+        general_analysis = self.generate_general_impression(pr)
+        return [{"path": "GENERAL", "body": general_analysis, "line": 0}], True

qumat-0.5.0rc1/.github/scripts/review_pr.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import os
+import sys
+from github import Github
+from gofannon.github.pr_review_tool import PRReviewTool
+
+
+def check_env_vars():
+    required_vars = [
+        "GITHUB_TOKEN",
+        "OPENAI_API_KEY",
+        "OPENAI_BASE_URL",
+        "OPENAI_MODEL_NAME",
+        "PR_NUMBER",
+        "REPO_NAME",
+    ]
+    for var in required_vars:
+        if not os.environ.get(var):
+            sys.exit(f"Error: Required environment variable '{var}' is missing.")
+
+
+check_env_vars()
+
+
+def main():
+    pr_number = int(os.environ["PR_NUMBER"])
+    repo_name = os.environ["REPO_NAME"]
+    pr_review_tool = PRReviewTool()
+    review_summary = pr_review_tool.fn(pr_number=pr_number, repo_name=repo_name)
+
+    # Post the review comment to the pull request using PyGithub.
+    g = Github(os.environ["GITHUB_TOKEN"])
+    repo = g.get_repo(repo_name)
+    pr = repo.get_pull(pr_number)
+    pr.create_issue_comment(review_summary)
+
+
+if __name__ == "__main__":
+    main()

qumat-0.5.0rc1/.github/workflows/label.yml

@@ -0,0 +1,15 @@
+name: "Issue Labeler"
+on:
+  issues:
+    types: [opened, edited]
+
+jobs:
+  triage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: github/issue-labeler@v3.4
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"
+          configuration-path: .github/labeler.yml
+          enable-versioned-regex: 0
+          include-title: 1

qumat-0.5.0rc1/.github/workflows/notebook-testing.yml

@@ -0,0 +1,44 @@
+name: CI for Jupyter Notebooks
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "**.py"
+      - "**.ipynb"
+      - "pyproject.toml"
+      - ".github/workflows/notebook-testing.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "**.py"
+      - "**.ipynb"
+      - "pyproject.toml"
+      - ".github/workflows/notebook-testing.yml"
+  workflow_dispatch:
+
+jobs:
+  test-notebooks:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python with uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: |
+          uv venv
+          uv pip install nbclient ipykernel -e .
+
+      - name: Run Jupyter Notebooks
+        run: |
+          for nb in $(find . -name '*.ipynb'); do
+            echo "Executing $nb"
+            uv run jupyter execute "$nb" --inplace
+          done

qumat-0.5.0rc1/.github/workflows/pr_review.yml

@@ -0,0 +1,47 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+name: PR Tool Review
+on:
+  pull_request_target:
+    types: [labeled]
+
+jobs:
+  review:
+    if: github.event.label.name == 'run-tests'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out base repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.10'
+      - name: Install Gofannon
+        run: |
+          pip install gofannon
+      - name: Run PR Review Tool
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          OPENAI_BASE_URL: "https://api.deepinfra.com/v1/openai"
+          OPENAI_MODEL_NAME: "meta-llama/Llama-3.3-70B-Instruct-Turbo"
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          REPO_NAME: ${{ github.repository }}
+        run: |
+          python .github/scripts/review_pr.py