kinemotion 0.4.0__tar.gz → 0.5.3__tar.gz

kinemotion-0.5.3/.github/workflows/release.yml

@@ -0,0 +1,45 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.8.17"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Create Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+          uv run semantic-release version
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

{kinemotion-0.4.0 → kinemotion-0.5.3}/.gitignore

@@ -61,4 +61,4 @@ Thumbs.db
 *.jpeg
 *.jpg
 
-.claude/settings.local.json*
+.claude/settings.local.json*

kinemotion-0.5.3/.pre-commit-config.yaml

@@ -0,0 +1,33 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: debug-statements
+      - id: mixed-line-ending
+
+  - repo: https://github.com/psf/black
+    rev: 23.12.1
+    hooks:
+      - id: black
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.9
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.7.1
+    hooks:
+      - id: mypy
+        args: [--ignore-missing-imports, --no-strict-optional]
+        exclude: ^tests/

kinemotion-0.5.3/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Your new feature here.
+
+### Changed
+- Your change here.
+
+### Deprecated
+- Your deprecated feature here.
+
+### Removed
+- Your removed feature here.
+
+### Fixed
+- Your bug fix here.
+
+### Security
+- Your security fix here.
+
+## [0.5.0] - 2025-10-26
+
+### Added
+- Initial release of `kinemotion`.

kinemotion-0.5.3/GEMINI.md

