video-analyser 0.5.17__tar.gz

video_analyser-0.5.17/.gitignore

@@ -0,0 +1,226 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.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/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be added to the global gitignore or merged into this project gitignore
+.idea/
+
+# VS Code
+.vscode/
+
+# Project specific ignores
+# Temporary files and processing artifacts
+temp/
+tmp/
+*.tmp
+*.temp
+
+# Model files (often large)
+models/
+*.pkl
+*.model
+*.bin
+*.safetensors
+
+# Video/audio files for testing
+*.mp4
+*.avi
+*.mov
+*.webm
+*.wav
+*.mp3
+*.m4a
+!tests/fixtures/sample*  # Keep small test samples
+
+# Development samples (not committed)
+samples/
+
+# Generated reports and outputs
+output/
+/reports/  # Only ignore reports/ in root, not src/deep_brief/reports/
+*.html
+*.pdf
+!src/deep_brief/reports/templates/*.html  # Keep template files
+!src/deep_brief/**/*.html  # Keep source code HTML files
+!src/deep_brief/**/*.py  # Keep all Python source files
+
+# Cache directories
+.cache/
+cache/
+
+# OS specific
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# AI/ML specific
+wandb/
+mlruns/
+.neptune/
+lightning_logs/
+
+# Gradio temporary files
+gradio_cached_examples/
+flagged/
+
+# Configuration with secrets
+.env.local
+.env.production
+config/secrets.yaml
+config/production.yaml

