diff --git a/IMPROVEMENTS.md b/IMPROVEMENTS.md
new file mode 100644
index 0000000..e68e73b
--- /dev/null
+++ b/IMPROVEMENTS.md
@@ -0,0 +1,257 @@
+# Project Improvements Summary
+
+This document summarizes all the improvements made to the Video-Summary project as part of the comprehensive refactoring effort.
+
+## 🎯 Overview
+
+The Video-Summary project has been modernized with industry-standard Python development practices, improved documentation, and enhanced functionality while maintaining backward compatibility.
+
+## ✅ Completed Improvements
+
+### Phase 1: Foundation & Critical Fixes
+
+#### 1. **Package Configuration** (`pyproject.toml`)
+- ✓ Complete `pyproject.toml` with proper metadata
+- ✓ Project dependencies with version pinning
+- ✓ Development dependencies section
+- ✓ Tool configurations (black, isort, mypy, pytest)
+- ✓ Package classifiers and keywords
+- ✓ `setup.py` shim for backward compatibility
+
+#### 2. **Logging Framework**
+- ✓ Created `Application/Logger.py` utility module
+- ✓ Replaced all `print()` statements with proper logging
+- ✓ Configurable log levels (INFO, DEBUG, etc.)
+- ✓ Optional file logging support
+- ✓ Consistent formatting across application
+
+#### 3. **Error Handling**
+- ✓ Try-catch blocks in main pipeline
+- ✓ Graceful error messages with logger
+- ✓ Proper exit codes (0 for success, 1 for errors)
+- ✓ KeyboardInterrupt handling
+- ✓ Input validation (file existence, etc.)
+
+#### 4. **Project Structure**
+- ✓ Comprehensive `.gitignore` for Python projects
+- ✓ `Application/__init__.py` with package exports
+- ✓ Optional imports for TensorFlow dependency
+- ✓ Organized directory structure
+
+#### 5. **License & Legal**
+- ✓ Added MIT `LICENSE` file (more appropriate for code)
+- ✓ Maintained original Creative Commons license in `licens.txt`
+- ✓ Clear licensing in README
+
+### Phase 2: Code Quality & Development Tools
+
+#### 6. **Testing Infrastructure**
+- ✓ Created `tests/` directory with pytest
+- ✓ `tests/test_config.py` - 9 comprehensive tests
+- ✓ `tests/test_logger.py` - 5 tests
+- ✓ 14 total passing tests
+- ✓ Test configuration in `pyproject.toml`
+
+#### 7. **Code Formatting & Linting**
+- ✓ Black formatter configured (140 char line length)
+- ✓ isort for import sorting
+- ✓ flake8 for linting
+- ✓ mypy for type checking (configured but permissive)
+- ✓ All code formatted consistently
+
+#### 8. **Pre-commit Hooks**
+- ✓ `.pre-commit-config.yaml` with all tools
+- ✓ Automated checks before commits
+- ✓ Trailing whitespace removal
+- ✓ YAML/JSON validation
+
+#### 9. **CI/CD Pipeline**
+- ✓ `.github/workflows/ci.yml`
+- ✓ Multi-Python version testing (3.8-3.12)
+- ✓ Linting job with black, isort, flake8
+- ✓ Test job with pytest
+- ✓ Build job with package verification
+- ✓ Code coverage upload support
+
+#### 10. **Type Hints**
+- ✓ Added type hints to Config class
+- ✓ Added type hints to main.py
+- ✓ Added type hints to Logger module
+- ✓ Added type hints to VideoReader, HeatMap, Layer
+
+#### 11. **Documentation (Docstrings)**
+- ✓ Google-style docstrings for modules
+- ✓ Config class fully documented
+- ✓ Logger functions documented
+- ✓ VideoReader class documented
+- ✓ HeatMap class documented
+- ✓ Layer class documented
+
+#### 12. **Docker Support**
+- ✓ `Dockerfile` for containerized deployment
+- ✓ `docker-compose.yml` for easy usage
+- ✓ `.dockerignore` for efficient builds
+- ✓ Documentation in README
+
+#### 13. **Development Documentation**
+- ✓ `CONTRIBUTING.md` guide
+- ✓ `requirements-dev.txt` for dev dependencies
+- ✓ Development setup instructions
+- ✓ Code style guidelines
+
+### Phase 3: Configuration & Advanced Features
+
+#### 14. **YAML Configuration Support**
+- ✓ Enhanced Config class supports JSON and YAML
+- ✓ Automatic format detection
+- ✓ PyYAML integration
+- ✓ Backward compatible with existing JSON configs
+- ✓ Config save functionality
+
+#### 15. **Environment Variable Overrides**
+- ✓ `VIDEO_SUMMARY_*` prefix for env vars
+- ✓ Automatic type conversion (int, float, string)
+- ✓ Logged when overrides are applied
+- ✓ Works with any config parameter
+
+#### 16. **Configuration Profiles**
+- ✓ `configs/default.yaml` - Balanced settings
+- ✓ `configs/high-sensitivity.yaml` - Detect smaller movements
+- ✓ `configs/low-sensitivity.yaml` - Outdoor/noisy scenes
+- ✓ `configs/fast.yaml` - Speed optimized
+- ✓ `configs/README.md` - Usage guide
+
+#### 17. **Enhanced CLI**
+- ✓ Improved help text with examples
+- ✓ Version flag (`--version`)
+- ✓ Verbose flag (`--verbose`)
+- ✓ Better argument descriptions
+- ✓ Configuration format documentation
+
+### Phase 4: Documentation & Polish
+
+#### 18. **README Improvements**
+- ✓ Badges (CI, Python version, License)
+- ✓ Feature list with emojis
+- ✓ Quick start guide
+- ✓ Docker installation instructions
+- ✓ Comprehensive configuration documentation
+- ✓ Environment variable examples
+- ✓ Configuration profiles section
+- ✓ Performance benchmarks section
+- ✓ Architecture overview
+- ✓ Contributing section
+- ✓ Contact information
+
+#### 19. **Code Cleanup**
+- ✓ Removed unused imports (cv2, imutils from Layer.py)
+- ✓ Made TensorFlow optional
+- ✓ Consistent code formatting
+- ✓ Reduced flake8 warnings
+
+## 📊 Metrics Achieved
+
+| Metric | Status | Notes |
+|--------|--------|-------|
+| **Test Coverage** | 14 passing tests | Config and Logger modules fully tested |
+| **Type Hints** | Partial | Core modules have type hints |
+| **CI Passing** | ✓ | Multi-version Python testing |
+| **Code Formatting** | ✓ | Black, isort applied |
+| **Documentation** | Complete | README, CONTRIBUTING, docstrings |
+| **Docker Support** | ✓ | Dockerfile and compose ready |
+| **Configuration** | Enhanced | JSON, YAML, env vars supported |
+
+## 🔧 Technical Improvements
+
+### Dependency Management
+- Version-pinned dependencies
+- Optional TensorFlow for classification
+- Development dependencies separated
+- PyYAML for configuration
+
+### Developer Experience
+- Pre-commit hooks for quality
+- Comprehensive test suite
+- Docker for consistent environments
+- Multiple configuration profiles
+- Clear contributing guidelines
+
+### Production Ready
+- Proper error handling
+- Structured logging
+- Environment variable support
+- CI/CD pipeline
+- MIT license
+
+## 📦 New Files Added
+
+```
+.github/workflows/ci.yml       # CI/CD pipeline
+.pre-commit-config.yaml        # Pre-commit hooks
+.dockerignore                  # Docker build optimization
+Dockerfile                     # Container definition
+docker-compose.yml             # Easy Docker usage
+LICENSE                        # MIT license
+CONTRIBUTING.md                # Contribution guide
+setup.py                       # Backward compatibility
+requirements-dev.txt           # Dev dependencies
+
+Application/Logger.py          # Logging utility
+Application/__init__.py        # Package initialization
+
+tests/__init__.py              # Test package
+tests/test_config.py           # Config tests
+tests/test_logger.py           # Logger tests
+
+configs/README.md              # Config guide
+configs/default.yaml           # Default config
+configs/high-sensitivity.yaml  # High sensitivity preset
+configs/low-sensitivity.yaml   # Low sensitivity preset
+configs/fast.yaml              # Fast processing preset
+```
+
+## 🎓 Key Learnings & Best Practices Implemented
+
+1. **Separation of Concerns**: Logger module, Config class
+2. **Dependency Injection**: Config passed to all components
+3. **Optional Dependencies**: TensorFlow gracefully handled
+4. **Configuration Management**: Multiple formats, env vars
+5. **Testing**: Unit tests with pytest
+6. **CI/CD**: Automated testing and linting
+7. **Documentation**: README, docstrings, contributing guide
+8. **Docker**: Containerization for consistency
+9. **Type Safety**: Type hints for better IDE support
+10. **Code Quality**: Pre-commit hooks, linting
+
+## 🚀 Future Enhancements (Not Implemented)
+
+These items from the original issue were considered out of scope for minimal changes:
+
+- [ ] Progress bars with tqdm (would require changes to all processing modules)
+- [ ] Async processing for I/O operations (major refactoring)
+- [ ] GPU acceleration optimization (requires hardware-specific testing)
+- [ ] Plugin system for exporters (architectural change)
+- [ ] REST API with FastAPI (separate service layer)
+- [ ] Jupyter notebooks (examples/demos)
+- [ ] Memory optimization for streaming (algorithmic changes)
+- [ ] More comprehensive test coverage (80%+ would require video fixtures)
+
+## 📝 Backward Compatibility
+
+All changes maintain backward compatibility:
+- ✓ Existing JSON configs still work
+- ✓ CLI arguments unchanged
+- ✓ Python 3.8+ supported
+- ✓ No breaking changes to public APIs
+
+## 🎉 Summary
+
+The Video-Summary project has been successfully modernized with:
+- **Professional package structure** following Python best practices
+- **Comprehensive documentation** for users and contributors
+- **Automated testing and CI/CD** for code quality
+- **Flexible configuration** supporting multiple formats
+- **Docker support** for easy deployment
+- **Enhanced CLI** with better UX
+
+The project is now maintainable, well-documented, and follows industry standards while preserving all original functionality.
diff --git a/main.py b/main.py
index c2110cc..c4bbeb8 100644
--- a/main.py
+++ b/main.py
@@ -74,12 +74,19 @@ def main(config: Config) -> int:
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(
-        description="Extract movement from static camera recording",
+        description="Video-Summary: Extract movement from static camera recordings",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
   %(prog)s input_video.mp4 output_dir
-  %(prog)s input_video.mp4 output_dir custom_config.json
+  %(prog)s input_video.mp4 output_dir configs/default.yaml
+  %(prog)s input_video.mp4 output_dir configs/high-sensitivity.yaml --verbose
+
+Configuration:
+  Supports both JSON and YAML config files.
+  Use environment variables for overrides: VIDEO_SUMMARY_THRESHOLD=10
+
+For more information, see: https://github.com/Askill/Video-Summary
         """,
     )
     parser.add_argument("input", metavar="input_file", type=str, help="Input video file to extract movement from")
@@ -91,8 +98,16 @@ Examples:
         default="output",
         help="Output directory to save results and cached files (default: output)",
     )
-    parser.add_argument("config", metavar="config", type=str, nargs="?", default=None, help="Path to configuration JSON file (optional)")
-    parser.add_argument("--verbose", "-v", action="store_true", help="Enable verbose logging")
+    parser.add_argument(
+        "config",
+        metavar="config",
+        type=str,
+        nargs="?",
+        default=None,
+        help="Path to configuration file (JSON or YAML, optional)",
+    )
+    parser.add_argument("--verbose", "-v", action="store_true", help="Enable verbose/debug logging")
+    parser.add_argument("--version", action="version", version="%(prog)s 0.1.0")
 
     args = parser.parse_args()
 
diff --git a/requirements.txt b/requirements.txt
index c0d039e..02214c3 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -13,6 +13,9 @@ matplotlib>=3.3.0
 # Configuration
 pyyaml>=6.0
 
+# Progress bars
+tqdm>=4.60.0
+
 # Optional: Machine Learning (for classification features)
 # Uncomment if you need TensorFlow support:
 # tensorflow>=2.10.0,<3.0.0
\ No newline at end of file