README.md

---
title: HumanizeBot
emoji: 🎵
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.0.0
app_file: app.py
pinned: false
license: mit
---

# HumanizeBot - AI Music Humanizer

Remove the robotic feel from AI-generated music by adding human-like timing and velocity variations.

## 🎹 What it Does

HumanizeBot processes MIDI files from AI music generators and:
- Adds natural timing variations (like a human musician)
- Adjusts velocity dynamics for more expression
- Applies swing/groove to rhythmic parts
- Makes AI music sound more organic and human-performed

## 🚀 How to Use

1. **Upload** MIDI files from your AI music generator
2. **Adjust settings**:
   - **Intensity**: How much humanization to apply
   - **Style**: Organic, Groovy, or Gentle
   - **Swing**: Add rhythmic push/pull
3. **Click "Humanize My Music!"**
4. **Download** your humanized MIDI files

## 🎯 Perfect For

- Soundraw, AIVA, MuseNet, and other AI music generators
- Making robotic drum patterns feel alive
- Adding natural feel to piano/synth sequences
- Preparing AI compositions for live performance

## 🔧 Technical Details

Built with:
- Gradio for the web interface
- PrettyMIDI for MIDI processing
- NumPy/SciPy for audio processing

Supports: `.mid`, `.midi` files