https://github.com/michael-borck/video-analyser
Analyzes presentation videos using speech transcription, computer vision, and AI feedback.
https://github.com/michael-borck/video-analyser
ai ai-feedback borck-edu cli-tool computer-vision edtech ffmpeg machine-learning presentation-analysis python speech-recognition transcription video-analysis video-processing web-application
Last synced: 25 days ago
JSON representation
Analyzes presentation videos using speech transcription, computer vision, and AI feedback.
- Host: GitHub
- URL: https://github.com/michael-borck/video-analyser
- Owner: michael-borck
- License: mit
- Created: 2025-06-24T01:18:53.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-23T04:47:53.000Z (about 1 month ago)
- Last Synced: 2026-05-23T06:20:07.895Z (about 1 month ago)
- Topics: ai, ai-feedback, borck-edu, cli-tool, computer-vision, edtech, ffmpeg, machine-learning, presentation-analysis, python, speech-recognition, transcription, video-analysis, video-processing, web-application
- Language: Python
- Size: 1.46 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Video Analyser
Part of the [analyser family](https://github.com/michael-borck/lens-analysers).
[](https://github.com/topics/ai-feedback) [](https://github.com/topics/cli-tool) [](https://github.com/topics/computer-vision) [](https://github.com/topics/python) [](https://github.com/topics/speech-recognition) [](https://github.com/topics/video-analysis) [](https://github.com/topics/web-application) [](https://github.com/topics/presentation-analysis) [](https://github.com/topics/edtech) [](https://github.com/topics/ffmpeg)
[](https://pypi.org/project/video-analyser/)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
A video analysis application that helps students, educators, and professionals analyze presentations by combining speech transcription, visual analysis, and AI-powered feedback.
> **Status**: Phase 1 MVP in development. Core infrastructure complete, video processing pipeline in progress.
## Features
- **Video Processing**: Support for MP4, MOV, AVI, and WebM formats
- **Speech Analysis**: Automatic transcription with speaking rate and filler word detection
- **Visual Analysis**: Scene detection with frame captioning and quality assessment
- **AI Feedback**: Actionable insights and recommendations for improvement
- **Professional Reports**: Interactive HTML and structured JSON outputs
## Installation
### Prerequisites
- Python 3.11 or higher
- ffmpeg (for video processing)
### Option 1: Install from PyPI (recommended for users)
```bash
pip install video-analyser
```
### Option 2: Install from source (for development)
```bash
# Install uv (fast Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone the repository
git clone https://github.com/michael-borck/video-analyser.git
cd video-analyser
# Create virtual environment and install
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"
```
### Installing ffmpeg
**macOS:**
```bash
brew install ffmpeg
```
**Ubuntu/Debian:**
```bash
sudo apt update && sudo apt install ffmpeg
```
**Windows:**
Download from [https://ffmpeg.org/download.html](https://ffmpeg.org/download.html)
## Quick Start
```bash
# Show available commands
video-analyser --help
# Check version
video-analyser version
# Launch web interface (coming soon)
video-analyser analyze
# Analyze a specific video (CLI mode - coming soon)
video-analyser analyze video.mp4 --output ./reports
```
**Current Status**: The CLI framework is complete. Video processing features are in active development.
## Development
This project uses modern Python tooling and follows strict quality standards:
- **uv** for fast package management
- **ruff** for formatting and linting
- **basedpyright** for strict type checking
- **pytest** for testing with coverage
- **pyproject.toml** for all configuration (no setup.py)
### Development Setup
```bash
# Clone and setup
git clone https://github.com/michael-borck/video-analyser.git
cd video-analyser
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
# Verify setup
video-analyser --help
pytest -v
```
### Code Quality Standards
```bash
# Format code
ruff format .
# Lint code
ruff check .
# Type checking (strict mode)
basedpyright
# Run tests with coverage
pytest -v
# Run all quality checks
ruff format . && ruff check . && basedpyright && pytest -v
```
### Project Structure
```
src/video_analyser/ # Main package
├── core/ # Video processing pipeline
├── analysis/ # Speech and visual analysis
├── reports/ # Report generation
├── interface/ # Gradio web interface
└── utils/ # Configuration and utilities
tests/ # Test suite (mirrors src structure)
docs/ # Documentation and specs
tasks/ # Development task tracking
config/ # Configuration files
```
### Current Development Phase
- ✅ **Phase 0**: Project setup, packaging, PyPI publication
- 🚧 **Phase 1**: Core video processing pipeline (in progress)
- 📋 **Phase 2**: Enhanced analysis features
- 📋 **Phase 3**: Advanced AI features
See `tasks/tasks-prd-phase1-mvp.md` for detailed task tracking.
## Links
- **PyPI**: https://pypi.org/project/video-analyser/
- **GitHub**: https://github.com/michael-borck/video-analyser
- **Documentation**: Coming soon
## License
MIT License - see LICENSE file for details.
## Contributing
Contributions are welcome! Please read the development guidelines in `CLAUDE.md` for our coding standards and toolchain requirements.