video_analyser-0.5.17/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.4
+Name: video-analyser
+Version: 0.5.17
+Summary: Video analysis lens for the modular assessment platform - extracts frames, transcripts, and quality metrics
+Author-email: Michael Borck <michael@example.com>
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: anthropic>=0.7.0
+Requires-Dist: faster-whisper>=0.10.0
+Requires-Dist: ffmpeg-python>=0.2.0
+Requires-Dist: gradio>=4.8.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: opencv-python>=4.8.0
+Requires-Dist: pandas>=2.1.0
+Requires-Dist: pillow>=10.1.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pytesseract>=0.3.10
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.7.0
+Requires-Dist: spacy>=3.7.0
+Requires-Dist: torch>=2.2.0
+Requires-Dist: torchvision>=0.17.0
+Requires-Dist: tqdm>=4.66.0
+Requires-Dist: transformers>=4.36.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: weasyprint>=60.0
+Provides-Extra: api
+Requires-Dist: google-generativeai>=0.3.0; extra == 'api'
+Requires-Dist: openai>=1.12.0; extra == 'api'
+Provides-Extra: audio
+Requires-Dist: speech-analyser>=0.1.0; extra == 'audio'
+Provides-Extra: build
+Requires-Dist: build>=1.0.0; extra == 'build'
+Requires-Dist: twine>=4.0.0; extra == 'build'
+Provides-Extra: dev
+Requires-Dist: basedpyright>=1.8.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.6; extra == 'dev'
+Requires-Dist: types-pillow>=10.2.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12; extra == 'dev'
+Requires-Dist: types-requests>=2.31.0; extra == 'dev'
+Requires-Dist: types-setuptools>=80.9.0; extra == 'dev'
+Provides-Extra: gpu
+Requires-Dist: torch>=2.2.0; extra == 'gpu'
+Requires-Dist: torchvision>=0.17.0; extra == 'gpu'
+Description-Content-Type: text/markdown
+
+# Video Lens
+
+[![PyPI version](https://badge.fury.io/py/video-lens.svg)](https://pypi.org/project/video-lens/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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-lens
+```
+
+### 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-lens.git
+cd video-lens
+
+# 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-lens --help
+
+# Check version
+video-lens version
+
+# Launch web interface (coming soon)
+video-lens analyze
+
+# Analyze a specific video (CLI mode - coming soon)
+video-lens 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-lens.git
+cd video-lens
+uv venv && source .venv/bin/activate
+uv pip install -e ".[dev]"
+
+# Verify setup
+video-lens --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_lens/          # 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-lens/
+- **GitHub**: https://github.com/michael-borck/video-lens
+- **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.

video_analyser-0.5.17/README.md

@@ -0,0 +1,161 @@
+# Video Lens
+
+[![PyPI version](https://badge.fury.io/py/video-lens.svg)](https://pypi.org/project/video-lens/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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-lens
+```
+
+### 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-lens.git
+cd video-lens
+
+# 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-lens --help
+
+# Check version
+video-lens version
+
+# Launch web interface (coming soon)
+video-lens analyze
+
+# Analyze a specific video (CLI mode - coming soon)
+video-lens 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-lens.git
+cd video-lens
+uv venv && source .venv/bin/activate
+uv pip install -e ".[dev]"
+
+# Verify setup
+video-lens --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_lens/          # 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-lens/
+- **GitHub**: https://github.com/michael-borck/video-lens
+- **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.

video_analyser-0.5.17/config/config.yaml

@@ -0,0 +1,73 @@
+# Video Lens Configuration File
+# This file contains the default configuration for the Video Lens application.
+# You can override these settings with environment variables using the VIDEO_LENS_ prefix.
+
+# Application settings
+app_name: "Video Lens"
+debug: false
+
+# Video processing configuration
+processing:
+  max_video_size_mb: 500
+  supported_formats:
+    - "mp4"
+    - "mov"
+    - "avi"
+    - "webm"
+  temp_dir: "temp"
+  cleanup_temp_files: true
+
+# Scene detection settings
+scene_detection:
+  method: "threshold"  # threshold or adaptive
+  threshold: 0.4       # 0.1-0.9, lower = more scenes detected
+  min_scene_duration: 2.0      # minimum seconds per scene
+  fallback_interval: 30.0      # fallback if no scenes detected
+
+# Audio processing settings
+audio:
+  sample_rate: 16000   # Hz, required by Whisper
+  channels: 1          # mono audio
+  noise_reduction: false
+  normalize_audio: true
+
+# Speech transcription settings
+transcription:
+  model: "whisper-base"        # whisper model size
+  language: "auto"             # auto-detect or specific language code
+  word_timestamps: true        # enable word-level timing
+  temperature: 0.0             # sampling temperature (0.0 = deterministic)
+  device: "auto"               # auto, cpu, or cuda
+
+# Analysis settings
+analysis:
+  filler_words:
+    - "um"
+    - "uh"
+    - "like"
+    - "you know"
+    - "so"
+    - "actually"
+    - "basically"
+  target_wpm_range: [140, 160]  # ideal speaking rate range
+  sentiment_analysis: true
+  confidence_threshold: 0.7
+
+# Output settings
+output:
+  formats:
+    - "json"
+    - "html"
+  include_frames: true
+  frame_quality: 80            # JPEG quality 1-100
+  report_template: "default"
+
+# Logging configuration
+logging:
+  level: "INFO"                # DEBUG, INFO, WARNING, ERROR, CRITICAL
+  format: "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+  file_enabled: true
+  file_path: "logs/deep_brief.log"
+  max_bytes: 10000000          # 10MB log file size
+  backup_count: 5              # number of backup files
+  console_enabled: true

video_analyser-0.5.17/config/dev.yaml

@@ -0,0 +1,35 @@
+# Development Configuration
+# This configuration enables debug mode and verbose logging for development
+
+# Application settings
+app_name: "Video Lens (Development)"
+debug: true
+
+# Inherit most settings from default config, override specific ones
+processing:
+  max_video_size_mb: 100       # Smaller limit for testing
+  cleanup_temp_files: false    # Keep temp files for debugging
+
+# More sensitive scene detection for testing
+scene_detection:
+  threshold: 0.3               # More sensitive
+  min_scene_duration: 1.0      # Shorter scenes for testing
+
+# Development transcription settings
+transcription:
+  model: "whisper-tiny"        # Faster model for development
+  temperature: 0.1             # Slightly more randomness for testing
+
+# Analysis settings for development
+analysis:
+  confidence_threshold: 0.5    # Lower threshold for testing
+
+# Development logging - very verbose
+logging:
+  level: "DEBUG"
+  format: "%(asctime)s - %(name)s - %(levelname)s - %(funcName)s:%(lineno)d - %(message)s"
+  file_enabled: true
+  file_path: "logs/dev.log"
+  max_bytes: 5000000           # 5MB
+  backup_count: 3
+  console_enabled: true