pynode-flow 0.2.0__tar.gz

pynode_flow-0.2.0/.dockerignore

@@ -0,0 +1,23 @@
+# Docker ignore file
+.venv/
+appenv/
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+*.egg
+*.egg-info
+dist/
+build/
+.git/
+.gitignore
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+logs/
+*.log

pynode_flow-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install system libraries for OpenCV
+        run: sudo apt-get update && sudo apt-get install -y libgl1 libglib2.0-0
+
+      - name: Install package
+        run: pip install -e .[dev]
+
+      - name: Run tests
+        run: pytest -q
+
+  typecheck:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install package and pyright
+        run: pip install -e .[dev] pyright
+
+      - name: Run pyright
+        run: pyright

pynode_flow-0.2.0/.github/workflows/publish.yaml

@@ -0,0 +1,60 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  # Manual runs must be dispatched from a tag ref (e.g. v0.3.0), otherwise
+  # setuptools_scm produces a dev version that PyPI rejects.
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # setuptools_scm derives the version from git tags, so it needs the
+          # full history and the tags (a shallow checkout would break it).
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Check metadata
+        run: |
+          python -m pip install --upgrade twine
+          twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    # Trusted Publishing (OIDC) -- no API token stored in the repo. Configure a
+    # trusted publisher for the `pynode-flow` project on PyPI pointing at this
+    # workflow, and create a GitHub environment named `pypi`.
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pynode-flow
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pynode_flow-0.2.0/.gitignore

