feat: professional README and fix flake8 error

- Complete rewrite of README with modern, professional styling
- Add centered badges, tables, and improved visual hierarchy
- Include live demo section and architecture diagram
- Fix flake8 F824 error in decorators.py (unused nonlocal)
- Add performance metrics and project status sections

Author: SirStig