- Python 3.8+
- pip
- git
# Clone repository
git clone https://github.com/slauger/suno-cli.git
cd suno-cli
# Create virtual environment
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# Install package
pip install -e .Get your API key from sunoapi.org.
Option 1: Config File (Recommended)
suno init-config
nano ~/.suno-cli/config.yaml # Add your API keyOption 2: Environment Variable
export SUNO_API_KEY=your-key-here
# Make it permanent
echo 'export SUNO_API_KEY=your-key-here' >> ~/.zshrc
source ~/.zshrcsuno --version
suno --help# Install Python (if needed)
brew install python3
# Then follow standard install steps above# Install Python
sudo apt update
sudo apt install python3 python3-pip python3-venv
# Then follow standard install steps above# Install Python from python.org (check "Add to PATH")
# Then in PowerShell:
python -m venv venv
venv\Scripts\activate
pip install -e .Command not found:
# Make sure venv is activated
source venv/bin/activate
# Reinstall
pip uninstall suno-cli
pip install -e .Old pip version:
pip install --upgrade pip
pip install -e .See Usage Guide for examples.