Merge pull request #31 from GlebkaF/add-chain-generator

Add chain generator

Author: GlebkaF

.cursor/mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "/Users/skyeng/.nvm/versions/node/v22.14.0/bin/npx",
+      "args": ["@playwright/mcp@latest"],
+      "env": {
+        "PATH": "/Users/skyeng/.nvm/versions/node/v22.14.0/bin:/usr/local/bin:/usr/bin:/bin"
+      }
+    }
+  }
+}

.gitignore

@@ -3,3 +3,4 @@ node_modules
 coverage
 out
 tsconfig.tsbuildinfo
+.env.local

README.md

@@ -2,12 +2,66 @@
 
 This is a tool to generate Nux Mp3 presets from a JSON file.
 
+## 🎸 AI Chain Generator
+
+Новая функция для генерации чейнов эффектов с помощью AI! Доступна по адресу `/generator`.
+
+### Как использовать:
+
+1. Откройте страницу `/generator`
+2. Введите описание желаемого звука (например: "Тяжелый металлический звук с дисторшном")
+3. Нажмите "Сгенерировать Chain" или Enter
+4. Получите QR код для импорта в NUX приложение
+
+### Настройка OpenAI (опционально):
+
+Для включения AI генерации добавьте ваш OpenAI API ключ:
+
+1. Создайте файл `.env.local` в корне проекта
+2. Добавьте ваш API ключ:
+
+```
+OPENAI_API_KEY=your_openai_api_key_here
+```
+
+3. Перезапустите сервер разработки
+
+**Без API ключа**: Приложение будет возвращать default chain для всех запросов.
+**С API ключом**: Chain будет генерироваться на основе вашего описания с помощью GPT-4o-mini (по умолчанию).
+
+Доступные модели:
+
+- `gpt-4o-mini` (по умолчанию) - быстрая и экономичная
+- `gpt-4o` - самая новая и умная модель
+- `gpt-4-turbo` - баланс между качеством и скоростью
+- `gpt-3.5-turbo` - базовая модель
+
+### Настройка прокси (если нужно):
+
+Если OpenAI API недоступен в вашем регионе, можно использовать прокси:
+
+```
+PROXY_URL=http://your-proxy-server:port
+```
+
+По умолчанию используется встроенный прокси Skyeng.
+
 ## Usage
 
+### Для локальной разработки (с поддержкой API Routes):
+
 ```bash
 npm run dev
 ```
 
+### Для статической сборки (GitHub Pages):
+
+```bash
+npm run build:static
+```
+
+**Важно**: API Routes (включая генератор Chain) работают только в режиме разработки. Для production на GitHub Pages используется статическая генерация без API.
+
 ## Best practices
 
 ### Тестирование

components/Header.js

@@ -1,12 +1,43 @@
 import Link from "next/link";
