From 256edbdf67b19bc757c6cd860cfc11958fa986f3 Mon Sep 17 00:00:00 2001 From: fspecii Date: Wed, 4 Feb 2026 03:17:01 +0200 Subject: [PATCH] SEO optimization: Add Suno alternative keywords, social links, and contribution encouragement --- README.md | 305 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 159 insertions(+), 146 deletions(-) diff --git a/README.md b/README.md index 9963a9c..93fbb0b 100644 --- a/README.md +++ b/README.md @@ -5,36 +5,75 @@

ACE-Step UI

- A professional, local-first music generation studio for ACE-Step 1.5 + The Ultimate Open Source Suno Alternative
+ Seamless integration with ACE-Step 1.5 - The Open Source AI Music Generation Model

- Features • - Demo • - Installation • - Usage • - Configuration • - Credits + + Subscribe on YouTube + + + Follow on X + +

+ +

+ Why ACE-Step • + Features • + Demo • + Installation • + Usage • + Contributing

React - Express TypeScript TailwindCSS - SQLite + SQLite License + Stars

--- -## Demo +## 🚀 Why ACE-Step UI? + +**Tired of paying $10+/month for Suno or Udio?** ACE-Step 1.5 is the **open source Suno killer** that runs locally on your own GPU - and ACE-Step UI gives you a **beautiful, professional interface** to harness its full power. + +| Feature | Suno/Udio | ACE-Step UI | +|---------|-----------|-------------| +| **Cost** | $10-50/month | **FREE forever** | +| **Privacy** | Cloud-based | **100% local** | +| **Ownership** | Licensed | **You own everything** | +| **Customization** | Limited | **Full control** | +| **Queue Limits** | Restricted | **Unlimited** | +| **Commercial Use** | Expensive tiers | **No restrictions** | + +### What Makes ACE-Step 1.5 Special? + +- **State-of-the-art quality** rivaling commercial services +- **Full song generation** up to 4+ minutes with vocals +- **Runs locally** - no internet required after setup +- **Open source** - inspect, modify, improve +- **Active development** - constant improvements + +--- + +## 🎬 Demo

- ACE-Step UI Preview + ACE-Step UI - Open Source Suno Alternative

-## Features +

+ Generate professional AI music with a Spotify-like interface - 100% free and local +

