pymtcnn 1.1.0__tar.gz

pymtcnn-1.1.0/.github/workflows/publish.yml

@@ -0,0 +1,43 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for trusted publishing
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check distribution
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-packages
+          path: dist/

pymtcnn-1.1.0/.gitignore

@@ -0,0 +1,91 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# 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/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Test files
+test_image.jpg
+test_video.mp4
+output_*.jpg
+cache/
+*.json
+detections_for_pyfaceau.json

pymtcnn-1.1.0/GITHUB_SETUP.md

@@ -0,0 +1,189 @@
+# GitHub Repository Setup for PyMTCNN
+
+## Step 1: Create GitHub Repository
+
+1. Go to https://github.com/new
+2. Settings:
+   - Name: `PyMTCNN`
+   - Description: `High-performance MTCNN face detection optimized for Apple Neural Engine - 34.26 FPS`
+   - Public
+   - Do NOT initialize with README, .gitignore, or license
+
+3. Click "Create repository"
+
+## Step 2: Initialize Git and Push
+
+```bash
+cd /Users/johnwilsoniv/Documents/SplitFace\ Open3/pymtcnn
+
+# Initialize git repo
+git init
+git add .
+git commit -m "Initial commit - PyMTCNN v1.0.0"
+
+# Add remote (replace YOUR-USERNAME with your GitHub username)
+git remote add origin https://github.com/YOUR-USERNAME/PyMTCNN.git
+
+# Push to GitHub
+git branch -M main
+git push -u origin main
+```
+
+## Step 3: Update Package Metadata with Correct URLs
+
+After creating the repo, update these files with your actual GitHub username:
+
+### Update `setup.py`:
+```python
+url="https://github.com/YOUR-USERNAME/PyMTCNN",
+```
+
+### Update `pyproject.toml`:
+```toml
+[project.urls]
+Homepage = "https://github.com/YOUR-USERNAME/PyMTCNN"
+Documentation = "https://github.com/YOUR-USERNAME/PyMTCNN/blob/main/README.md"
+Repository = "https://github.com/YOUR-USERNAME/PyMTCNN"
+"Bug Tracker" = "https://github.com/YOUR-USERNAME/PyMTCNN/issues"
+```
+
+Then commit and push the changes:
+```bash
+git add setup.py pyproject.toml
+git commit -m "Update GitHub URLs"
+git push
+```
+
+## Step 4: Link PyPI to GitHub (Optional but Recommended)
+
+### Option A: Manual Setup (Simple)
+
+Your PyPI package will automatically link to GitHub if the URLs in `setup.py` and `pyproject.toml` are correct. When you upload to PyPI, it will show:
+- Homepage link → Your GitHub repo
+- Source code link → Your GitHub repo
+- Bug tracker link → GitHub issues
+
+**That's it!** The metadata in your package does the linking.
+
+### Option B: GitHub Actions for Automated Publishing (Advanced)
+
+If you want to automatically publish to PyPI when you create a GitHub release:
+
+1. **Add PyPI API token to GitHub Secrets**:
+   - Go to your PyMTCNN repo on GitHub
+   - Settings → Secrets and variables → Actions
+   - Click "New repository secret"
+   - Name: `PYPI_API_TOKEN`
+   - Value: Your PyPI API token (starts with `pypi-...`)
+   - Click "Add secret"
+
+2. **Create GitHub Actions workflow**:
+
+Create `.github/workflows/publish.yml`:
+
+```yaml
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: twine upload dist/*
+```
+
+3. **How it works**:
+   - Create a GitHub release (e.g., v1.0.1)
+   - GitHub Actions automatically builds and uploads to PyPI
+   - No manual `twine upload` needed!
+
+### Option C: Link Existing PyPI Package to GitHub
+
+If you've already published to PyPI:
+
+1. Log in to https://pypi.org
+2. Go to your project: https://pypi.org/project/pymtcnn/
+3. Click "Manage" → "Settings"
+4. The links should already be there from your package metadata
+5. If not, you can rebuild and re-upload with updated metadata
+
+## Step 5: Create First Release
+
+After pushing to GitHub:
+
+1. Go to your repo: https://github.com/YOUR-USERNAME/PyMTCNN
+2. Click "Releases" → "Create a new release"
+3. Tag: `v1.0.0`
+4. Title: `PyMTCNN v1.0.0 - High-Performance Face Detection`
+5. Description:
+```markdown
+# PyMTCNN v1.0.0
+
+High-performance MTCNN face detection optimized for Apple Neural Engine.
+
+## Installation
+```bash
+pip install pymtcnn
+```
+
+## Performance
+- 34.26 FPS with batch processing
+- 175.7x speedup over baseline
+- 95% IoU accuracy
+
+## Links
+- PyPI: https://pypi.org/project/pymtcnn/
+- Documentation: [README.md](README.md)
+```
+
+6. Attach files (optional):
+   - `dist/pymtcnn-1.0.0-py3-none-any.whl`
+   - `dist/pymtcnn-1.0.0.tar.gz`
+
+7. Click "Publish release"
+
+## What You Get
+
+After setup, your PyPI page will show:
+- ✅ Homepage link to GitHub
+- ✅ Source code link to GitHub
+- ✅ Bug tracker link to GitHub Issues
+- ✅ Automatic README rendering from PyPI
+- ✅ Download badges
+- ✅ License information
+
+## Quick Summary
+
+**For basic linking** (recommended):
+1. Create GitHub repo named `PyMTCNN`
+2. Push pymtcnn code to it
+3. Update `setup.py` and `pyproject.toml` with correct GitHub URLs
+4. Upload to PyPI with `twine upload dist/*`
+5. PyPI automatically links to GitHub!
+
+**For automated publishing** (optional):
+- Add GitHub Actions workflow
+- Add PyPI token to GitHub Secrets
+- Create releases on GitHub → auto-publishes to PyPI

