Skip to content

v0.0.6: Critical Bug Fix - Missing torch Dependency

Choose a tag to compare

@samuelmukoti samuelmukoti released this 14 Nov 19:25
· 3 commits to main since this release

v0.0.6 - CRITICAL BUG FIX 🚨

πŸ”΄ Critical Issue Fixed

Problem: pipx run censorbot and pip install censorbot completely failed due to missing torch dependency.

# Previously FAILED with ImportError
pipx run censorbot -i video.mp4 -o output.mp4
# Error: ModuleNotFoundError: No module named 'torch'

Root Cause: torch was not included in package dependencies, only installed in Docker images.

βœ… What's Fixed

  • Added torch>=2.0.0 to main dependencies
  • pip/pipx installations now work correctly
  • CPU/GPU/Metal platform detection works
  • Hardware acceleration properly detected

πŸ“¦ Installation Now Works

# All of these now work correctly:
pip install censorbot
pipx install censorbot
pipx run censorbot -i video.mp4 -o output.mp4

# With Apple Silicon Metal acceleration:
pip install 'censorbot[mlx]'
pipx install 'censorbot[mlx]'
pipx run --spec 'censorbot[mlx]' censorbot -i video.mp4 -o output.mp4

πŸš€ Hardware Acceleration

Now Fully Supported via pip/pipx:

  • βœ… CPU: Multi-threaded processing (default, included with torch)
  • βœ… NVIDIA GPU: CUDA acceleration (if CUDA toolkit installed)
  • βœ… Apple Silicon: Metal/Neural Engine via [mlx] extras

πŸ“ Migration Guide

If you installed v0.0.5 and it failed:

# Upgrade to v0.0.6
pip install --upgrade censorbot
# or
pipx upgrade censorbot

# Now it works!
censorbot -i video.mp4 -o output.mp4

πŸ”— Installation Methods

Method Command Use Case
pip pip install censorbot Permanent installation
pipx pipx install censorbot Isolated CLI tool
pipx run pipx run censorbot -i video.mp4 -o out.mp4 One-time use, no install
Docker docker pull samuelmukoti/censorbot:0.0.6 Containerized, FFmpeg included

⚠️ System Requirements

All pip/pipx methods require:

  • Python 3.8+
  • FFmpeg (install separately):
    • macOS: brew install ffmpeg
    • Ubuntu: sudo apt install ffmpeg
    • Windows: Download from ffmpeg.org

Docker method includes FFmpeg (no separate installation needed).

πŸ“Š What Changed

setup.py & pyproject.toml:

dependencies = [
+   "torch>=2.0.0",  # ← ADDED (critical fix)
    "faster-whisper>=1.0.0",
    "numpy>=1.24.0,<2.0.0",
    ...
]

README.md:

  • Added pipx installation instructions
  • Added hardware acceleration notes
  • Clarified MLX extras for Apple Silicon

πŸ”— Links


Apologies to early adopters - v0.0.5 was broken for pip/pipx users. This is now fixed! πŸ™

Installation

Via Pip

pip install censorbot==0.0.6

Via Docker

docker pull samuelmukoti/censorbot:0.0.6