# bsgen: a free, open-source AI map generator for Beat Saber

> bsgen is a free, open-source AI tool that generates Beat Saber maps from an MP3, with difficulty and star rating controls.

- Published: 2026-10-26T04:21:43Z
- Score: 7/10
- Tags: vr, ai, tool
- Port / platforms: - -> PC (Windows), Browser (Tool)
- Web page: https://emu-radar.customfw.xyz/news/bsgen-free-open-source-ai-beat-saber-map-generator/
- Sources: https://www.reddit.com/r/virtualreality/comments/1xf9lyp/bsgen_a_free_opensource_ai_map_generator_for_beat/

A free, open-source AI tool called bsgen can now generate Beat Saber maps from an MP3 file. The project is on [GitHub](https://github.com/cata02222/bsgen) under the AGPL-3.0 license. It runs on its own model, bsgen-1.0, which has 65 million parameters.

The Reddit poster says a map takes under two minutes and covers every difficulty from Easy to Expert+. You can also set an exact star rating from 1 to 15 or pick a style. The README calls the project experimental. The sources don't show how the maps play in the headset.

There are two ways in. The easiest is the Google Colab notebook linked from the repo: run both cells, open the link, and drop in your song. To run it on your own PC, you need Python 3.10+ and ffmpeg. Then:

1. `git clone https://github.com/cata02222/bsgen`
2. `cd bsgen`
3. `pip install -e .`
4. `python scripts/webui.py`

Then open the web page the script starts and load your MP3.