pymtcnn-1.1.0/LICENSE

@@ -0,0 +1,47 @@
+Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)
+
+Copyright (c) 2025 SplitFace
+
+This work is licensed under the Creative Commons Attribution-NonCommercial 4.0
+International License. To view a copy of this license, visit
+http://creativecommons.org/licenses/by-nc/4.0/ or send a letter to
+Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
+
+================================================================================
+
+You are free to:
+
+  * Share — copy and redistribute the material in any medium or format
+  * Adapt — remix, transform, and build upon the material
+
+The licensor cannot revoke these freedoms as long as you follow the license terms.
+
+================================================================================
+
+Under the following terms:
+
+  * Attribution — You must give appropriate credit, provide a link to the
+    license, and indicate if changes were made. You may do so in any reasonable
+    manner, but not in any way that suggests the licensor endorses you or your use.
+
+  * NonCommercial — You may not use the material for commercial purposes.
+
+  * No additional restrictions — You may not apply legal terms or technological
+    measures that legally restrict others from doing anything the license permits.
+
+================================================================================
+
+Notices:
+
+You do not have to comply with the license for elements of the material in the
+public domain or where your use is permitted by an applicable exception or
+limitation.
+
+No warranties are given. The license may not give you all of the permissions
+necessary for your intended use. For example, other rights such as publicity,
+privacy, or moral rights may limit how you use the material.
+
+================================================================================
+
+Full legal code available at:
+https://creativecommons.org/licenses/by-nc/4.0/legalcode

pymtcnn-1.1.0/MANIFEST.in

@@ -0,0 +1,25 @@
+# Include documentation
+include README.md
+include LICENSE
+include requirements.txt
+
+# Include documentation folder
+recursive-include docs *.md
+
+# Include examples
+recursive-include examples *.py
+
+# Include CoreML models (all files in .mlpackage bundles)
+recursive-include pymtcnn/models *.mlpackage/*
+recursive-include pymtcnn/models *.mlmodel
+recursive-include pymtcnn/models *.bin
+recursive-include pymtcnn/models Manifest.json
+
+# Include ONNX models
+include pymtcnn/models/*.onnx
+
+# Exclude compiled Python files
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.so
+global-exclude .DS_Store