liveflowai 0.1.0__tar.gz

liveflowai-0.1.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.3
+Name: liveflowai
+Version: 0.1.0
+Summary: A Python-based audio analysis toolkit for real-time tempo and chord detection from music files and live microphone input.
+Author: Hioe Gregorius Owen, Petrus Aria Prakoso Widarto
+Author-email: Hioe Gregorius Owen <bloggerzz231@gmail.com>, Petrus Aria Prakoso Widarto <ariaprakoso@proton.me>
+Requires-Dist: librosa>=0.10.0
+Requires-Dist: numpy<2.0
+Requires-Dist: scipy>=1.13.0
+Requires-Dist: scikit-learn>=1.4.0
+Requires-Dist: harmonyscope>=1.0.0
+Requires-Dist: soundfile>=0.12.0
+Requires-Dist: audioread>=3.0.0
+Requires-Dist: resampy>=0.4.0
+Requires-Dist: cython>=0.25
+Requires-Dist: mido>=1.2.6
+Requires-Dist: basic-pitch>=0.4.0
+Requires-Dist: matplotlib>=3.10.9
+Requires-Dist: ffmpeg-python>=0.2.0
+Requires-Dist: pathlib>=1.0.1
+Requires-Dist: typing>=3.10.0.0
+Requires-Dist: pyaudio>=0.2.14
+Requires-Dist: pytest>=9.1.1
+Requires-Dist: sounddevice>=0.5.5
+Requires-Dist: pyttsx3>=2.99
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# LiveFlowAI
+
+A Python-based audio analysis toolkit for real-time tempo and chord detection from music files and live microphone input. Designed for music production, live performance analysis, and audio research.
+
+## Features
+
+- **Tempo Detection**: Accurately detect BPM and beat tracking for audio files
+- **Chord Analysis**: Automatic chord recognition and harmonic content analysis
+- **Real-time Live Detection**: Process live microphone input for immediate chord detection
+- **Database Storage**: Persist analysis results in SQLite with easy querying
+- **Visualization**: Visual representations of tempo and beat patterns
+- **IEM Integration**: Announce song information for in-ear monitor systems
+- **Multi-file Processing**: Batch analyze multiple audio files
+- **Confidence Metrics**: Get confidence scores for all detections
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.10 or higher
+- `uv` package manager (or pip as alternative)
+- FFmpeg (for audio format support)
+
+### Installation
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/yourusername/liveflowai.git
+   cd liveflowai
+   ```
+
+2. **Set up Python environment**
+   ```bash
+   # Using uv (recommended)
+   uv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+   uv sync
+   
+   # Or using pip
+   python -m venv venv
+   source venv/bin/activate
+   pip install -e .
+   ```
+
+### Basic Usage
+
+```bash
+# Run the interactive analysis tool
+python -m liveflowai
+
+# Or using the installed command
+liveflowai
+```
+
+The tool presents an interactive menu with options to:
+- Analyze audio files from your system
+- View all analyzed songs and their data
+- Store results in the local database
+- Visualize tempo patterns
+
+### Example Workflow
+
+```python
+from liveflowai.audio.tempo_analyzer import TempoAnalyzer
+from liveflowai.audio.chord_analyzer import ChordAnalyzer
+from liveflowai.database.database import DatabaseLogic
+
+# Initialize analyzers
+tempo_analyzer = TempoAnalyzer()
+chord_analyzer = ChordAnalyzer()
+db = DatabaseLogic()
+
+# Analyze an audio file
+audio_file = "path/to/song.mp3"
+
+# Detect tempo and beats
+tempo_data = tempo_analyzer.detect_tempo(audio_file)
+print(f"BPM: {tempo_data['tempo_bpm']}")
+
+# Analyze chords
+chords = chord_analyzer.analyze_chords(audio_file)
+for chord in chords:
+    print(f"{chord.timestamp:.2f}s: {chord}")
+
+# Store results
+db.MakeDB()
+db.PushDB(
+    filename="song.mp3",
+    duration=tempo_data['duration'],
+    bpm=tempo_data['tempo_bpm'],
+    chords=", ".join(str(c) for c in chords)
+)
+```
+
+## Project Structure
+
+```
+liveflowai/
+├── src/liveflowai/
+│   ├── audio/              # Audio processing modules
+│   │   ├── tempo_analyzer.py       # BPM and beat detection
+│   │   ├── chord_analyzer.py       # Chord recognition
+│   │   └── audio_file_selector.py  # File selection UI
+│   ├── detection/          # Real-time detection modules
+│   │   ├── chord_detector.py       # Live chord detection
+│   │   └── song_predictor.py       # Song/music prediction
+│   ├── database/           # Data persistence
+│   │   └── database.py     # SQLite database operations
+│   ├── output/             # Output handling
+│   │   └── iem_manager.py  # IEM announcements
+│   ├── transition/         # Audio transition analysis
+│   └── main.py             # CLI entry point
+├── config/                 # Configuration files
+├── data/                   # Data storage (databases, audio files)
+├── tests/                  # Unit tests
+└── pyproject.toml          # Project metadata and dependencies
+```
+
+## Core Modules
+
+### Audio Analysis
+- **TempoAnalyzer**: Detects BPM, beat tracking, and generates tempo visualizations using librosa
+- **ChordAnalyzer**: Identifies chord progressions and harmonic content with confidence metrics
+
+### Real-time Detection
+- **LiveChordDetector**: Process microphone input for real-time chord detection with temporal smoothing
+- **SongPredictor**: Identify or predict songs based on audio characteristics
+
+### Data Management
+- **DatabaseLogic**: SQLite database for storing analysis results with query methods
+- **AudioFileSelector**: Interactive file selection interface for batch processing
+
+## Dependencies
+
+Core dependencies include:
+- `librosa` - Audio analysis and processing
+- `numpy`, `scipy` - Numerical computations
+- `scikit-learn` - Machine learning utilities
+- `basic-pitch` - Pitch detection
+- `sounddevice` - Real-time audio I/O
+- `mido` - MIDI file support
+- `matplotlib` - Visualization
+
+See [pyproject.toml](pyproject.toml) for the complete list and versions.
+
+## Configuration
+
+Configuration can be customized in `config/config.yaml`. Currently minimal configuration is required, but this can be expanded for:
+- Sample rate settings
+- Analysis window sizes
+- Confidence thresholds
+- Output paths
+
+## Development
+
+### Running Tests
+
+```bash
+pytest tests/
+```
+
+### Project Structure Notes
+
+- The database is stored in `data/liveflow.db`
+- Put song files specifically in `data/songs/` before running the analysis tool
+- Visualizations are generated in the output directory
+- The project uses `uv_build` as the build backend
+
+## Troubleshooting
+
+### Audio File Not Found
+Ensure the audio file path is correct and the file format is supported (MP3, WAV, FLAC, etc.)
+
+### No Chords Detected
+- Verify the audio has clear harmonic content
+- Try different chord detection confidence thresholds
+- Check that audio sample rate is appropriate (22050 Hz default)
+
+### Real-time Detection Issues
+- Ensure microphone is properly connected and enabled
+- Check system audio input settings
+- Verify PyAudio/PortAudio installation
+
+## Support & Documentation
+
+- **Issues & Bugs**: Report via GitHub Issues
+- **Discussions**: Ask questions in GitHub Discussions
+
+## Authors & Maintainers
+
+- **Hioe Gregorius Owen** - [bloggerzz231@gmail.com](mailto:bloggerzz231@gmail.com)
+- **Petrus Aria Prakoso Widarto** - [ariaprakoso@proton.me](mailto:ariaprakoso@proton.me)
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE.txt](LICENSE.txt) for details.
+
+Copyright © 2026 bloggerzz231-jpg & Arialize
+
+## Acknowledgments
+
+Built with:
+- [Librosa](https://librosa.org/) - Audio analysis
+- [Basic Pitch](https://github.com/spotify/basic-pitch) - Pitch detection
+- [HarmonyScope](https://github.com/harmonic-analysis/harmonioscope) - Harmonic analysis
+- [Sonic Visualizer](https://www.sonicvisualiser.org/) - Visualization reference
+
+## Citation
+
+If you use LiveFlowAI in your research, please cite:
+
+```bibtex
+@software{liveflowai2025,
+  title={LiveFlowAI: Real-time Audio Analysis Toolkit},
+  author={Hioe Gregorius Owen and Petrus Aria Prakoso Widarto},
+  year={2026},
+  url={https://github.com/LurckeA/liveflowai}
+}
+```
+
+---
+
+**Status**: Research Project - Active Development
+
+For questions or issues, please open a GitHub issue or contact the maintainers.

liveflowai-0.1.0/README.md

@@ -0,0 +1,225 @@
+# LiveFlowAI
+
+A Python-based audio analysis toolkit for real-time tempo and chord detection from music files and live microphone input. Designed for music production, live performance analysis, and audio research.
+
+## Features
+
+- **Tempo Detection**: Accurately detect BPM and beat tracking for audio files
+- **Chord Analysis**: Automatic chord recognition and harmonic content analysis
+- **Real-time Live Detection**: Process live microphone input for immediate chord detection
+- **Database Storage**: Persist analysis results in SQLite with easy querying
+- **Visualization**: Visual representations of tempo and beat patterns
+- **IEM Integration**: Announce song information for in-ear monitor systems
+- **Multi-file Processing**: Batch analyze multiple audio files
+- **Confidence Metrics**: Get confidence scores for all detections
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.10 or higher
+- `uv` package manager (or pip as alternative)
+- FFmpeg (for audio format support)
+
+### Installation
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/yourusername/liveflowai.git
+   cd liveflowai
+   ```
+
+2. **Set up Python environment**
+   ```bash
+   # Using uv (recommended)
+   uv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+   uv sync
+   
+   # Or using pip
+   python -m venv venv
+   source venv/bin/activate
+   pip install -e .
+   ```
+
+### Basic Usage
+
+```bash
+# Run the interactive analysis tool
+python -m liveflowai
+
+# Or using the installed command
+liveflowai
+```
+
+The tool presents an interactive menu with options to:
+- Analyze audio files from your system
+- View all analyzed songs and their data
+- Store results in the local database
+- Visualize tempo patterns
+
+### Example Workflow
+
+```python
+from liveflowai.audio.tempo_analyzer import TempoAnalyzer
+from liveflowai.audio.chord_analyzer import ChordAnalyzer
+from liveflowai.database.database import DatabaseLogic
+
+# Initialize analyzers
+tempo_analyzer = TempoAnalyzer()
+chord_analyzer = ChordAnalyzer()
+db = DatabaseLogic()
+
+# Analyze an audio file
+audio_file = "path/to/song.mp3"
+
+# Detect tempo and beats
+tempo_data = tempo_analyzer.detect_tempo(audio_file)
+print(f"BPM: {tempo_data['tempo_bpm']}")
+
+# Analyze chords
+chords = chord_analyzer.analyze_chords(audio_file)
+for chord in chords:
+    print(f"{chord.timestamp:.2f}s: {chord}")
+
+# Store results
+db.MakeDB()
+db.PushDB(
+    filename="song.mp3",
+    duration=tempo_data['duration'],
+    bpm=tempo_data['tempo_bpm'],
+    chords=", ".join(str(c) for c in chords)
+)
+```
+
+## Project Structure
+
+```
+liveflowai/
+├── src/liveflowai/
+│   ├── audio/              # Audio processing modules
+│   │   ├── tempo_analyzer.py       # BPM and beat detection
+│   │   ├── chord_analyzer.py       # Chord recognition
+│   │   └── audio_file_selector.py  # File selection UI
+│   ├── detection/          # Real-time detection modules
+│   │   ├── chord_detector.py       # Live chord detection
+│   │   └── song_predictor.py       # Song/music prediction
+│   ├── database/           # Data persistence
+│   │   └── database.py     # SQLite database operations
+│   ├── output/             # Output handling
+│   │   └── iem_manager.py  # IEM announcements
+│   ├── transition/         # Audio transition analysis
+│   └── main.py             # CLI entry point
+├── config/                 # Configuration files
+├── data/                   # Data storage (databases, audio files)
+├── tests/                  # Unit tests
+└── pyproject.toml          # Project metadata and dependencies
+```
+
+## Core Modules
+
+### Audio Analysis
+- **TempoAnalyzer**: Detects BPM, beat tracking, and generates tempo visualizations using librosa
+- **ChordAnalyzer**: Identifies chord progressions and harmonic content with confidence metrics
+
+### Real-time Detection
+- **LiveChordDetector**: Process microphone input for real-time chord detection with temporal smoothing
+- **SongPredictor**: Identify or predict songs based on audio characteristics
+
+### Data Management
+- **DatabaseLogic**: SQLite database for storing analysis results with query methods
+- **AudioFileSelector**: Interactive file selection interface for batch processing
+
+## Dependencies
+
+Core dependencies include:
+- `librosa` - Audio analysis and processing
+- `numpy`, `scipy` - Numerical computations
+- `scikit-learn` - Machine learning utilities
+- `basic-pitch` - Pitch detection
+- `sounddevice` - Real-time audio I/O
+- `mido` - MIDI file support
+- `matplotlib` - Visualization
+
+See [pyproject.toml](pyproject.toml) for the complete list and versions.
+
+## Configuration
+
+Configuration can be customized in `config/config.yaml`. Currently minimal configuration is required, but this can be expanded for:
+- Sample rate settings
+- Analysis window sizes
+- Confidence thresholds
+- Output paths
+
+## Development
+
+### Running Tests
+
+```bash
+pytest tests/
+```
+
+### Project Structure Notes
+
+- The database is stored in `data/liveflow.db`
+- Put song files specifically in `data/songs/` before running the analysis tool
+- Visualizations are generated in the output directory
+- The project uses `uv_build` as the build backend
+
+## Troubleshooting
+
+### Audio File Not Found
+Ensure the audio file path is correct and the file format is supported (MP3, WAV, FLAC, etc.)
+
+### No Chords Detected
+- Verify the audio has clear harmonic content
+- Try different chord detection confidence thresholds
+- Check that audio sample rate is appropriate (22050 Hz default)
+
+### Real-time Detection Issues
+- Ensure microphone is properly connected and enabled
+- Check system audio input settings
+- Verify PyAudio/PortAudio installation
+
+## Support & Documentation
+
+- **Issues & Bugs**: Report via GitHub Issues
+- **Discussions**: Ask questions in GitHub Discussions
+
+## Authors & Maintainers
+
+- **Hioe Gregorius Owen** - [bloggerzz231@gmail.com](mailto:bloggerzz231@gmail.com)
+- **Petrus Aria Prakoso Widarto** - [ariaprakoso@proton.me](mailto:ariaprakoso@proton.me)
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE.txt](LICENSE.txt) for details.
+
+Copyright © 2026 bloggerzz231-jpg & Arialize
+
+## Acknowledgments
+
+Built with:
+- [Librosa](https://librosa.org/) - Audio analysis
+- [Basic Pitch](https://github.com/spotify/basic-pitch) - Pitch detection
+- [HarmonyScope](https://github.com/harmonic-analysis/harmonioscope) - Harmonic analysis
+- [Sonic Visualizer](https://www.sonicvisualiser.org/) - Visualization reference
+
+## Citation
+
+If you use LiveFlowAI in your research, please cite:
+
+```bibtex
+@software{liveflowai2025,
+  title={LiveFlowAI: Real-time Audio Analysis Toolkit},
+  author={Hioe Gregorius Owen and Petrus Aria Prakoso Widarto},
+  year={2026},
+  url={https://github.com/LurckeA/liveflowai}
+}
+```
+
+---
+
+**Status**: Research Project - Active Development
+
+For questions or issues, please open a GitHub issue or contact the maintainers.

liveflowai-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "liveflowai"
+version = "0.1.0"
+description = "A Python-based audio analysis toolkit for real-time tempo and chord detection from music files and live microphone input."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "librosa>=0.10.0",
+    "numpy<2.0",
+    "scipy>=1.13.0",
+    "scikit-learn>=1.4.0",
+    "harmonyscope>=1.0.0",
+    "soundfile>=0.12.0",
+    "audioread>=3.0.0",
+    "resampy>=0.4.0",
+    "cython>=0.25",
+    "mido>=1.2.6",
+    "basic-pitch>=0.4.0",
+    "matplotlib>=3.10.9",
+    "ffmpeg-python>=0.2.0",
+    "pathlib>=1.0.1",
+    "typing>=3.10.0.0",
+    "pyaudio>=0.2.14",
+    "pytest>=9.1.1",
+    "sounddevice>=0.5.5",
+    "pyttsx3>=2.99",
+]
+
+[[project.authors]]
+name = "Hioe Gregorius Owen"
+email = "bloggerzz231@gmail.com"
+
+[[project.authors]]
+name = "Petrus Aria Prakoso Widarto"
+email = "ariaprakoso@proton.me"
+
+[project.scripts]
+liveflowai = "liveflowai.main:main"
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"

liveflowai-0.1.0/pyproject.toml.orig

@@ -0,0 +1,38 @@
+[project]
+name = "liveflowai"
+version = "0.1.0"
+description = "A Python-based audio analysis toolkit for real-time tempo and chord detection from music files and live microphone input."
+readme = "README.md"
+authors = [
+    { name = "Hioe Gregorius Owen", email = "bloggerzz231@gmail.com" },
+    { name = "Petrus Aria Prakoso Widarto", email = "ariaprakoso@proton.me" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "librosa>=0.10.0",
+    "numpy<2.0",
+    "scipy>=1.13.0",
+    "scikit-learn>=1.4.0",
+    "harmonyscope>=1.0.0",
+    "soundfile>=0.12.0",
+    "audioread>=3.0.0",
+    "resampy>=0.4.0",
+    "cython>=0.25",
+    "mido>=1.2.6",
+    "basic-pitch>=0.4.0",
+    "matplotlib>=3.10.9",
+    "ffmpeg-python>=0.2.0",
+    "pathlib>=1.0.1",
+    "typing>=3.10.0.0",
+    "pyaudio>=0.2.14",
+    "pytest>=9.1.1",
+    "sounddevice>=0.5.5",
+    "pyttsx3>=2.99",
+]
+
+[project.scripts]
+liveflowai = "liveflowai.main:main"
+
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13.0"]
+build-backend = "uv_build"

liveflowai-0.1.0/src/liveflowai/__main__.py

@@ -0,0 +1,5 @@
+# src/liveflowai/__main__.py
+from . import main
+
+if __name__ == "__main__":
+    main()