diff --git a/ct/kima-hub.sh b/ct/kima-hub.sh new file mode 100644 index 000000000..f8c96b818 --- /dev/null +++ b/ct/kima-hub.sh @@ -0,0 +1,79 @@ +#!/usr/bin/env bash +source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVED/main/misc/build.func) +# Copyright (c) 2021-2026 community-scripts ORG +# Author: MickLesk (CanbiZ) +# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE +# Source: https://github.com/Chevron7Locked/kima-hub + +APP="Kima-Hub" +var_tags="${var_tags:-music;streaming;media}" +var_cpu="${var_cpu:-4}" +var_ram="${var_ram:-8192}" +var_disk="${var_disk:-16}" +var_os="${var_os:-debian}" +var_version="${var_version:-13}" +var_unprivileged="${var_unprivileged:-1}" + +header_info "$APP" +variables +color +catch_errors + +function update_script() { + header_info + check_container_storage + check_container_resources + + if [[ ! -d /opt/kima-hub ]]; then + msg_error "No ${APP} Installation Found!" + exit + fi + + if check_for_gh_release "kima-hub" "Chevron7Locked/kima-hub"; then + msg_info "Stopping Services" + systemctl stop kima-frontend kima-backend kima-analyzer kima-analyzer-clap 2>/dev/null || true + msg_ok "Stopped Services" + + msg_info "Backing up Data" + cp /opt/kima-hub/backend/.env /opt/kima-hub-backend-env.bak 2>/dev/null || true + cp /opt/kima-hub/frontend/.env /opt/kima-hub-frontend-env.bak 2>/dev/null || true + msg_ok "Backed up Data" + + CLEAN_INSTALL=1 fetch_and_deploy_gh_release "kima-hub" "Chevron7Locked/kima-hub" "tarball" + + msg_info "Restoring Data" + cp /opt/kima-hub-backend-env.bak /opt/kima-hub/backend/.env 2>/dev/null || true + cp /opt/kima-hub-frontend-env.bak /opt/kima-hub/frontend/.env 2>/dev/null || true + rm -f /opt/kima-hub-backend-env.bak /opt/kima-hub-frontend-env.bak + msg_ok "Restored Data" + + msg_info "Rebuilding Backend" + cd /opt/kima-hub/backend + $STD npm install + $STD npm run build + $STD npx prisma generate + $STD npx prisma migrate deploy + msg_ok "Rebuilt Backend" + + msg_info "Rebuilding Frontend" + cd /opt/kima-hub/frontend + $STD npm install + $STD npm run build + msg_ok "Rebuilt Frontend" + + msg_info "Starting Services" + systemctl start kima-backend kima-frontend kima-analyzer kima-analyzer-clap + msg_ok "Started Services" + msg_ok "Updated successfully!" + fi + exit +} + +start +build_container +description + +msg_ok "Completed Successfully!\n" +echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}" +echo -e "${INFO}${YW} Access it using the following URL:${CL}" +echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:3030${CL}" diff --git a/frontend/public/json/kima-hub.json b/frontend/public/json/kima-hub.json new file mode 100644 index 000000000..a0b11ee68 --- /dev/null +++ b/frontend/public/json/kima-hub.json @@ -0,0 +1,48 @@ +{ + "name": "Kima-Hub", + "slug": "kima-hub", + "categories": [ + 13 + ], + "date_created": "2026-02-20", + "type": "ct", + "updateable": true, + "privileged": false, + "interface_port": 3030, + "documentation": "https://github.com/Chevron7Locked/kima-hub#readme", + "website": "https://github.com/Chevron7Locked/kima-hub", + "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/kima-hub.webp", + "config_path": "/opt/kima-hub/backend/.env", + "description": "Self-hosted, on-demand audio streaming platform with AI-powered vibe matching, mood detection, smart playlists, and Lidarr/Audiobookshelf integration.", + "install_methods": [ + { + "type": "default", + "script": "ct/kima-hub.sh", + "resources": { + "cpu": 4, + "ram": 8192, + "hdd": 16, + "os": "Debian", + "version": "13" + } + } + ], + "default_credentials": { + "username": null, + "password": null + }, + "notes": [ + { + "text": "First user to register becomes the administrator.", + "type": "info" + }, + { + "text": "Mount your music library to /music in the container.", + "type": "warning" + }, + { + "text": "Audio analysis (mood/vibe detection) requires significant RAM (2-4GB per worker).", + "type": "info" + } + ] +} \ No newline at end of file diff --git a/install/kima-hub-install.sh b/install/kima-hub-install.sh new file mode 100644 index 000000000..6f2eee958 --- /dev/null +++ b/install/kima-hub-install.sh @@ -0,0 +1,215 @@ +#!/usr/bin/env bash + +# Copyright (c) 2021-2026 community-scripts ORG +# Author: MickLesk (CanbiZ) +# License: MIT | https://github.com/community-scripts/ProxmoxVED/raw/main/LICENSE +# Source: https://github.com/Chevron7Locked/kima-hub + +source /dev/stdin <<<"$FUNCTIONS_FILE_PATH" +color +verb_ip6 +catch_errors +setting_up_container +network_check +update_os + +msg_info "Installing Dependencies" +$STD apt-get install -y \ + build-essential \ + git \ + openssl \ + ffmpeg \ + python3 \ + python3-pip \ + python3-dev \ + python3-numpy \ + redis-server +msg_ok "Installed Dependencies" + +PG_VERSION="16" PG_MODULES="pgvector" setup_postgresql +PG_DB_NAME="kima" PG_DB_USER="kima" setup_postgresql_db + +NODE_VERSION="20" setup_nodejs + +msg_info "Configuring Redis" +systemctl enable -q --now redis-server +msg_ok "Configured Redis" + +fetch_and_deploy_gh_release "kima-hub" "Chevron7Locked/kima-hub" "tarball" + +msg_info "Installing Python Dependencies" +export PIP_BREAK_SYSTEM_PACKAGES=1 +$STD pip3 install --no-cache-dir \ + 'tensorflow>=2.13.0,<2.16.0' \ + essentia-tensorflow \ + redis \ + psycopg2-binary \ + 'laion-clap>=1.1.4' \ + 'torch>=2.0.0' \ + 'torchaudio>=2.0.0' \ + 'librosa>=0.10.0' \ + 'transformers>=4.30.0' \ + 'pgvector>=0.2.0' \ + 'python-dotenv>=1.0.0' \ + 'requests>=2.31.0' +msg_ok "Installed Python Dependencies" + +msg_info "Downloading Essentia ML Models" +mkdir -p /opt/kima-hub/models +cd /opt/kima-hub/models +curl -fsSL -o msd-musicnn-1.pb "https://essentia.upf.edu/models/autotagging/msd/msd-musicnn-1.pb" +curl -fsSL -o mood_happy-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/mood_happy/mood_happy-msd-musicnn-1.pb" +curl -fsSL -o mood_sad-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/mood_sad/mood_sad-msd-musicnn-1.pb" +curl -fsSL -o mood_relaxed-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/mood_relaxed/mood_relaxed-msd-musicnn-1.pb" +curl -fsSL -o mood_aggressive-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/mood_aggressive/mood_aggressive-msd-musicnn-1.pb" +curl -fsSL -o mood_party-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/mood_party/mood_party-msd-musicnn-1.pb" +curl -fsSL -o mood_acoustic-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/mood_acoustic/mood_acoustic-msd-musicnn-1.pb" +curl -fsSL -o mood_electronic-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/mood_electronic/mood_electronic-msd-musicnn-1.pb" +curl -fsSL -o danceability-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/danceability/danceability-msd-musicnn-1.pb" +curl -fsSL -o voice_instrumental-msd-musicnn-1.pb "https://essentia.upf.edu/models/classification-heads/voice_instrumental/voice_instrumental-msd-musicnn-1.pb" +msg_ok "Downloaded Essentia ML Models" + +msg_info "Downloading CLAP Model" +curl -fsSL -o /opt/kima-hub/models/music_audioset_epoch_15_esc_90.14.pt \ + "https://huggingface.co/lukewys/laion_clap/resolve/main/music_audioset_epoch_15_esc_90.14.pt" +msg_ok "Downloaded CLAP Model" + +msg_info "Building Backend" +cd /opt/kima-hub/backend +$STD npm ci +$STD npm run build +msg_ok "Built Backend" + +msg_info "Configuring Backend" +SESSION_SECRET=$(openssl rand -hex 32) +ENCRYPTION_KEY=$(openssl rand -hex 32) +cat </opt/kima-hub/backend/.env +NODE_ENV=production +DATABASE_URL=postgresql://${PG_DB_USER}:${PG_DB_PASS}@localhost:5432/${PG_DB_NAME} +REDIS_URL=redis://localhost:6379 +PORT=3006 +MUSIC_PATH=/music +TRANSCODE_CACHE_PATH=/opt/kima-hub/cache/transcodes +SESSION_SECRET=${SESSION_SECRET} +SETTINGS_ENCRYPTION_KEY=${ENCRYPTION_KEY} +INTERNAL_API_SECRET=$(openssl rand -hex 16) +EOF +msg_ok "Configured Backend" + +msg_info "Running Database Migrations" +cd /opt/kima-hub/backend +$STD npx prisma generate +$STD npx prisma migrate deploy +msg_ok "Ran Database Migrations" + +msg_info "Building Frontend" +cd /opt/kima-hub/frontend +$STD npm ci +export NEXT_PUBLIC_BACKEND_URL=http://127.0.0.1:3006 +$STD npm run build +msg_ok "Built Frontend" + +msg_info "Configuring Frontend" +cat </opt/kima-hub/frontend/.env +NODE_ENV=production +BACKEND_URL=http://localhost:3006 +PORT=3030 +EOF +msg_ok "Configured Frontend" + +msg_info "Creating Directories" +mkdir -p /opt/kima-hub/cache/transcodes +mkdir -p /music +msg_ok "Created Directories" + +msg_info "Creating Services" +cat </etc/systemd/system/kima-backend.service +[Unit] +Description=Kima Hub Backend +After=network.target postgresql.service redis-server.service +Wants=postgresql.service redis-server.service + +[Service] +Type=simple +User=root +WorkingDirectory=/opt/kima-hub/backend +EnvironmentFile=/opt/kima-hub/backend/.env +ExecStart=/usr/bin/node /opt/kima-hub/backend/dist/index.js +Restart=on-failure +RestartSec=5 + +[Install] +WantedBy=multi-user.target +EOF + +cat </etc/systemd/system/kima-frontend.service +[Unit] +Description=Kima Hub Frontend +After=network.target kima-backend.service + +[Service] +Type=simple +User=root +WorkingDirectory=/opt/kima-hub/frontend +EnvironmentFile=/opt/kima-hub/frontend/.env +ExecStart=/usr/bin/npm start +Restart=on-failure +RestartSec=5 + +[Install] +WantedBy=multi-user.target +EOF + +cat </etc/systemd/system/kima-analyzer.service +[Unit] +Description=Kima Hub Audio Analyzer (Essentia) +After=network.target postgresql.service redis-server.service kima-backend.service + +[Service] +Type=simple +User=root +WorkingDirectory=/opt/kima-hub/services/audio-analyzer +Environment=DATABASE_URL=postgresql://${PG_DB_USER}:${PG_DB_PASS}@localhost:5432/${PG_DB_NAME} +Environment=REDIS_URL=redis://localhost:6379 +Environment=MUSIC_PATH=/music +Environment=BATCH_SIZE=10 +Environment=SLEEP_INTERVAL=5 +Environment=NUM_WORKERS=2 +Environment=THREADS_PER_WORKER=1 +ExecStart=/usr/bin/python3 /opt/kima-hub/services/audio-analyzer/analyzer.py +Restart=on-failure +RestartSec=10 + +[Install] +WantedBy=multi-user.target +EOF + +cat </etc/systemd/system/kima-analyzer-clap.service +[Unit] +Description=Kima Hub CLAP Audio Analyzer +After=network.target postgresql.service redis-server.service kima-backend.service kima-analyzer.service + +[Service] +Type=simple +User=root +WorkingDirectory=/opt/kima-hub/services/audio-analyzer-clap +Environment=DATABASE_URL=postgresql://${PG_DB_USER}:${PG_DB_PASS}@localhost:5432/${PG_DB_NAME} +Environment=REDIS_URL=redis://localhost:6379 +Environment=BACKEND_URL=http://localhost:3006 +Environment=MUSIC_PATH=/music +Environment=SLEEP_INTERVAL=5 +Environment=NUM_WORKERS=1 +ExecStart=/usr/bin/python3 /opt/kima-hub/services/audio-analyzer-clap/analyzer.py +Restart=on-failure +RestartSec=10 + +[Install] +WantedBy=multi-user.target +EOF + +systemctl enable -q --now kima-backend kima-frontend kima-analyzer kima-analyzer-clap +msg_ok "Created Services" + +motd_ssh +customize +cleanup_lxc diff --git a/misc/data/telemetry-service b/misc/data/telemetry-service deleted file mode 100755 index 58f5f7179..000000000 Binary files a/misc/data/telemetry-service and /dev/null differ