@@ -0,0 +1,162 @@
+# GEMINI.md
+
+This file provides guidance to the Gemini model when working with code in this repository.
+
+## Repository Purpose
+
+Kinemotion is a video-based kinematic analysis tool for athletic performance. It analyzes drop-jump videos to estimate ground contact time, flight time, and jump height. The analysis is done by tracking an athlete's movement using MediaPipe pose tracking and applying advanced kinematic calculations. It supports both traditional foot-based tracking and a more accurate center of mass (CoM) tracking.
+
+**IMPORTANT**: The tool's accuracy has not been validated against gold-standard measurements. Any accuracy claims are theoretical.
+
+## Project Setup
+
+### Dependencies
+
+The project uses `uv` for dependency management and `asdf` for Python version management.
+
+- **Python Version**: 3.12.7 (specified in `.tool-versions`). MediaPipe requires Python <= 3.12.
+- **Install Dependencies**: `uv sync`
+
+**Key Libraries:**
+
+- **Production**: `click`, `opencv-python`, `mediapipe`, `numpy`, `scipy`.
+- **Development**: `pytest`, `black`, `ruff`, `mypy`.
+
+### Development Commands
+
+- **Run CLI**: `uv run kinemotion dropjump-analyze <video_path>`
+- **Install/Sync Dependencies**: `uv sync`
+- **Run Tests**: `uv run pytest`
+- **Format Code**: `uv run black src/`
+- **Lint Code**: `uv run ruff check`
+- **Auto-fix Linting**: `uv run ruff check --fix`
+- **Type Check**: `uv run mypy src/kinemotion`
+- **Run All Checks**: `uv run ruff check && uv run mypy src/kinemotion && uv run pytest`
+
+## Architecture
+
+### Module Structure
+
+```text
+src/kinemotion/
+├── cli.py              # Main CLI entry point
+├── core/               # Shared functionality (pose, smoothing, filtering, video_io)
+└── dropjump/           # Drop jump specific analysis (cli, analysis, kinematics, debug_overlay)
+tests/                  # Unit and integration tests
+docs/                   # Documentation (PARAMETERS.md is key)
+```
+
+- `core/` contains reusable code for different jump types.
+- `dropjump/` contains logic specific to drop jumps.
+- The main `cli.py` registers subcommands from modules like `dropjump/cli.py`.
+
+### Analysis Pipeline
+
+1. **Pose Tracking** (`core/pose.py`): Extracts 13 body landmarks per frame using MediaPipe.
+2. **Center of Mass (CoM) Estimation** (`core/pose.py`): Optional, more accurate tracking using a biomechanical model.
+3. **Smoothing** (`core/smoothing.py`): A Savitzky-Golay filter reduces jitter.
+4. **Contact Detection** (`dropjump/analysis.py`): Analyzes vertical velocity to determine ground contact vs. flight.
+5. **Phase Identification**: Finds continuous ground contact and flight periods.
+6. **Sub-Frame Interpolation** (`dropjump/analysis.py`): Estimates exact transition times between frames using linear interpolation on the velocity curve, improving timing precision significantly.
+7. **Trajectory Curvature Analysis** (`dropjump/analysis.py`): Refines transition timing by detecting acceleration spikes (e.g., landing impact).
+8. **Metrics Calculation** (`dropjump/kinematics.py`): Calculates ground contact time, flight time, and jump height.
+9. **Output**: Provides metrics in JSON format and an optional debug video.
+
+## Critical Implementation Details
+
+### 1. Aspect Ratio Preservation & SAR Handling (`core/video_io.py`)
+
+- **CRITICAL**: The tool must preserve the source video's exact aspect ratio, including Sample Aspect Ratio (SAR) from mobile videos.
+- **DO**: Get frame dimensions from the first actual frame read from the video (`frame.shape[:2]`), not from `cv2.CAP_PROP_*` properties, which can be wrong for rotated videos.
+- **DO**: Use `ffprobe` to extract SAR and calculate correct display dimensions.
+- The `DebugOverlayRenderer` uses these display dimensions for the output video.
+
+### 2. Sub-Frame Interpolation (`dropjump/analysis.py`)
+
+- **CRITICAL**: Timing precision is achieved by interpolating between frames.
+- **Velocity Calculation**: Velocity is computed as the **first derivative of the smoothed position trajectory** using a Savitzky-Golay filter (`savgol_filter(..., deriv=1)`). This is much smoother and more accurate than simple frame-to-frame differences.
+- **Interpolation**: When velocity crosses the contact threshold between two frames, linear interpolation is used to find the fractional frame index of the crossing. This improves timing accuracy from ~33ms to ~10ms at 30fps.
+
+### 3. Trajectory Curvature Analysis (`dropjump/analysis.py`)
+
+- **CRITICAL**: Event timing is further refined using acceleration patterns.
+- **Acceleration Calculation**: Acceleration is the **second derivative of the smoothed position** (`savgol_filter(..., deriv=2)`).
+- **Event Detection**:
+  - **Landing**: A large acceleration spike (impact deceleration).
+  - **Takeoff**: A sharp change in acceleration.
+- **Blending**: The final transition time is a weighted blend: 70% from the curvature-based estimate and 30% from the velocity-based estimate. This is enabled by default via `--use-curvature`.
+
+### 4. JSON Serialization of NumPy Types (`dropjump/kinematics.py`)
+
+- **CRITICAL**: Standard `json.dump` cannot serialize NumPy integer types (e.g., `np.int64`).
+- **DO**: Explicitly cast all NumPy numbers to standard Python types (`int()`, `float()`) within the `to_dict()` methods of data classes before serialization.
+
+### 5. OpenCV Frame Dimensions
+
+- **CRITICAL**: Be aware of dimension ordering differences.
+- **NumPy `frame.shape`**: `(height, width, channels)`
+- **OpenCV `cv2.VideoWriter()` size**: `(width, height)`
+- Always pass dimensions to OpenCV functions in `(width, height)` order.
+
+## Code Quality & Workflow
+
+When contributing code, strictly adhere to the project's quality standards.
+
+1. **Format Code**: `uv run black src/`
+2. **Lint and Fix**: `uv run ruff check --fix`
+3. **Type Check**: `uv run mypy src/kinemotion`
+4. **Run Tests**: `uv run pytest`
+
+**Run all checks before committing**: `uv run ruff check && uv run mypy src/kinemotion && uv run pytest`
+
+- **Type Safety**: The project uses `mypy` in strict mode. All functions must have full type annotations.
+- **Linting**: `ruff` is used for linting. Configuration is in `pyproject.toml`.
+- **Formatting**: `black` is used for code formatting.
+
+## Common Development Tasks
+
+- **Adding New Metrics**:
+    1. Update `DropJumpMetrics` in `dropjump/kinematics.py`.
+    2. Add calculation logic in `calculate_drop_jump_metrics()`.
+    3. Update `to_dict()` method (remember to cast NumPy types).
+    4. (Optional) Add visualization in `DebugOverlayRenderer`.
+    5. Add tests in `tests/test_kinematics.py`.
+- **Modifying Contact Detection**: Edit `detect_ground_contact()` in `dropjump/analysis.py`.
+- **Adjusting Smoothing**: Modify `smooth_landmarks()` in `core/smoothing.py`.
+
+## Parameter Tuning
+
+A comprehensive guide to all CLI parameters is in `docs/PARAMETERS.md`. Refer to it for detailed explanations.
+
+**Key `dropjump-analyze` parameters:**
+
+- `--smoothing-window`: Controls trajectory smoothness. Increase for noisy video.
+- `--polyorder`: Polynomial order for smoothing. `2` is ideal for jump physics.
+- `--velocity-threshold`: Contact sensitivity. Decrease to detect shorter contacts.
+- `--min-contact-frames`: Temporal filter. Increase to remove false contacts.
+- `--drop-height`: **Important for accuracy.** Calibrates jump height using a known box height in meters.
+- `--use-curvature`: Enables acceleration-based timing refinement (default: True).
+- `--outlier-rejection`: Removes tracking glitches before smoothing (default: True).
+- `--bilateral-filter`: Experimental edge-preserving smoothing alternative to Savitzky-Golay.
+
+## Testing
+
+- **Run all tests**: `uv run pytest`
+- **Run a specific test file**: `uv run pytest tests/test_contact_detection.py -v`
+- The project has comprehensive test coverage for core functionalities like aspect ratio, contact detection, CoM estimation, and kinematics.
+
+## CLI Usage Examples
+
+```bash
+# Get help for the dropjump command
+uv run kinemotion dropjump-analyze --help
+
+# Basic analysis, print JSON to stdout
+uv run kinemotion dropjump-analyze video.mp4
+
+# Full analysis: generate debug video, save metrics, and use calibration
+uv run kinemotion dropjump-analyze video.mp4 \
+  --output debug_video.mp4 \
+  --json-output metrics.json \
+  --drop-height 0.40
+```

