whatisgithub

What is vibetune?

suckstobeanik/vibetune — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · vibe coderComplexity · 3/5Setup · moderate

In one sentence

A command-line tool that turns a text mood description into a generated MIDI background music track using a local language model.

Mindmap

mindmap
  root((vibetune))
    What it does
      Text to music
      Local generation
      MIDI output
    Tech stack
      Python
      Ollama
      FluidSynth
    Features
      Trim and loop
      Variation command
      Saved presets
    Use cases
      Video background music
      Quick instrumental tracks
      Mood experimentation

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate MIDI background music for short videos or content just by typing a mood description.

USE CASE 2

Create quick looping instrumental tracks without hiring a composer or browsing stock music libraries.

USE CASE 3

Experiment with different musical variations of the same vibe description.

USE CASE 4

Save favorite vibe descriptions as presets to reuse across projects.

What is it built with?

PythonOllamaFluidSynthMIDI

How does it compare?

suckstobeanik/vibetune0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity3/54/51/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing Ollama with a local language model and FluidSynth separately.

So what is it?

Vibetune is a command-line tool that generates MIDI background music based on a text description of a mood or style. You type a phrase like "lofi study beat, rainy afternoon, jazzy chords" into a terminal prompt, and it produces a music track you can listen to right there and then export for use in short videos or other projects. The tool works by sending your vibe description to a locally running language model through a separate program called Ollama. The language model interprets the description and outputs a structured music specification: key, tempo, chord progression, and instrument choices. Vibetune then turns that specification into actual MIDI audio using a sound synthesis library called FluidSynth. Everything runs on your own machine with no internet connection required for the generation itself. Once a track is generated you can play, pause, and stop it without leaving the terminal. You can trim it to a specific length, crossfade the ending back into the beginning for a seamless loop, check info about the key and chords used, save it with a name of your choosing, or discard it if you want to try again. There is also a variation command that generates a new track in the same style with different musical choices, and a preset system that lets you save favorite vibe descriptions and reuse them later. Setup requires installing Ollama and pulling a specific language model, installing FluidSynth, and then installing vibetune itself via pip. The README lists commands for macOS and Linux. The default model is a small 4-billion-parameter version, but you can switch to a larger or different one from inside the tool. The project is at an early stage with no stars. The README is focused on usage and setup, with no contribution guide or license information mentioned.

Copy-paste prompts

Prompt 1
Help me install Ollama, FluidSynth, and vibetune to generate my first track.
Prompt 2
Generate a lofi study beat with jazzy chords using vibetune and explain the commands.
Prompt 3
Show me how to trim and loop a generated track back to its beginning.
Prompt 4
Walk me through creating and saving a preset for a vibe description I like.

Frequently asked questions

What is vibetune?

A command-line tool that turns a text mood description into a generated MIDI background music track using a local language model.

What language is vibetune written in?

Mainly Python. The stack also includes Python, Ollama, FluidSynth.

How hard is vibetune to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vibetune for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.