+import { useRouter } from "next/router";
 
 export default function Header() {
+  const router = useRouter();
+
+  const isActive = (path) => router.pathname === path;
+
   return (
     <header className="bg-gray-900 text-gray-100 p-4 mb-8">
       <nav className="container mx-auto flex items-center gap-6">
         <Link href="/" className="text-xl font-bold">
           MightyPatch
         </Link>
+        <div className="flex gap-4 ml-auto">
+          <Link
+            href="/"
+            className={`hover:text-blue-400 transition-colors ${
+              isActive("/") ? "text-blue-400 font-medium" : ""
+            }`}
+          >
+            Редактор
+          </Link>
+          <Link
+            href="/generator"
+            className={`hover:text-purple-400 transition-colors ${
+              isActive("/generator") ? "text-purple-400 font-medium" : ""
+            }`}
+          >
+            AI Генератор
+          </Link>
+          <Link
+            href="/test-encoder"
+            className={`hover:text-green-400 transition-colors ${
+              isActive("/test-encoder") ? "text-green-400 font-medium" : ""
+            }`}
+          >
+            Тестовый энкодер
+          </Link>
+        </div>
       </nav>
     </header>
   );

env.example

@@ -0,0 +1,13 @@
+# OpenAI API Configuration
+# Copy this file to .env.local and add your API key
+
+# Get your API key from https://platform.openai.com/api-keys
+OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+PROXY_URL=http://
+
+# Optional: Use a different model (default is gpt-4o-mini)
+# OPENAI_MODEL=gpt-4o
+# OPENAI_MODEL=gpt-4-turbo
+# OPENAI_MODEL=gpt-3.5-turbo
+
+# Note: Without API key, the generator will return a default chain for all prompts

lib/ai-generator/prompt/1. examle dont-cry.json

@@ -0,0 +1,11 @@
+{
+  "genre": "Classic Rock Ballad",
+  "sound_description": "Warm, rich, and expressive clean tone with a slight sparkle for the intro and verses; thick yet singing lead for solos; dynamic response to pick attack; moderate brightness and smooth sustain; present depth and gentle ambience.",
+  "guitar_rig_description": "Noise gate: not used (signal is clean/low-gain). Compressor: used gently at the front for smooth sustain and even response, especially for arpeggiated parts. Overdrive/Distortion/Boost: overdrive pedal used as a light boost for solos to add sustain and mild grit; otherwise bypassed for clean parts. Amplifier: clean channel of a vintage-style tube amp for lush cleans, switched to lead channel or boosted for solos. Cabinet: 2x12 open-back cab emulation for airy, full-bodied tone. EQ: used post-amp to trim excess lows and shape mids for clarity. Modulation: chorus pedal used subtly in intro and clean sections for width; off during solos. Delay: analog-style delay with short repeats added in solos for depth and space. Reverb: plate or hall reverb used sparingly throughout for lush ambience, slightly increased in solos.",
+  "references": [
+    "Guns N' Roses - Don't Cry",
+    "Slash - Live in Tokyo '92 (Don't Cry)",
+    "Guns N' Roses - Use Your Illusion I"
+  ],
+  "additional_info": "Neck or middle pickup (often Slash's neck humbucker for solos, both pickups for intro/clean parts); Slash typically uses Les Paul-style guitars with medium-gauge strings; expressive bends and vibrato are key; volume and tone knob manipulation can help achieve dynamics."
+}

lib/ai-generator/prompt/1. examle master main riff.json

@@ -0,0 +1,11 @@
+{
+  "genre": "Thrash Metal",
+  "sound_description": "Sharp, aggressive, tight, palm-muted chug, mid-scooped, high-gain with clarity and strong attack.",
+  "guitar_rig_description": "Noise Gate: Used to eliminate unwanted noise and keep palm-muted riffing tight. Compressor: Not used, as dynamics are largely controlled by the player's right hand attack. Overdrive/Distortion/Boost: Classic mid-gain overdrive pedal (TS-style) used as a boost in front of a high-gain amplifier for added tightness and definition, not for primary distortion. Amplifier: High-gain tube amp head (Mesa/Boogie style) provides the main saturated distortion with an aggressive and tight character. Cabinet: 4x12 closed-back cabinet with Celestion speakers emulates the punch and articulation of the original recording. EQ: Graphic or amp EQ with scooped mids, accentuated lows and highs to match 80s thrash tones. Modulation: Not used. Delay: Not used. Reverb: Not used, or minimal to dry; tone is focused and direct, as on the original recording.",
+  "references": [
+    "Metallica - Master of Puppets",
+    "Metallica - Battery",
+    "Slayer - Raining Blood"
+  ],
+  "additional_info": "Use the bridge humbucker pickup for maximum output and aggressive palm mute attack. Heavier gauge strings recommended (10-46 or higher), tuned to standard E. Downpicking technique is essential for authentic attack and articulation."
+}

lib/ai-generator/prompt/1. raw-to-structured.md

@@ -0,0 +1,19 @@
+You are an experienced guitar technician and live sound engineer who can dial in any guitar tone. You will receive a free-form description of the desired sound (it may be incomplete or vague). Your task is to return a strictly structured JSON with a technical description of the tone, as if you were preparing a real live rig and explicitly naming all effect blocks used. If information is missing, fill in the gaps based on common solutions for that genre or style.
+
+Important for downstream processing:
+
+1. Always mention each effect block explicitly in guitar_rig_description if it’s used: noise gate, compressor, overdrive/distortion/boost, amplifier, cabinet, EQ, modulation, delay, reverb.
+2. If a block is not needed, clearly state it’s not used in the description.
+3. Describe each block’s role and tonal intent, but without numeric values.
+
+Example json output:
+
+```
+{
+  "genre": "Music genre / style, clearly defined",
+  "sound_description": "Key tone characteristics: aggressiveness, thickness, attack, brightness, depth, dynamics",
+  "guitar_rig_description": "Explicitly list all effect blocks in signal chain order, with a short functional description for each; if unused, say 'not used'",
+  "references": ["Example band or song 1", "Example band or song 2", "Example band or song 3"],
+  "additional_info": "Any other useful details (pickup choice, playing technique, string gauge, etc.)"
+}
+```

lib/ai-generator/prompt/2. example don-cry.json

@@ -0,0 +1,72 @@
+{
+  "pedalboard": [
+    "Keeley Compressor Plus",
+    "Boss SD-1 Super OverDrive",
+    "Boss CE-2W Chorus",
+    "Strymon El Capistan dTape Echo",
+    "Boss EQ-200 Graphic Equalizer",
+    "Strymon BlueSky Reverberator"
+  ],
+  "amplifier": "Marshall JCM Slash Signature AFD100",
+  "cabinet": "Marshall 1936 2x12 with Celestion G12T-75 speakers (open-back mod or open-back reissue)",
+  "settings": {
+    "amp": {
+      "channel": "Clean for intro/verses (Input 1), Lead channel or boosted for solos",
+      "gain": {
+        "clean": 4,
+        "lead": 7
+      },
+      "bass": 5,
+      "middle": 6,
+      "treble": 7,
+      "presence": 6,
+      "master": 4,
+      "masterNote": "adjust for venue/room"
+    },
+    "compressor": {
+      "sustain": "9 o'clock (light/medium)",
+      "level": "Match unity",
+      "blend": 50,
+      "attack": "Fast (10–11 o'clock)"
+    },
+    "overdrive": {
+      "drive": "8–9 o'clock (very mild for boost)",
+      "tone": "11 o'clock (neutral, just a touch of sparkle)",
+      "level": "2 o'clock (to boost solos)"
+    },
+    "chorus": {
+      "rate": "9 o'clock (slow)",
+      "depth": "10 o'clock (subtle)",
+      "level": "Match unity (not too prominent; off for solos)"
+    },
+    "delay": {
+      "time": 380,
+      "timeUnit": "ms",
+      "repeats": "2–3",
+      "mix": 20,
+      "mixNote": "low, for ambience in solos only; off in cleans"
+    },
+    "eq": {
+      "80Hz": -3,
+      "250Hz": 0,
+      "800Hz": 1,
+      "1.6kHz": 2,
+      "4kHz": 2,
+      "8kHz": -1,
+      "unit": "dB"
+    },
+    "reverb": {
+      "type": "Plate",
+      "typeNote": "switch to Hall for more space in solos",
+      "mix": {
+        "intro": 15,
+        "solos": 22
+      },
+      "decay": {
+        "intro": 1.8,
+        "solos": 2.4
+      },
+      "decayUnit": "s"
+    }
+  }
+}

lib/ai-generator/prompt/2. example master main riff.json

@@ -0,0 +1,37 @@
+{
+  "pedalboard": [
+    "ISP Decimator II Noise Gate",
+    "Ibanez TS808 Tube Screamer (used as a boost)",
+    "MXR 10-Band EQ (for mid scoop and shaping lows/highs)"
+  ],
+  "amplifier": "Mesa/Boogie Mark IV",
+  "cabinet": "Mesa/Boogie 4x12 Rectifier Standard with Celestion Vintage 30 speakers",
+  "settings": {
+    "amp": {
+      "Gain": 7,
+      "Bass": 7,
+      "Middle": 3,
+      "Treble": 7,
+      "Presence": 6,
+      "Master": 5
+    },
+    "ts808": {
+      "Drive": 3,
+      "Tone": 6,
+      "Level": 7
+    },
+    "eq": {
+      "100Hz": "+3dB",
+      "250Hz": "-4dB",
+      "500Hz": "-5dB",
+      "1kHz": "-5dB",
+      "2kHz": "-4dB",
+      "4kHz": "+4dB",
+      "8kHz": "+4dB",
+      "16kHz": "+2dB"
+    },
+    "noise_gate": {
+      "Threshold": "Set to reduce hum but preserve palm-muted attack"
+    }
+  }
+}