{kinemotion-0.4.0 → kinemotion-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.4.0
+Version: 0.5.3
 Summary: Video-based kinematic analysis for athletic performance
 Project-URL: Homepage, https://github.com/feniix/kinemotion
 Project-URL: Repository, https://github.com/feniix/kinemotion
@@ -9,7 +9,7 @@ Author-email: Sebastian Otaegui <feniix@gmail.com>
 License: MIT
 License-File: LICENSE
 Keywords: athletic-performance,drop-jump,kinemetry,kinemotion,mediapipe,pose-tracking,video-analysis
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
@@ -28,6 +28,12 @@ Description-Content-Type: text/markdown
 
 # Kinemotion
 
+[![PyPI version](https://badge.fury.io/py/kinemotion.svg)](https://badge.fury.io/py/kinemotion)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+
 A video-based kinematic analysis tool for athletic performance. Analyzes side-view drop-jump videos to estimate key performance metrics: ground contact time, flight time, and jump height. Uses MediaPipe pose tracking and advanced kinematics.
 
 ## Features

{kinemotion-0.4.0 → kinemotion-0.5.3}/README.md

@@ -1,5 +1,11 @@
 # Kinemotion
 
+[![PyPI version](https://badge.fury.io/py/kinemotion.svg)](https://badge.fury.io/py/kinemotion)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+
 A video-based kinematic analysis tool for athletic performance. Analyzes side-view drop-jump videos to estimate key performance metrics: ground contact time, flight time, and jump height. Uses MediaPipe pose tracking and advanced kinematics.
 
 ## Features

{kinemotion-0.4.0 → kinemotion-0.5.3}/docs/VALIDATION_PLAN.md

@@ -21,7 +21,7 @@ For a hobby project, validation means:
 - ✅ **Reasonable accuracy**: Measurements are "in the ballpark" for practical use
 - ✅ **Consistency**: Repeated measurements give similar results
 - ✅ **Sanity checks**: Results make physical sense (jump height from flight time checks out)
-- ✅ **Comparative accuracy**: Similar to other free/affordable tools (MyJump2, jump mats)
+- ✅ **Comparative accuracy**: Similar to other free/affordable tools (My Jump Lab, jump mats)
 - ❌ **NOT research-grade**: Not validated against force plates or motion capture systems
 
 ### Realistic Goals
@@ -72,15 +72,17 @@ For a hobby project, validation means:
 
 These methods cost nothing and can be done immediately by any user.
 
-### 3.1 Compare Against MyJump2 App
+### 3.1 Compare Against My Jump Lab App
 
-**What it is**: MyJump2 is a popular iPhone/Android app ($10-15) that calculates jump height from slow-motion video. It's been validated in multiple research studies (ICC > 0.95 vs. force plates).
+**What it is**: My Jump Lab (also known as My Jump 3) is a popular iPhone/Android app that calculates jump height from slow-motion video. It's been validated in multiple research studies (ICC > 0.95 vs. force plates).
+
+**Download**: [iOS App Store](https://apps.apple.com/us/app/my-jump-lab-my-jump-3/id1554077178) | [Google Play](https://play.google.com/store/apps/details?id=com.my.jump.lab&hl=en)
 
 **How to do it**:
 
-1. Download MyJump2 app (~$10, or use free trial if available)
+1. Download My Jump Lab app from the links above
 2. Record 10-20 jumps (countermovement or drop jumps)
-3. Process same video with both MyJump2 and Kinemotion
+3. Process same video with both My Jump Lab and Kinemotion
 4. Compare jump heights, contact times, flight times
 5. Calculate: mean difference, correlation, percentage error
 
@@ -92,7 +94,7 @@ These methods cost nothing and can be done immediately by any user.
 
 **Time required**: 2-3 hours
 
-**Validation value**: ⭐⭐⭐⭐⭐ (High - MyJump2 is well-validated)
+**Validation value**: ⭐⭐⭐⭐⭐ (High - My Jump Lab is well-validated)
 
 ### 3.2 Tracker Video Analysis Tool
 
@@ -137,10 +139,10 @@ These methods cost nothing and can be done immediately by any user.
 
 **Validation value**: ⭐⭐⭐⭐⭐ (Excellent - rigorous position-based validation, free)
 
-**Advantages over MyJump2**:
+**Advantages over My Jump Lab**:
 
 - Tracks full trajectory (not just flight time)
-- Open-source and free (MyJump2 costs $10-15)
+- Open-source and free (My Jump Lab costs $10-15)
 - More detailed analysis capabilities
 - Established in academic settings
 
@@ -328,7 +330,7 @@ print(f"Mean absolute error: {mae:.2f} cm")
 #### Day 1-2: Setup
 
 - [ ] Download Tracker (<https://physlets.org/tracker/>) - free and open-source
-- [ ] Alternative: Install MyJump2 app if iOS device available
+- [ ] Alternative: Install My Jump Lab app if iOS device available
 - [ ] Set up recording environment (good lighting, clear background)
 - [ ] Test camera angles and distances
 
@@ -344,14 +346,14 @@ print(f"Mean absolute error: {mae:.2f} cm")
 
 - [ ] Process all videos with Kinemotion
 - [ ] Analyze same videos with Tracker (track ankle/heel position)
-- [ ] Alternative: Use MyJump2 if available
+- [ ] Alternative: Use My Jump Lab if available
 - [ ] Export Tracker position data and calculate jump height
 - [ ] Calculate correlation, mean difference, MAE
 - [ ] Document results in validation notes
 
 #### Phase 1 Success Criteria
 
-- Correlation r > 0.85 with Tracker/MyJump2
+- Correlation r > 0.85 with Tracker/My Jump Lab
 - Mean difference < 5cm for jump height
 - Contact/flight times within ±30ms
 - Event detection within ±2-3 frames
@@ -404,19 +406,20 @@ Create a validation issue on GitHub:
 Help validate Kinemotion by comparing it with other tools!
 
 **What to do**:
-1. Record jumps with Kinemotion
-2. Compare with MyJump2, jump mat, or manual analysis
-3. Share your results here
+1. Record jump videos (with phone/camera at 60fps+)
+2. Analyze videos with Kinemotion
+3. Compare with My Jump Lab, jump mat, or manual analysis
+4. Share your results here
 
 **Data to share**:
 - Number of jumps analyzed
-- Reference tool used (MyJump2, jump mat, manual)
+- Reference tool used (My Jump Lab, jump mat, manual)
 - Correlation (if calculated)
 - Mean difference
 - Your assessment (good agreement? systematic bias?)
 
 **Example**:
-- 15 jumps compared with MyJump2
+- 15 jumps compared with My Jump Lab
 - Correlation: r = 0.91
 - Mean difference: -2.3cm (Kinemotion slightly lower)
 - Assessment: Good agreement for practical use
@@ -461,7 +464,7 @@ Help validate Kinemotion by comparing it with other tools!
 
 ### Realistic Timeline (Solo Developer)
 
-**Week 1**: MyJump2 comparison (2-3 hours total)
+**Week 1**: My Jump Lab comparison (2-3 hours total)
 **Week 2**: Manual video analysis (3-4 hours total)
 **Week 3**: Physics checks and repeatability (2-3 hours total)
 **Week 4**: Documentation and results write-up (2-3 hours total)
@@ -474,13 +477,13 @@ Help validate Kinemotion by comparing it with other tools!
 
 **Minimum (Free)**:
 
-- MyJump2 app (or use free trial): $0-15
+- My Jump Lab app (or use free trial): $0-15
 - Time: 10-15 hours
 - **Total: $0-15**
 
 **Recommended (Low-Cost)**:
 
-- MyJump2 app: $10-15
+- My Jump Lab app: $10-15
 - Basic jump mat: $200-400 (optional)
 - Time: 15-20 hours
 - **Total: $10-415**
@@ -534,7 +537,7 @@ Sometimes opportunities arise unexpectedly:
 ```markdown
 ## Validation Status
 
-Kinemotion has been validated through comparison with MyJump2 app and manual video analysis:
+Kinemotion has been validated through comparison with My Jump Lab app and manual video analysis:
 
 - **Jump height**: Correlation r = 0.88, MAE = 4.2cm (n=25 jumps, 30fps video)
 - **Flight time**: Correlation r = 0.91, MAE = 24ms (n=25 jumps, 30fps video)
@@ -575,7 +578,7 @@ Template:
 ## Methods
 
 ### Reference Tools
-- [List tools used: MyJump2, manual analysis, etc.]
+- [List tools used: My Jump Lab, manual analysis, etc.]
 
 ### Testing Protocol
 - [Number of jumps, video settings, conditions]
@@ -654,7 +657,7 @@ Template:
 
 You don't need perfect validation on day one. Start simple:
 
-1. **Phase 1**: Compare with MyJump2 (1 week, free)
+1. **Phase 1**: Compare with My Jump Lab (1 week, free)
 2. **Phase 2**: Manual verification (1 week, free)
 3. **Phase 3**: Document results (1 week)
 4. **Phase 4**: Community validation (ongoing)
@@ -682,7 +685,7 @@ Provide users with **honest, evidence-based information** about tool accuracy so
 |--------|---------------|-------------------|
 | **Budget** | $0-500 | $15,000-30,000 |
 | **Time** | 1-3 months | 6-12 months |
-| **Reference** | MyJump2, jump mat | Force plates, motion capture |
+| **Reference** | My Jump Lab, jump mat | Force plates, motion capture |
 | **Participants** | Self + volunteers | 30-50 recruited participants |
 | **Statistics** | Correlation, MAE | ICC, Bland-Altman, LOA |
 | **Ethics** | None required | IRB approval needed |
@@ -703,4 +706,4 @@ Provide users with **honest, evidence-based information** about tool accuracy so
 - Added Section 3.2: Tracker video analysis tool (free, open-source, rigorous)
 - Clarified that validation assumes 60fps baseline for accuracy targets
 
-**Next Steps**: Start with Phase 1 (Tracker or MyJump2 comparison at 60fps+)
+**Next Steps**: Start with Phase 1 (Tracker or My Jump Lab comparison at 60fps+)

{kinemotion-0.4.0 → kinemotion-0.5.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kinemotion"
-version = "0.4.0"
+version = "0.5.3"
 description = "Video-based kinematic analysis for athletic performance"
 readme = "README.md"
 requires-python = ">=3.10,<3.13"
@@ -10,7 +10,7 @@ authors = [
 ]
 keywords = ["kinemotion", "kinemetry", "video-analysis", "drop-jump", "athletic-performance", "pose-tracking", "mediapipe"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 3 - Alpha",
     "Intended Audience :: Science/Research",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
@@ -49,13 +49,10 @@ dev-dependencies = [
     "black>=23.12.0",
     "ruff>=0.1.8",
     "mypy>=1.7.0",
+    "pre-commit>=3.6.0",
+    "python-semantic-release>=9.8.2",
 ]
 
-[[tool.uv.index]]
-name = "testpypi"
-url = "https://test.pypi.org/simple/"
-publish-url = "https://test.pypi.org/legacy/"
-explicit = true
 
 [tool.ruff]
 line-length = 100
@@ -94,3 +91,21 @@ module = [
     "scipy.*",
 ]
 ignore_missing_imports = true
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+branch = "main"
+changelog_file = "CHANGELOG.md"
+build_command = "uv build"
+dist_path = "dist/"
+upload_to_vcs_release = true
+remove_dist = false
+patch_without_tag = false
+major_on_zero = false
+allow_zero_version = true
+commit_message = "chore(release): {version} [skip ci]"
+
+[tool.semantic_release.commit_parser_options]
+allowed_tags = ["feat", "fix", "docs", "style", "refactor", "perf", "test", "chore", "build", "ci"]
+minor_tags = ["feat"]
+patch_tags = ["fix", "perf"]