.editorconfig

@@ -15,9 +15,11 @@ quote_type = single
 
 [*.py]
 indent_size = 4
+max_line_length = 120
 indent_style = space
 quote_type = single
 
 [{Makefile,go.mod,go.sum,*.go,.gitmodules}]
 indent_size = 4
 indent_style = tab
+max_line_length = 120

.github/workflows/engdoc.yml

@@ -17,10 +17,6 @@
 name: Eng Documentation Checks
 
 on:
-  push:
-    paths:
-      - "py/docs/**"
-      - ".github/workflows/engdoc.yml"
   pull_request:
     paths:
       - "py/docs/**"

.github/workflows/go.yml

@@ -17,11 +17,6 @@
 name: Go tests and checks
 
 on:
-  push:
-    paths:
-      - "go/**"
-      - "genkit-tools/**"
-      - ".github/workflows/go.yml"
   pull_request:
     paths:
       - "go/**"

.github/workflows/publish_python.yml

@@ -0,0 +1,120 @@
+# Copyright 2025 Google LLC
+#
+# Licensed 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.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+name: Publish Python Package
+
+on:
+  workflow_dispatch:
+    inputs:
+      project_type:
+        description: Type of project
+        type: choice
+        default: package
+        required: true
+        options:
+          - packages
+          - plugins
+      project_name:
+        description: Project name publishing to Pypi
+        type: choice
+        default: genkit
+        required: true
+        options:
+          - genkit
+          - compat-oai
+          - dev-local-vector-store
+          - firebase
+          - flask
+          - google-cloud
+          - google-genai
+          - ollama
+          - vertex-ai
+
+
+
+jobs:
+  python_build:
+    name: Python build packages
+    runs-on: ubuntu-latest
+    env:
+      PATH: ${{ github.workspace }}/.cargo/bin:${{ github.workspace }}/.local/bin:/usr/local/bin:/usr/bin:/bin
+    strategy:
+      matrix:
+        python-version:
+          - "3.12"
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y build-essential curl libffi-dev
+
+      # Install rust for packages that requires it
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Install toml-cli
+        run: cargo install toml-cli
+
+      - name: Install uv and setup Python version
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Python dependencies
+        run: |
+          cd py/${{ github.event.inputs.project_type }}/${{ github.event.inputs.project_name }}
+          uv pip install -e .[dev,test,docs]
+          uv pip install twine toml
+
+      - name: Build package and validate pypi
+        run: |
+          cd py
+          PROJECT_NAME=${{ github.event.inputs.project_name }} PROJECT_TYPE=${{ github.event.inputs.project_type }}  ./bin/publish_pypi.sh
+
+      - name: Upload build packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: py/dist/
+
+  pypi_publish:
+    name: Upload to PyPI
+    needs: [python_build]
+    runs-on: ubuntu-latest
+    environment:
+      # change to publish or similar in productive CI
+      name: pypi_github_publishing
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: py/dist/
+
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          packages-dir: py/dist/

.github/workflows/python.yml

@@ -17,11 +17,6 @@
 name: Python Checks
 
 on:
-  push:
-    paths:
-      - "py/**"
-      - "genkit-tools/**"
-      - ".github/workflows/python.yml"
   pull_request:
     paths:
       - "py/**"
@@ -36,6 +31,8 @@ jobs:
     strategy:
       matrix:
         python-version:
+          #- "3.10" # TODO: Add back in when asyncio channel is fixed.
+          - "3.11"
           - "3.12"
           - "3.13"
       fail-fast: false
@@ -78,6 +75,7 @@ jobs:
         run: |
           cd py
           uv pip install -e .[dev,test,docs]
+          uv pip install --group dev
 
       - name: Install NPM packages
         run: |

.github/workflows/tests.yml

@@ -16,23 +16,7 @@
 
 name: Run Tests
 
-on:
-  push:
-    paths:
-      - "**/package.json"
-      - "js/**"
-      - "genkit-tools/**"
-      - "tests/**"
-      - "samples/**"
-      - ".github/workflows/tests.yml"
-  pull_request:
-    paths:
-      - "**/package.json"
-      - "js/**"
-      - "tests/**"
-      - "samples/**"
-      - "genkit-tools/**"
-      - ".github/workflows/tests.yml"
+on: pull_request
 
 env:
   GITHUB_PULL_REQUEST_HEAD_SHA: ${{ github.event.pull_request.head.sha }}

.gitignore

@@ -1,15 +1,16 @@
 # General build + OS files
-node_modules
-lib
-dist
-.vscode
-.DS_Store
-package-lock.json
 !samples/**/package-lock.json
-.angular
+*.eld
 *.tgz
-.pnpm-store
+.DS_Store
+.angular
 .next
+.pnpm-store
+.vscode
+dist
+lib
+node_modules
+package-lock.json
 # version file (autogenerated by CLI)
 genkit-tools/cli/src/utils/version.ts
 
@@ -47,3 +48,9 @@ next-env.d.ts
 
 !samples/chatbot/server/genkit-ai-vertexai-*.tgz
 .idea/
+
+# Build artifacts
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.nox/

README.md

@@ -1,7 +1,7 @@
 [![Run e2e tests](https://github.com/firebase/genkit/actions/workflows/e2e-tests.yml/badge.svg)](https://github.com/firebase/genkit/actions/workflows/e2e-tests.yml)
 
-![Firebase Genkit logo](docs/resources/genkit-logo-dark.png#gh-dark-mode-only 'Firebase Genkit')
-![Firebase Genkit logo](docs/resources/genkit-logo.png#gh-light-mode-only 'Firebase Genkit')
+![Genkit logo](docs/resources/genkit-logo-dark.png#gh-dark-mode-only 'Genkit')
+![Genkit logo](docs/resources/genkit-logo.png#gh-light-mode-only 'Genkit')
 
 Genkit is a framework for building AI-powered applications. It provides open source libraries for Node.js and Go, along with tools to help you debug and iterate quickly.
 

bin/check_license

@@ -22,6 +22,8 @@ set -euo pipefail
 
 TOP_DIR=$(git rev-parse --show-toplevel)
 
+PY_DIR="${TOP_DIR}/py"
+
 if ! command -v addlicense &>/dev/null; then
   if ! command -v go &>/dev/null; then
     echo "Please install go"
@@ -60,3 +62,5 @@ $HOME/go/bin/addlicense \
   -ignore '.nx/**/*' \
   -ignore '.trunk/**/*' \
   "$TOP_DIR"
+
+uv run --directory "${PY_DIR}" liccheck