🎹 Professional AI-Powered MIDI Generation Desktop Application
Create beautiful MIDI compositions with AI assistance
🎼 The Next Generation of AI Music Creation
MuseCraft Studio is a professional desktop application built with Electron, React 19, and TypeScript that combines AI music generation with intuitive MIDI editing. It provides a seamless workflow from AI model management to professional MIDI composition.
🎹 Modern Piano Roll Editor with canvas-based rendering and smooth interactions
🤖 AI-Powered Generation with real-time WebSocket updates and progress tracking
🎛️ Professional Parameter Controls for fine-tuned musical expression
⚡ Real-Time Playback synced perfectly with MIDI timeline
📤 High-Quality MIDI Export with embedded velocity and pitch data
🌐 Cross-Platform Support for Windows, Linux, and macOS
🔧 Model Management Hub with automatic discovery and loading
🎨 Beautiful UI/UX with animated interfaces and modern design
🎯 No Installation Required - Just Download & Run!
Note: The desktop app runs without installation, but AI features require the MuseCraftEngine backend running locally.
🚨 Critical Requirement for AI Features
Before using MuseCraft Studio's AI features, you MUST set up and run the MuseCraftEngine backend
# 1. Clone the engine
git clone https://github.com/WebChatAppAi/MuseCraftEngine.git
cd MuseCraftEngine
# 2. Install PyTorch for your system (CUDA/CPU/MPS)
# NVIDIA GPU: pip install torch --index-url https://download.pytorch.org/whl/cu118
# Apple Silicon: pip install torch
# CPU Only: pip install torch --index-url https://download.pytorch.org/whl/cpu
# 3. Install dependencies
pip install -r requirements.txt
# 4. Download AI models from HuggingFace
# Visit: https://huggingface.co/projectlosangeles/MuseCraft/tree/main
# Download .pth files and place them in: ./data/models/
# 5. Start the engine
python main.py✅ Verify engine is running: Visit http://localhost:8899/docs
Prerequisites
- Node.js 18+ and pnpm (recommended) or npm
- MuseCraftEngine Backend running on
http://localhost:8899⬆️ - Git for cloning the repository
Install and Run Studio
# 1. Clone the repository
git clone https://github.com/WebChatAppAi/MuseCraft-Studio.git
cd MuseCraft-Studio
# 2. Install dependencies
pnpm install
# or: npm install --legacy-peer-deps
# 3. Start the application (ensure engine is running on localhost:8899)
pnpm dev
- ✅ MuseCraftEngine running on http://localhost:8899
- ✅ AI models downloaded from HuggingFace
- ✅ Models placed in
MuseCraftEngine/data/models/directory
The application opens to the Quantum Landing page with a beautiful animated welcome interface.
Click "AI Setup" in the sidebar to access the model management hub:
- Test Backend Connection: Verify MuseCraftEngine is running on localhost:8899
- Discover Models: Automatically scan for available AI models from your engine
- Load Model: Select and load your preferred model into memory
- Monitor Status: Real-time WebSocket updates show model loading progress
Navigate to "Piano Roll" to enter the main composition workspace:
- Grid Area: Visual MIDI note representation with canvas-based rendering
- Piano Keyboard: Left sidebar with note names and octave navigation
- Timeline: Top ruler showing measures, beats, and time positions
- AI Toolbar: Right panel with generation controls and parameters
- Velocity Lane: Bottom area for editing note dynamics
- Configure AI Parameters: Set creativity level, note count, and musical style
- Click "Generate": AI creates notes based on your parameters
- Real-time Updates: Watch generation progress via WebSocket notifications
- Edit Results: Refine generated notes using the professional editor tools
- Generate initial musical ideas and themes
- Explore new harmonic progressions
- Break through creative blocks
- Create backing tracks and accompaniments
- Generate rhythm patterns and bass lines
- Develop melodic hooks and riffs
- Practice with AI-generated exercises
- Explore different musical styles
- Learn from AI-created patterns
- Study music theory through AI examples
- Analyze generated compositions
- Experiment with different musical concepts
- 🚀 MuseCraftEngine - AI backend server (REQUIRED for AI features)
- 🤖 AI Models - Pre-trained models from HuggingFace
- 📘 Complete Usage Guide - Detailed interface guide and creative workflows
- 📋 Technical Documentation - Architecture details and API reference
- 🛠️ Contributing Guide - How to contribute to MuseCraft development
Remember: MuseCraft Studio is the frontend interface
For AI music generation, you need:
- 🔧 MuseCraftEngine running on localhost:8899
- 📥 AI models downloaded and placed in engine's data/models/ folder
- ✅ Connection verified through Studio's AI Setup page
🎹 Join the MuseCraft Community
Share your creations with #MuseCraftStudio on social media!
Featured compositions get highlighted in our 🌟 Showcase Wiki
- 📖 Read the technical guide: docs/technical.md
- 🔧 Explore the modern TypeScript architecture and React 19 components
- 🍴 Fork → 🛠️ Build features → 📬 Open a Pull Request
- 🎨 Design new UI components or enhance existing workflows
- 🤖 Contribute to AI model integrations and generation algorithms
Non-Commercial Software License © Jonas
This project is licensed under a custom Non-Commercial Software License. See the LICENSE file in the root directory for complete license details.
- ✅ Personal Use: You may use and modify this software for personal and non-commercial purposes
- ❌ Commercial Restriction: Commercial use is strictly prohibited without explicit permission from Jonas
- 📧 Distribution Notice: You must notify the copyright holder of any distribution or modification
- 🔄 Related Projects: This license also applies to the MuseCraftEngine backend and related components
🏛️ Note: This software inherits the same licensing terms as the original MIDI Gen project
🎹✨ MuseCraft Studio - Where AI meets professional music production
Made with ❤️ for the AI music community
The README now has consistent alignment, professional structure, and attractive visual presentation throughout!