LibreAI / AI Music / suno-api
// ai-music · gcui-art/suno-api

suno-api

Use API to call the music generation AI of suno.ai, and easily integrate it into agents like GPTs.

★ 3.2k stars⑂ 917 forksLGPL-3.0updated 2026-03
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

suno-api is an open-source ai music project by gcui-art (gcui-art/suno-api on GitHub). It has 3,250 GitHub stars and 917 forks, is released under the LGPL-3.0 license, and was last updated on GitHub on 6 March 2026.

GitHub stars
3,250
Forks
917
License
LGPL-3.0
Last updated on GitHub
6 March 2026
Category
AI Music
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Choose creation or library

    Generate new music with AI, or self-host the collection you already own.

  2. Install the app

    Desktop, mobile, and server builds cover every listening setup.

  3. Add models or music

    AI tools download models; players just need your files.

  4. Create or listen

    Generate tracks, or stream your library anywhere.

// features

Why people love it

Made for music

Workflows tuned for musicians and producers, not generic audio.

Type-safe codebase

Written in TypeScript, which means fewer runtime surprises and easier contributions.

Stem separation

Split any track into vocals, drums, bass, and more.

AI composition

Generate melodies, arrangements, and full songs from prompts.

Multi-room

Sync playback across devices and rooms.

Scrobbling & stats

Listening history and stats without the surveillance.

Advertisement
// run it

Run it yourself

  1. Step 1 — Clone the repo

    Download the source and move into the project folder.

    git clone https://github.com/gcui-art/suno-api.git
    cd suno-api
  2. Step 2 — Check the README

    Every project documents its own setup; start with install requirements.

    cat README.md | head -60
  3. Step 3 — Run it

    Follow the project's launch command — Docker, pip, npm, or a binary release.

    # see README for the exact launch command
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains suno-api?

It is an open-source project at gcui-art/suno-api with 917 forks. Check the repo's contributors and recent commits to see how active maintenance is.

Is suno-api free for commercial use?

Licensed under LGPL-3.0 — check the repo for commercial-use terms.

Can it replace Spotify?

For your own files, yes — discovery and podcasts are the gaps.

Do I need a server?

For personal use a Raspberry Pi or old laptop is plenty.

What audio quality do self-hosted players support?

FLAC/lossless is standard; transcoding covers mobile bandwidth.

// keep exploring

Similar tools

AI Music

xcodec

AAAI 2025: Codec Does Matter: Exploring the Semantic Shortcoming of Codec for Audio Language Model

★ 316 starsMIT
View guide →
AI Music

audio-ai-hub

The hub for audio AI research: papers, open models, benchmarks & datasets across audio LLMs, speech recognition, TTS, music & audio generation.

★ 960 starsUnknown
View guide →
AI Music

HeartMuLa_ComfyUI

ComfyUI Custom Node for HeartMuLa AI Music Generation and Transcript Text

★ 435 starsApache-2.0
View guide →
AI Music

SunoMCP

MCP server that brings Suno music generation into your AI agent.

★ 61 starsMIT
View guide →
AI Music

doubao2api

Reverse-engineered Doubao (豆包) API → OpenAI-compatible REST service. Free multimodal chat, image/video/music generation, and file hosting for AI agents.

★ 258 starsApache-2.0
View guide →
AI Music

HeartMuLa-Studio

Suno-like music generation studio for HeartMuLa/heartlib - AI-powered music creation with reference audio style transfer

★ 640 starsUnknown
View guide →
// alternatives

Alternatives in AI Music

The most-starred other AI Music projects in the LibreAI catalogue — the realistic shortlist if suno-api is not the right fit.

Get suno-api

Free and open — grab the source, star the repo, and start creating.