Audionomy is an intuitive, feature-rich application designed to simplify the creation, management, visualization, and sharing of audio datasets. Built specifically for researchers, data scientists, AI developers, and hobbyists, Audionomy streamlines audio metadata handling, visualization, and distribution.

• Customizable Dataset Templates: Define columns manually or import from existing CSV files.
• Automatic Audio Metadata Extraction: Auto-fills duration and file format upon audio upload.
• Integrated Audio Management: Easily add, edit, and remove audio entries directly within the GUI.
• Interactive Visualizations: Embedded Plotly visualizations to explore your audio data intuitively.
• Comprehensive Export Options:
  • CSV
  • JSON
  • Parquet
  • ZIP archive (for audio files)
• Cloud Integration:
  • Hugging Face Datasets
  • GitHub (with Git LFS)
  • Kaggle Dataset Publishing

• Python 3.9 or higher
• Poetry package manager

1. Clone the repository:

git clone https://github.com/your-username/audionomy.git
cd audionomy

2. Install dependencies using Poetry:

poetry install

Launch the application via:

poetry run python gui/app.py

Every dataset created with Audionomy follows this clear structure:

dataset_name/
├── audio/                # Contains all audio files
├── metadata.csv          # Metadata in CSV format
├── metadata.json         # Metadata in JSON format
├── metadata.parquet      # Metadata in Parquet format
└── dataset_name.template # Dataset template schema

Easily publish datasets:

• Authenticate with Hugging Face:

poetry run huggingface-cli login

• Use the integrated export option in the GUI to upload your dataset seamlessly.

Efficiently manage large audio datasets:

• Install Git LFS and configure:

sudo apt install git-lfs
git lfs install
git lfs track "datasets/**/*.mp3"
git lfs track "datasets/**/*.wav"
git add .gitattributes
git commit -m "Configure Git LFS for audio files"
git push origin main

Publish your dataset to Kaggle:

• Install and configure Kaggle CLI:

poetry add kaggle
mkdir -p ~/.kaggle
cp kaggle.json ~/.kaggle/
chmod 600 ~/.kaggle/kaggle.json

• Use the integrated GUI option for seamless export to Kaggle.

• GUI: PySide6 (Qt)
• Data Management: pandas, PyArrow
• Audio Handling: pydub
• Visualization: Plotly
• Package Management: Poetry

Audionomy is open-source software licensed under the MIT License.