⚠️ Alpha Release Notice: This is an early alpha release. Expect bugs, breaking changes, and incomplete features. Not recommended for production use.

Flutter-Step is a cross-platform Flutter rebuild of ACE-Step-1.5, providing a modern desktop UI for AI-powered music generation.

This project is a complete rewrite of the ACE-Step-1.5 web interface into a native Flutter desktop application. While the core music generation is handled by the ACE-Step backend, Flutter-Step provides:

• Native desktop experience — macOS, Windows, and Linux apps
• Improved UX — Responsive UI designed for music production workflows
• Offline-capable — No browser required, runs locally with embedded backend

• Text to Music — Generate original music from text descriptions
• Remix/Cover — Transform existing tracks with AI style transfer
• Repaint — Edit specific sections of audio while preserving the rest
• Extract — Isolate individual tracks (vocals, drums, bass, etc.)
• Lego — Add missing tracks to existing multi-track audio
• Complete — Generate missing tracks for incomplete arrangements

• Inference Steps — Tune generation quality vs. speed
• Guidance Scale — Control prompt adherence
• Batch Size — Generate multiple variations at once
• Thinking (CoT) — Enable chain-of-thought reasoning for better results
• BPM, Key, Time Signature — Set precise musical parameters
• Duration — Generate clips from 5 seconds to 60 minutes

• Random Sampling — Get inspired with AI-generated prompts
• Prompt Enhancement — Let the LM refine your descriptions
• Lyrics Support — Include lyrics for singing/songwriting
• History — Browse and re-download past generations
• Studio — Advanced multi-track audio workstation
• Model Manager — Download and manage ACE-Step models

Flutter-Step requires the ACE-Step 1.5 backend for music generation:

• Python 3.10+
• CUDA-compatible GPU (for GPU acceleration)
• 8GB+ VRAM recommended for full functionality
• 16GB+ system RAM

The app will automatically download and configure ACE-Step on first launch.

Download the latest release for your platform from the Releases page.

# Clone the repository
git clone https://github.com/flutter-step/flutter-step.git
cd flutter-step

# Install Flutter dependencies
flutter pub get

# Run the app
flutter run -d macos

# macOS
flutter build macos

# Windows
flutter build windows

# Linux
flutter build linux

1. First Launch — The app will guide you through ACE-Step backend setup
2. Start Server — Click "Start Server" on the Generate page
3. Write a Prompt — Describe the music you want to create
4. Adjust Settings — Set BPM, duration, inference steps, etc.
5. Generate — Click the Generate button and wait for your music

┌─────────────────────────────────────────────────────────────┐
│                    Flutter-Step (Flutter)                    │
├─────────────────────────────────────────────────────────────┤
│  Generate Page  │  History  │  Studio  │  Settings          │
├─────────────────────────────────────────────────────────────┤
│                  Services (Dart)                             │
│  GenerationService │ StorageService │ AceStepService        │
└─────────────────────────────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────┐
│                    ACE-Step Backend (Python)                 │
├─────────────────────────────────────────────────────────────┤
│  DiT Model │ LM Model │ VAE │ Diffusion │ Audio Process   │
└─────────────────────────────────────────────────────────────┘

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

See LICENSE for the full license text.

• You are free to use, modify, and distribute this software
• If you modify and distribute this software, you must release your modifications under AGPL-3.0
• If you run a modified version of this software on a network server, you must make the source code available
• Commercial use is allowed under the terms of AGPL-3.0

Contributions are welcome! Please read our contributing guidelines before submitting pull requests.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• ACE-Step-1.5 — The original music generation engine this project is built upon
• Flutter — Cross-platform UI toolkit
• All contributors and beta testers

• Issues — Report bugs and request features via GitHub Issues
• Discussions — Ask questions and share ideas

Flutter-Step — AI Music Generation for Everyone
Built with Flutter · Powered by ACE-Step