beatstoch

Stochastic Drum Pattern Generator

Transform any song into unique, probabilistic MIDI drum patterns

[](https://pypi.org/project/beatstoch/) [](https://www.python.org/downloads/) [](https://unlicense.org/)

pippipxuv

uv tool install beatstoch

# Generate drums that match any song's BPM
beatstoch generate "Billie Jean" --artist "Michael Jackson"

# Rock beat at 120 BPM
beatstoch generate-bpm 120 --style rock

# Shuffle blues with human feel
beatstoch generate-bpm 85 --style blues --humanize 0.6

# Jazz ride pattern
beatstoch generate-bpm 140 --style jazz

• House

  ---

  Four-on-the-floor, driving hi-hats, snare/clap layers

  EDM · Techno · Minimal

• Breaks

  ---

  Syncopated kicks, complex hats, funky grooves

  Breakbeat · DnB · Hip-hop

• Rock

  ---

  Powerful backbeat, 8^th note hats, crash accents

  Rock · Alternative · Metal

• Blues

  ---

  Shuffle feel, ride cymbal, ghost notes

  Blues · 12-bar · Slow rock

• Indie

  ---

  Loose feel, floor tom accents, rimshots

  Indie rock · Lo-fi · Alternative

• Jazz

  ---

  Classic ride pattern, sparse comping, swing

  Jazz · Bebop · Fusion

• Generic

  ---

  Balanced patterns for any genre

  Demos · Experimentation

beatstoch generate-bpm 128 \
    --style house \           # 7 styles available
    --bars 16 \               # Pattern length
    --meter 4/4 \             # Time signature (2/4, 3/4, 4/4)
    --humanize 0.6 \          # Ghost notes + timing variation
    --groove-intensity 0.8 \  # Swing and feel
    --predictability 0.7      # 1.0=mechanical, 0.0=chaotic

from beatstoch import generate_stochastic_pattern

# Generate a rock beat
midi = generate_stochastic_pattern(
    bpm=120,
    bars=8,
    style="rock",
    humanize=0.5,
    predictability=0.8
)
midi.save("my_beat.mid")

• User Guide

  ---

  Complete CLI reference, all options, examples

• API Reference

  ---

  Python library documentation

• Developer Guide

  ---

  Contributing, architecture, testing