+ +--- + +## ✨ Features ### 🎵 AI Music Generation | Feature | Description | @@ -81,7 +120,9 @@ | **Video Generator** | Create music videos with Pexels backgrounds | | **Gradient Covers** | Beautiful procedural album art (no internet needed) | -## Tech Stack +--- + +## 💻 Tech Stack | Layer | Technologies | |-------|-------------| @@ -90,7 +131,9 @@ | **AI Engine** | [ACE-Step 1.5](https://github.com/ace-step/ACE-Step) | | **Audio Tools** | AudioMass, Demucs, FFmpeg | -## Requirements +--- + +## 📋 Requirements | Requirement | Specification | |-------------|---------------| @@ -100,7 +143,9 @@ | **FFmpeg** | For audio processing | | **uv** | Python package manager (recommended) | -## Quick Start +--- + +## ⚡ Quick Start ```bash # 1. Start ACE-Step API (in ACE-Step directory) @@ -112,14 +157,16 @@ cd ace-step-ui ./start.sh ``` -Open **http://localhost:3000** +Open **http://localhost:3000** and start creating! -## Installation +--- -### 1. Install ACE-Step +## 📦 Installation + +### 1. Install ACE-Step (The AI Engine) ```bash -# Clone ACE-Step +# Clone ACE-Step - the open source Suno alternative git clone https://github.com/ace-step/ACE-Step cd ACE-Step @@ -131,18 +178,18 @@ uv pip install -e . cd .. ``` -### 2. Install ACE-Step UI +### 2. Install ACE-Step UI (This Repository) ```bash -# Clone this repository +# Clone the UI git clone https://github.com/fspecii/ace-step-ui cd ace-step-ui -# Run setup script +# Run setup script (installs all dependencies) ./setup.sh ``` -**Or manually:** +**Or install manually:** ```bash # Install frontend dependencies @@ -157,7 +204,9 @@ cd .. cp server/.env.example server/.env ``` -## Usage +--- + +## 🎮 Usage ### Step 1: Start ACE-Step API Server @@ -175,175 +224,92 @@ cd ace-step-ui ./start.sh ``` -**Or manually in two terminals:** +### Step 3: Create Music! -```bash -# Terminal 1 - Backend -cd server && npm run dev - -# Terminal 2 - Frontend -npm run dev -``` - -### Step 3: Open the UI - -| Mode | URL | -|------|-----| +| Access | URL | +|--------|-----| | Local | http://localhost:3000 | -| LAN | http://YOUR_IP:3000 | +| LAN (other devices) | http://YOUR_IP:3000 | -On first launch, you'll be asked to set a username. This is stored locally. +--- -## Configuration - -### Environment Variables +## ⚙️ Configuration Edit `server/.env`: ```env # Server PORT=3001 -NODE_ENV=development -# ACE-Step API +# ACE-Step API (seamless integration) ACESTEP_API_URL=http://localhost:8001 -# Database +# Database (local-first, no cloud) DATABASE_PATH=./data/acestep.db -# Storage -AUDIO_DIR=./public/audio - # Optional: Pexels API for video backgrounds PEXELS_API_KEY=your_key_here ``` -### LAN Access +--- -ACE-Step UI automatically supports LAN access. Start the servers and access from any device: - -1. Find your computer's IP: `hostname -I` (Linux) or `ipconfig` (Windows) -2. Open `http://YOUR_IP:3000` on any device - -## Generation Modes +## 🎼 Generation Modes ### Simple Mode -Enter a description of the music you want. The AI handles the rest. +Just describe what you want. ACE-Step handles the rest. + +> "An upbeat pop song about summer adventures with catchy hooks" ### Custom Mode -Fine-tune every parameter: +Full control over every parameter: | Parameter | Description | |-----------|-------------| -| **Title** | Song title | -| **Lyrics** | Full lyrics with structure tags `[Verse]`, `[Chorus]`, etc. | -| **Style** | Genre, mood, instruments, tempo descriptors | +| **Lyrics** | Full lyrics with `[Verse]`, `[Chorus]` tags | +| **Style** | Genre, mood, instruments, tempo | | **Duration** | 30-240 seconds | | **BPM** | 60-200 beats per minute | | **Key** | Musical key (C major, A minor, etc.) | -| **Time Signature** | 4/4, 3/4, 6/8, etc. | -### Advanced Settings +--- -| Setting | Description | -|---------|-------------| -| **Inference Steps** | Higher = better quality, slower (default: 60) | -| **Guidance Scale** | Prompt adherence strength (default: 15) | -| **Batch Size** | Number of variations to generate | -| **Thinking Mode** | AI prompt enhancement | -| **Random Seed** | For reproducible results | +## 🔧 Built-in Tools -## Built-in Tools +| Tool | Description | +|------|-------------| +| **🎚️ Audio Editor** | Cut, trim, fade, and apply effects | +| **🎤 Stem Extraction** | Separate vocals, drums, bass, other | +| **🎬 Video Generator** | Create music videos with stock footage | +| **🎨 Album Art** | Auto-generated gradient covers | -### Audio Editor -Click the edit icon on any song to open AudioMass: -- Cut, copy, paste audio -- Apply fades and effects -- Export in multiple formats +--- -### Stem Extraction -Separate any song into: -- 🎤 Vocals -- 🥁 Drums -- 🎸 Bass -- 🎹 Other instruments - -### Video Generator -Create music videos with: -- Pexels stock footage (requires API key) -- Gradient animations -- Lyrics overlay -- Album art display - -## Troubleshooting +## 🐛 Troubleshooting | Issue | Solution | |-------|----------| | **ACE-Step API not reachable** | Ensure `uv run acestep-api --port 8001` is running | -| **CUDA out of memory** | Close other GPU apps, reduce duration/batch size | +| **CUDA out of memory** | Close other GPU apps, reduce duration | | **Songs show 0:00 duration** | Install FFmpeg: `sudo apt install ffmpeg` | | **LAN access not working** | Check firewall allows ports 3000 and 3001 | -| **Liked songs not saving** | Refresh page, check browser console for errors | -## Project Structure +--- -``` -ace-step-ui/ -├── components/ # React components -│ ├── CreatePanel.tsx # Main generation form -│ ├── Player.tsx # Bottom audio player -│ ├── LibraryView.tsx # Song library -│ └── ... -├── server/ -│ ├── src/ -│ │ ├── routes/ # API endpoints -│ │ ├── services/ # Business logic -│ │ └── db/ # SQLite database -│ ├── public/ -│ │ ├── audio/ # Generated audio files -│ │ └── demucs-web/ # Stem extraction UI -│ └── audio-editor/ # AudioMass editor -├── services/ # Frontend API client -├── context/ # React context providers -└── docs/ # Documentation & assets -``` +## 🤝 Contributing -## API Endpoints +**We need your help to make ACE-Step UI even better!** -| Method | Endpoint | Description | -|--------|----------|-------------| -| `POST` | `/api/generate` | Start music generation | -| `GET` | `/api/generate/status/:id` | Get job status | -| `GET` | `/api/songs` | Get user's songs | -| `POST` | `/api/songs/:id/like` | Toggle like | -| `GET` | `/api/playlists` | Get playlists | -| `POST` | `/api/playlists` | Create playlist | +This is a community-driven project and contributions are what make open source amazing. Whether you're fixing bugs, adding features, improving documentation, or sharing ideas - every contribution counts! -## Development +### Ways to Contribute -```bash -# Development mode with hot reload -./start.sh +- 🐛 **Report bugs** - Found an issue? Open a GitHub issue +- 💡 **Suggest features** - Have an idea? We'd love to hear it +- 🔧 **Submit PRs** - Code contributions are always welcome +- 📖 **Improve docs** - Help others get started +- ⭐ **Star the repo** - Show your support! -# Build for production -npm run build -cd server && npm run build -``` - -## Credits - -- **[ACE-Step](https://github.com/ace-step/ACE-Step)** - AI music generation model -- **[AudioMass](https://github.com/pkalogiros/AudioMass)** - Web audio editor -- **[Demucs](https://github.com/facebookresearch/demucs)** - Audio source separation -- **[Pexels](https://www.pexels.com)** - Stock video backgrounds - -## License - -This project is open source under the [MIT License](LICENSE). - -## Contributing - -Contributions are welcome! Please feel free to: +### How to Contribute 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/amazing-feature`) @@ -353,6 +319,53 @@ Contributions are welcome! Please feel free to: --- +## 📣 Stay Connected +

- Made with ❤️ for the open-source AI music community + + YouTube + +

+ +

+ + X/Twitter + +

+ +

+ Subscribe and follow for:
+ 🎥 Video tutorials and demos
+ 🚀 New feature announcements
+ 💡 Tips and tricks
+ 🎵 AI music generation news +

+ +--- + +## 🙏 Credits + +- **[ACE-Step](https://github.com/ace-step/ACE-Step)** - The revolutionary open source AI music generation model +- **[AudioMass](https://github.com/pkalogiros/AudioMass)** - Web audio editor +- **[Demucs](https://github.com/facebookresearch/demucs)** - Audio source separation +- **[Pexels](https://www.pexels.com)** - Stock video backgrounds + +--- + +## 📄 License + +This project is open source under the [MIT License](LICENSE). + +--- + +

+ ⭐ If ACE-Step UI helps you create amazing music, please star this repo! ⭐ +

+ +

+ Made with ❤️ for the open-source AI music community +

+ +

+ Stop paying for Suno. Start creating with ACE-Step.