sample-tagger

name	sample-tagger
description	Help users manage, search, and organise audio sample libraries. Use when the user mentions samples, sample libraries, loops, one-shots, drum sounds, or wants to find/organise/tag audio files. Provides a pip-installable tool (in assets/) and assists with installation, searching, browsing, and organisation tasks.

Sample Tagger

Assist users with audio sample library management using the sample-tagger CLI tools.

Installation

The tool is in assets/sample-tagger-pkg/. Provide it to the user and instruct them to:

cd sample-tagger-pkg
pip install .

This installs four commands: sample-tag, sample-search, sample-browse, sample-organise.

Workflow

1. Initial setup (user runs once)

# Analyse their library (can take hours for large libraries, resumable)
sample-tag /path/to/samples

# Creates samples.db in that directory

2. Help with searches

When the user asks to find samples, translate their request into a sample-search command using --tag/-t flags. Tags use AND logic — multiple -t flags narrow the results.

User says	Command
"find kicks around 128bpm"	sample-search samples.db -t drums -t kick --bpm-min 125 --bpm-max 131
"show me pads in A minor"	sample-search samples.db -t synth -t pad -k A