[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1899":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":41,"readmeContent":42,"aiSummary":43,"trendingCount":16,"starSnapshotCount":16,"syncStatus":44,"lastSyncTime":45,"discoverSource":46},1899,"ACE-Step-Studio","timoncool\u002FACE-Step-Studio","timoncool","Portable AI music generator — full songs with vocals, covers, music videos. One-click install, 100% offline, NVIDIA GPU.","https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio\u002Freleases",null,"Python",190,22,5,12,0,9,10,38,27,4.09,"MIT License",false,"master",true,[27,28,29,30,31,32,33,34,35,36,37,38,39,40],"ace-step","ai-music","gradio","local-ai","lyrics","music-generation","music-video","offline","one-click-install","portable","pytorch","text-to-music","vocals","windows","2026-06-12 02:00:34","\u003Cdiv align=\"center\">\n\n# ACE-Step Studio\n\n**Suno at home. Local AI music generation studio — songs, vocals, lyrics, covers, music videos.**\n\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ftimoncool\u002FACE-Step-Studio?style=flat-square)](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio\u002Fstargazers)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Ftimoncool\u002FACE-Step-Studio?style=flat-square)](LICENSE)\n[![Last Commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Ftimoncool\u002FACE-Step-Studio?style=flat-square)](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio\u002Fcommits\u002Fmaster)\n[![Downloads](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Ftimoncool\u002FACE-Step-Studio\u002Ftotal?style=flat-square)](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio\u002Freleases)\n\n**[Русская версия](README_RU.md)**\n\n![ACE-Step Studio](docs\u002Fscreenshots\u002Fmain-ui.png)\n\n\u003C\u002Fdiv>\n\nCreate full songs with vocals, lyrics, covers, remixes and music videos — **100% local**, no cloud, no subscriptions, no internet required. One-click install on Windows, runs on any NVIDIA GPU with 12+ GB VRAM.\n\nBuilt on [ACE-Step 1.5 XL](https:\u002F\u002Fgithub.com\u002Face-step\u002FACE-Step-1.5) — the open-source 4B parameter DiT music generation model.\n\n## Why ACE-Step Studio?\n\n- **Free forever** — no API keys, no credits, no usage limits\n- **Private** — your music never leaves your machine\n- **Portable** — everything in one folder, copy to USB, delete = uninstall\n- **One-click** — `install.bat` → `run.bat` → make music\n\n## Features\n\n### Music Generation\n- **Full songs with vocals** — up to 8 minutes, any language, any genre\n- **Simple & Custom modes** — describe what you want or fine-tune every parameter\n- **3 XL Models** — XL Turbo (8 steps, fast), XL SFT (50 steps, max quality), XL Turbo BF16 (compact, 7.5 GB)\n- **AI Lyrics & Style** — LLM generates lyrics and enriches style descriptions\n- **Hot Model Switching** — change DiT\u002FLM models without restart\n- **Batch generation** — create multiple variations at once\n- **10 samplers, 7 schedulers** — euler, heun, midpoint, dopri5, deis, ipndm, and more\n- **LoRA support** — load LoRA weights at inference time\n- **ID3 tags** — MP3 files include title, artist, cover art, lyrics, BPM\n\n### Cloud LLM & Image (optional, off by default)\n- **OpenRouter for lyrics & style** — bring-your-own-key alternative to the local LM. Pick any model (Claude, GPT-4o, DeepSeek, Llama 3.x, etc.), get instant lyrics + caption + key\u002FBPM\u002Fduration metadata without using GPU VRAM. Local LM keeps working in parallel — toggle anytime.\n- **Pollinations.ai cover generation** — auto-generate album covers in parallel with audio (server-side, fire-and-forget, never blocks audio gen). The visual prompt comes straight from the OpenRouter LLM (which writes a 1–2 sentence visual description tailored to the song's lyrics and mood) or from a keyword fallback. Anonymous tier works; bring your own token for higher rate limits and no watermark.\n- **Manual cover regen modal** — picture-with-pencil button on every track. Pick any Pollinations model, write your own prompt, \"Try again\" until you like it, **or upload your own image from disk** (JPEG\u002FPNG\u002FWEBP, ≤10MB). Saved cover replaces both `songs.cover_url` and the embedded ID3 frame inside the MP3, so external players see your picked image too.\n- **Independent toggles** — every cloud feature is opt-in. Use only Pollinations covers + local LM, or only OpenRouter lyrics + auto-picsum covers, or both, or neither. Local-only mode is the default.\n\n### Cover & Remix\n- **Cover mode** — transform existing audio into a new style while keeping the melody\n- **Repaint mode** — regenerate specific sections of a song (region selection on waveform)\n- **Reference audio** — use a reference track to guide the generation style\n- **Audio strength control** — blend between source and generated audio\n\n### Video Studio\n\n![Video Studio](docs\u002Fscreenshots\u002Fvideo-studio.png)\n\n- **Music video generator** — NCS-style visualizers with 10 presets\n- **Karaoke lyrics** — synchronized LRC subtitles with 3 styles (lines, scroll, karaoke fill)\n- **WYSIWYG editor** — drag elements, scroll to resize, selection frames\n- **Aspect ratios** — 16:9, 9:16 (Reels\u002FTikTok), 1:1 (Instagram)\n- **12 effects** — shake, glitch, VHS, CCTV, scanlines, bloom, film grain, strobe, vignette, hue shift, letterbox, pixelate\n- **Background** — random, custom image, Pexels search, video backgrounds\n- **Server-side rendering** — native ffmpeg with NVENC GPU acceleration\n\n### Audio Tools\n- **Audio editor** — trim, fade, effects (AudioMass)\n- **Stem extraction** — separate vocals, drums, bass, other (Demucs)\n- **LRC download** — export synchronized lyrics\n\n### Model Tools\n- **BF16 Converter** — convert safetensors from FP32\u002FFP16 to BFloat16 (~50% size reduction)\n- **Model Merger** — merge two ACE-Step models with adjustable alpha (3 methods)\n- **Bake LoRA** — bake LoRA weights into base model\n\n### Interface\n- **Single terminal** — one `run.bat`, Express manages Python\u002FGradio automatically\n- **Portable** — everything in one folder, no system-wide installs\n- **5 languages** — English, Russian, Chinese, Japanese, Korean\n- **LAN access** — use from any device on your network (phone, tablet)\n- **GPU monitoring** — live VRAM, RAM, CPU, temperature stats\n- **Dark\u002FLight theme**\n\n## System Requirements\n\n| Component | Minimum | Recommended |\n|-----------|---------|-------------|\n| GPU VRAM | 12 GB | 20+ GB |\n| RAM | 16 GB | 32 GB |\n| Disk | 30 GB | 60 GB (all models) |\n| OS | Windows 10\u002F11 | Windows 11 |\n| GPU | RTX 3060+ | RTX 4090 |\n\n## Quick Start\n\n> 🚀 **One-click cross-platform install via Pinokio:** [![Install on Pinokio](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall_on-Pinokio-7c3aed?style=flat-square)](https:\u002F\u002Fpinokio.co\u002Fitem?uri=https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio-pinokio) [![Open in Pinokio](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpen_in-Pinokio-6d28d9?style=flat-square)](https:\u002F\u002Fbeta.pinokio.co\u002Fapps\u002Fgithub-com-timoncool-ace-step-studio-pinokio)\n>\n> Works on Windows \u002F Linux (x64 & aarch64) \u002F macOS (Apple Silicon & Intel). No `install.bat` required — Pinokio bundles Python, Node, ffmpeg, venv and picks the right PyTorch build for your GPU automatically.\n>\n> Pinokio launcher repo: **[timoncool\u002FACE-Step-Studio-pinokio](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio-pinokio)**\n\n---\n\nOr install manually on Windows:\n\n### 1. Clone\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio.git\ncd ACE-Step-Studio\n```\n\n### 2. Install\n\n```\ninstall.bat\n```\n\nSelect your GPU type (CUDA 12.8 \u002F 12.6 \u002F 12.4). Installs portable Python 3.12, PyTorch, Node.js 22, and all dependencies — nothing system-wide.\n\n### 3. Run\n\n```\nrun.bat\n```\n\nBrowser opens automatically at http:\u002F\u002Flocalhost:3001. Models download on first run (~7.5 GB for default BF16 model).\n\n## Launchers\n\n| Script | Description |\n|--------|-------------|\n| `run.bat` | Standard launch — DiT + LM (0.6B PT), full features |\n| `run-no-lm.bat` | Launch without LM — more VRAM for DiT, cover\u002Frepaint work, no AI lyrics\u002Fthinking |\n| `run-dev.bat` | Dev mode — 3 terminals with Vite HMR |\n| `install.bat` | One-click installer |\n| `update.bat` | Update code + deps + rebuild frontend |\n| `reinstall.bat` | Clean reinstall (preserves models and data) |\n| `download_model.bat` | Pre-download models |\n\n## Models\n\n| Model | Size | Steps | Speed | Quality |\n|-------|------|-------|-------|---------|\n| XL Turbo BF16 | 7.5 GB | 8 | Fast | High |\n| XL Turbo | 18.8 GB | 8 | Fast | Very High |\n| XL SFT | 18.8 GB | 50 | Slow | Highest |\n| XL Merge SFT+Turbo | 18.8 GB | 12 | Medium | Very High |\n\n### LM Models (text\u002Flyrics AI)\n\n| Model | VRAM | Quality |\n|-------|------|---------|\n| 0.6B | ~0.5 GB | Basic |\n| 1.7B | ~1.5 GB | Good |\n| 4B | ~4 GB | Best |\n\nLM backend: **PT** (PyTorch, lighter) or **vLLM** (faster inference, more VRAM).\n\n## API Keys (optional)\n\nACE-Step Studio is fully usable **without any API keys** — local DiT + local LM cover everything music-generation related. The keys below unlock optional cloud services that some users prefer for convenience or quality. They are stored in browser `localStorage` only, never sent to any server but the provider's own.\n\n> **TL;DR — both providers can be used 100 % free.**\n> OpenRouter has dozens of completely free models you can pick (DeepSeek R1 free, Llama 3.3 70B free, Gemini 2.0 Flash free, Qwen 2.5 free, Mistral Small free…) — just create a key and choose any model with a `:free` tag.\n> Pollinations.ai works **without any account at all** on the anonymous tier (slower, occasional watermark on some models) — leave the key field blank and it just works.\n\n| Provider | What it does in the app | Where to get it | Free tier |\n|---|---|---|---|\n| **OpenRouter** | Generates lyrics + caption + BPM\u002Fkey\u002Fduration metadata + a visual cover prompt from your one-line description (replaces the local LM). Lets you pick Claude \u002F GPT-4o \u002F DeepSeek \u002F Llama \u002F Mistral \u002F Gemini \u002F any of 200+ models. | [openrouter.ai\u002Fkeys](https:\u002F\u002Fopenrouter.ai\u002Fkeys) — sign in with Google\u002FGitHub, click *Create Key*. | **Yes — many fully free models** (filter the model picker by `:free`): DeepSeek R1 free, Llama 3.3 70B Instruct free, Gemini 2.0 Flash free, Qwen 2.5 free, Mistral Small 3 free, and more. Paid models are pay-per-token from your wallet — no monthly subscription required. |\n| **Pollinations.ai** | Generates the album cover image in parallel with audio gen, plus powers the manual cover-regen modal. Token also unlocks the full image-model catalogue (FLUX, Qwen-Image, Klein, GPT-Image, Z-Image, …) and removes the watermark. | [auth.pollinations.ai](https:\u002F\u002Fauth.pollinations.ai) — sign in, copy `pk_…` (public) or `sk_…` (private) key. | **Yes — fully free**, anonymous tier works without any account or key. Slower (1 req\u002F15 s) and may have a small watermark on certain models. With a free token: 1 req\u002F5 s + no watermark + full model list. |\n\n### Where to enter them\n\n- **OpenRouter** → Create panel → Advanced → toggle *\"Use OpenRouter\"* → paste key, pick model, *Test*.\n- **Pollinations** → Create panel → Advanced → *Cover image (Pollinations.ai)* → toggle *\"Generate covers via Pollinations.ai\"* → paste key (optional), pick model, *Test*.\n\nBoth toggles persist across sessions and are independent — turn either one off to fall back to the local pipeline (LM for lyrics, picsum for covers).\n\n### How private is this?\n\n- Keys live only in your browser's `localStorage` for this site.\n- They are sent **only** to `openrouter.ai` \u002F `gen.pollinations.ai` over HTTPS, attached to that single API call. ACE-Step Studio does not have a backend account, telemetry, or proxy server.\n- Cover images you generate are written to `app\u002Fserver\u002Fpublic\u002Faudio\u002F\u003CuserId>\u002Fcovers\u002F\u003CsongId>.jpg` on your machine. Nothing is uploaded anywhere.\n- If you don't want any cloud calls, simply leave both toggles off — the entire app works offline.\n\n## Architecture\n\n```\nACE-Step-Studio\u002F\n├── app\u002F              # React + Express frontend & backend\n├── ACE-Step-1.5\u002F     # Python ML pipeline\n├── python\u002F           # Portable Python 3.12 (created by install.bat)\n├── node\u002F             # Portable Node.js 22 (created by install.bat)\n├── models\u002F           # HuggingFace cache (created at runtime)\n├── run.bat           # Standard launcher\n├── run-no-lm.bat     # Launch without LM\n├── install.bat       # One-click installer\n├── update.bat        # Updater\n└── CHANGELOG.md      # Version history\n```\n\n## Updating\n\n```\nupdate.bat\n```\n\nPulls latest code, updates Python\u002FNode deps, rebuilds frontend.\n\n## Contributing\n\nContributions welcome! Here's how to help:\n\n- **Report bugs** — [open an issue](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio\u002Fissues)\n- **Suggest features** — [start a discussion](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FACE-Step-Studio\u002Fissues)\n- **Submit PRs** — see [AGENTS.md](AGENTS.md) for architecture, coding conventions, and pitfalls\n\nAreas where help is especially needed:\n- macOS \u002F Linux support\n- New visualizer presets for Video Studio\n- Translations (i18n)\n- LoRA training UI improvements\n- Documentation & tutorials\n\n## Other Portable Neural Networks\n\n| Project | Description |\n|---------|-------------|\n| [Foundation Music Lab](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FFoundation-Music-Lab) | Music generation + timeline editor |\n| [VibeVoice ASR](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FVibeVoice_ASR_portable_ru) | Speech recognition (ASR) |\n| [LavaSR](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FLavaSR_portable_ru) | Audio quality enhancement |\n| [Qwen3-TTS](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FQwen3-TTS_portable_rus) | Text-to-speech by Qwen |\n| [SuperCaption Qwen3-VL](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FSuperCaption_Qwen3-VL) | Image captioning |\n| [VideoSOS](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002Fvideosos) | AI video production |\n| [RC Stable Audio Tools](https:\u002F\u002Fgithub.com\u002Ftimoncool\u002FRC-stable-audio-tools-portable) | Music and audio generation |\n\n## Authors\n\n- **Nerual Dreming** — [Telegram](https:\u002F\u002Ft.me\u002Fnerual_dreming) | [neuro-cartel.com](https:\u002F\u002Fneuro-cartel.com) | [ArtGeneration.me](https:\u002F\u002Fartgeneration.me)\n- **Neiro-Soft** — [Telegram](https:\u002F\u002Ft.me\u002Fneuroport) | portable neural network builds\n\n## Acknowledgments\n\n- **[ACE-Step Team](https:\u002F\u002Fgithub.com\u002Face-step)** — open source ACE-Step 1.5 music generation model\n- **[fspecii](https:\u002F\u002Fgithub.com\u002Ffspecii\u002Face-step-ui)** — original ACE-Step UI\n- [AudioMass](https:\u002F\u002Faudiomass.co\u002F) — browser audio editor\n- [Demucs](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Fdemucs) — stem extraction by Meta\n- [Pexels](https:\u002F\u002Fwww.pexels.com\u002F) — free stock photos\u002Fvideos\n- [Gradio](https:\u002F\u002Fgradio.app\u002F) — ML model serving\n- [FFmpeg](https:\u002F\u002Fffmpeg.org\u002F) — video encoding\n\n## Support This Project\n\nI build software and do research in AI and music generation. Most of what I create is free and open source. Your donations allow me to keep creating and exploring without worrying about where the next meal comes from =)\n\n**[All donation methods](DONATE.md)** | **[dalink.to\u002Fnerual_dreming](https:\u002F\u002Fdalink.to\u002Fnerual_dreming)** | **[boosty.to\u002Fneuro_art](https:\u002F\u002Fboosty.to\u002Fneuro_art)**\n\n- **BTC:** `1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC`\n- **ETH (ERC20):** `0xb5db65adf478983186d4897ba92fe2c25c594a0c`\n- **USDT (TRC20):** `TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C`\n\n---\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=timoncool%2FACE-Step-Studio&type=date&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=timoncool\u002FACE-Step-Studio&type=date&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=timoncool\u002FACE-Step-Studio&type=date&legend=top-left\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=timoncool\u002FACE-Step-Studio&type=date&legend=top-left\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n","ACE-Step Studio 是一个便携式的AI音乐生成工具，能够离线生成完整的歌曲、歌词、翻唱和音乐视频。其核心功能包括基于ACE-Step 1.5 XL模型的全曲目生成（最长8分钟），支持多种语言和风格，并提供简单模式和自定义模式以满足不同需求。此外，它还具备多模型切换、批量生成以及丰富的采样器选项等特性。该软件完全本地化运行，无需联网，适用于NVIDIA GPU且至少需要12GB显存。特别适合追求隐私保护、希望在无网络环境下创作音乐的专业人士和个人用户使用。",2,"2026-06-11 02:46:42","CREATED_QUERY"]