v0.0.6: Critical Bug Fix - Missing torch Dependency
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.0to 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
- macOS:
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
- PyPI: https://pypi.org/project/censorbot/0.0.6/
- Docker Hub: https://hub.docker.com/r/samuelmukoti/censorbot
- Documentation: https://github.com/samuelmukoti/censorbot#readme
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.6Via Docker
docker pull samuelmukoti/censorbot:0.0.6