@@ -0,0 +1,193 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+PIPFILE.lock
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+appenv/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific - ignore all JSON files (workflows and backups)
+*.json
+
+# PyTorch model files
+*.pt
+models/
+todo
+*.bin
+*.xml
+*.yaml
+# ...but always keep GitHub Actions workflows (ci.yml / publish.yaml live here)
+!.github/
+!.github/**
+todo
+
+# Media and data files
+*.mp4
+*.avi
+*.mov
+*.mkv
+*.log
+*.csv
+*.db
+*.sqlite
+*.sqlite3
+*.h5
+*.ckpt
+*.tflite
+*.pb
+*.npy
+*.npz
+*.weights
+
+# Version file generated by setuptools_scm at build time
+pynode/_version.py
+
+# folders
+data/
+models/
+logs/
+checkpoints/
+output/
+output_low/
+output_not/

pynode_flow-0.2.0/DOCKER.md

@@ -0,0 +1,113 @@
+# Docker Setup for PyNode
+
+## Prerequisites
+
+- Docker Engine with GPU support (NVIDIA Container Toolkit)
+- Docker Compose v1.28+ (for GPU support)
+- NVIDIA GPU with CUDA support
+
+## Quick Start
+
+### Build and Run
+
+```bash
+docker-compose up --build
+```
+
+### Run in Background
+
+```bash
+docker-compose up -d
+```
+
+### View Logs
+
+```bash
+docker-compose logs -f
+```
+
+### Stop the Application
+
+```bash
+docker-compose down
+```
+
+## Configuration
+
+### Ports
+
+The application runs on port `5000` by default. To change the port, edit `docker-compose.yml`:
+
+```yaml
+ports:
+  - "8080:5000"  # Change 8080 to your desired port
+```
+
+### GPU Support
+
+The Docker Compose file is configured to use all available NVIDIA GPUs. To limit GPU access:
+
+```yaml
+deploy:
+  resources:
+    reservations:
+      devices:
+        - driver: nvidia
+          device_ids: ['0']  # Use only GPU 0
+          capabilities: [gpu]
+```
+
+### Persistent Storage
+
+The following directories are mounted for persistence:
+- `./workflows` - Saved workflows
+- `./logs` - Application logs
+
+## Building
+
+### Custom CUDA Version
+
+To use a different CUDA version, edit the `Dockerfile`:
+
+```dockerfile
+FROM nvidia/cuda:12.8.0-runtime-ubuntu22.04  # Change CUDA version
+```
+
+### Without GPU Support
+
+For CPU-only deployment, use the CPU Dockerfile:
+
+```bash
+docker build -f Dockerfile.cpu -t pynode-cpu .
+docker run -p 5000:5000 pynode-cpu
+```
+
+## Accessing the Application
+
+Once running, access the web interface at:
+- http://localhost:5000
+
+## Troubleshooting
+
+### GPU Not Detected
+
+Verify NVIDIA Container Toolkit is installed:
+```bash
+docker run --rm --gpus all nvidia/cuda:12.6.0-base-ubuntu22.04 nvidia-smi
+```
+
+### Permission Issues
+
+Ensure the mounted directories have proper permissions:
+```bash
+mkdir -p workflows logs
+chmod 777 workflows logs
+```
+
+### Rebuild from Scratch
+
+```bash
+docker-compose down
+docker-compose build --no-cache
+docker-compose up
+```

pynode_flow-0.2.0/Dockerfile

@@ -0,0 +1,66 @@
+FROM docker.io/nvidia/cuda:12.6.0-devel-ubuntu22.04
+
+# Set environment variables
+ENV DEBIAN_FRONTEND=noninteractive
+ENV PYTHONUNBUFFERED=1
+ENV CUDA_VERSION=12.6
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    python3.10 \
+    python3-pip \
+    python3-venv \
+    git \
+    wget \
+    gfortran \
+    libgl1-mesa-glx \
+    libgtk-3-0 \
+    libglib2.0-0 \
+    libsm6 \
+    libxext6 \
+    libxrender-dev \
+    libgomp1 \
+    libavcodec-dev \
+    libavformat-dev \
+    libswscale-dev \
+    libv4l-dev \
+    libxvidcore-dev \
+    libx264-dev \
+    libjpeg-dev \
+    libpng-dev \
+    libtiff-dev \
+    libopenblas-dev \
+    liblapack-dev \
+    portaudio19-dev \
+    libasound2-dev \
+    libusb-1.0-0 \
+    libusb-1.0-0-dev \
+    libudev-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy application files
+COPY . /app/
+
+# Make scripts executable
+RUN chmod +x /app/setup.sh /app/install_nodes.sh
+
+# Run setup script
+RUN bash -c "source /app/setup.sh < /dev/null"
+
+# Create a non-root user and give it ownership of the app directory
+RUN useradd --create-home --uid 1000 appuser \
+    && chown -R appuser:appuser /app
+USER appuser
+
+# Expose port
+EXPOSE 5000
+
+# Health check (uses the bundled Python interpreter; no extra tools required)
+HEALTHCHECK --interval=30s --timeout=5s --start-period=40s --retries=3 \
+    CMD ["/app/appenv/bin/python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:5000/')"]
+
+# Run the application in production mode
+CMD ["/app/appenv/bin/python", "-m", "pynode", "--production", "--host", "0.0.0.0", "--port", "5000"]

pynode_flow-0.2.0/Dockerfile.cpu

@@ -0,0 +1,49 @@
+FROM python:3.10-slim
+
+# Set environment variables
+ENV DEBIAN_FRONTEND=noninteractive
+ENV PYTHONUNBUFFERED=1
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    libgl1-mesa-glx \
+    libglib2.0-0 \
+    libsm6 \
+    libxext6 \
+    libxrender-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy application files
+COPY . /app/
+
+# Create virtual environment
+RUN python3 -m venv appenv
+
+# Activate venv and install dependencies (declared in pyproject.toml;
+# CPU-only torch is installed first so the vision extra reuses it)
+RUN . appenv/bin/activate && \
+    pip install --upgrade pip && \
+    pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu && \
+    pip install -e ".[vision,mqtt]"
+
+# Install per-node dependencies (best-effort: a node whose vendor SDK is not
+# on PyPI, e.g. OmronCameraNode's stapipy, is skipped without failing the build)
+RUN . appenv/bin/activate && pynode-install-nodes || true
+
+# Create a non-root user and give it ownership of the app directory
+RUN useradd --create-home --uid 1000 appuser \
+    && chown -R appuser:appuser /app
+USER appuser
+
+# Expose port
+EXPOSE 5000
+
+# Health check (uses the bundled Python interpreter; no extra tools required)
+HEALTHCHECK --interval=30s --timeout=5s --start-period=40s --retries=3 \
+    CMD ["/app/appenv/bin/python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:5000/')"]
+
+# Run the application in production mode
+CMD ["/app/appenv/bin/python", "-m", "pynode", "--production", "--host", "0.0.0.0", "--port", "5000"]

pynode_flow-0.2.0/INSTALL.md

@@ -0,0 +1,145 @@
+# Installation Guide
+
+PyNode is published on PyPI as **`pynode-flow`** (the import package is still
+`pynode`).
+
+## Install from PyPI
+
+```bash
+# Core install (Flask API + built-in nodes that need no extra packages)
+pip install pynode-flow
+
+# Everything PyPI-installable (all optional nodes)
+pip install "pynode-flow[full]"
+```
+
+Nodes whose optional dependencies are missing are simply skipped at startup, so
+a core-only install still runs fine.
+
+### Optional extras
+
+Install only the node groups you need:
+
+| Extra | Installs | Nodes it enables |
+|-------|----------|------------------|
+| `vision` | ultralytics, torch, torchvision, supervision | UltralyticsNode, TrackerNode, DrawPredictionsNode, … |
+| `mqtt` | paho-mqtt | MQTTNode |
+| `camera` | framesource[full] | FrameSourceNode |
+| `inference` | onnxruntime, geti-sdk (+ `vision`) | InferenceNode |
+| `vlm` | transformers, qwen-vl-utils, Pillow (+ `vision`) | Qwen3VLMNode |
+| `upload` | roboflow, geti-sdk | RoboflowUploadNode, GetiUploadNode |
+| `discovery` | zeroconf | mDNSNode |
+| `full` | all of the above | every PyPI-installable node |
+| `dev` | pytest, type stubs | (development only) |
+
+```bash
+pip install "pynode-flow[vision,mqtt]"   # pick specific groups
+pip install "pynode-flow[full]"          # or grab everything
+```
+
+> **Note:** `pip install pynode-flow` (or any extra) installs **only** what is
+> declared in `pyproject.toml`. It does **not** run the per-node
+> `requirements.txt` files — those are covered by the extras above, or by the
+> `pynode-install-nodes` command below.
+
+## Development Installation
+
+Install PyNode from a source checkout in editable mode (recommended for
+development):
+
+```bash
+# Clone or navigate to the project directory
+cd pynode
+
+# Install in editable mode (core dependencies only)
+pip install -e .
+
+# Optional extras (same names as above):
+pip install -e ".[vision]"      # ML vision nodes
+pip install -e ".[mqtt]"        # MQTT node
+pip install -e ".[full]"        # everything PyPI-installable
+pip install -e ".[dev]"         # development tools (pytest, type stubs)
+```
+
+This installs PyNode as a package while keeping your source files editable.
+
+> **Versioning:** the package version is derived from git tags by
+> `setuptools_scm`. A clean checkout at tag `v0.2.0` builds as `0.2.0`; commits
+> after a tag build as a dev version. To cut a release, tag the commit
+> (`git tag v0.2.0 && git push --tags`) — see [Publishing](#publishing-to-pypi).
+
+## Running PyNode
+
+After installation, you can run PyNode in multiple ways:
+
+### Option 1: Using the `pynode` command
+```bash
+pynode
+```
+
+### Option 2: Using Python module syntax
+```bash
+python -m pynode
+```
+
+### Option 3: With custom options
+```bash
+pynode --host 0.0.0.0 --port 5000 --production
+```
+
+## Command Line Options
+
+- `--host`: Host address to bind to (default: 0.0.0.0)
+- `--port`: Port to bind to (default: 5000)
+- `--production`: Run in production mode using Waitress server
+
+## Installing Node Dependencies
+
+A few nodes rely on packages that cannot live in `pyproject.toml` — for example
+the Omron/Sentech `stapipy` SDK (OmronCameraNode), which is a vendor download
+rather than a PyPI package. Each such node ships its own `requirements.txt`.
+
+**If you installed from PyPI**, use the bundled command to walk the installed
+node folders and install their requirements:
+
+```bash
+pynode-install-nodes            # install every node's requirements.txt
+pynode-install-nodes --list     # list nodes that have a requirements.txt
+pynode-install-nodes --node MQTTNode --node mDNSNode  # only specific nodes
+pynode-install-nodes --dry-run  # preview without installing
+```
+
+**If you're working from a source checkout**, you can instead run the helper
+scripts, which iterate the node folders in the repo:
+
+```bash
+# Windows
+install_nodes.bat
+
+# Linux/Mac
+./install_nodes.sh
+```
+
+## Publishing to PyPI
+
+Releases are published by `.github/workflows/publish.yaml` via PyPI
+[Trusted Publishing](https://docs.pypi.org/trusted-publishers/) (OIDC — no API
+token is stored in the repo). To release:
+
+1. Configure a trusted publisher for the `pynode-flow` project on PyPI, pointing
+   at this repository / `publish.yaml`, and create a GitHub environment named
+   `pypi` (one-time setup).
+2. Tag the release commit and push the tag:
+   ```bash
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
+   The tag drives the version via `setuptools_scm`. (A manual
+   `workflow_dispatch` run must also be dispatched from a tag ref, otherwise the
+   build produces a dev version that PyPI rejects.)
+
+## Uninstalling
+
+```bash
+pip uninstall pynode-flow
+```

pynode_flow-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oliver Hamilton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.