README.md

metadata

title: SpotMaster V1.0
emoji: 🏢
colorFrom: indigo
colorTo: gray
sdk: gradio
sdk_version: 5.13.2
app_file: app.py
pinned: false
license: apache-2.0
short_description: Creates full commercial from a simple prompt

SpotMaker

SpotMaker to aplikacja do automatycznego generowania spotów reklamowych na podstawie opisu koncepcji. Wykorzystuje zaawansowane modele AI do tworzenia scenariuszy, generowania wideo i audio.

🎯 Funkcjonalności

• Generowanie szczegółowego scenariusza (shooting board) z opisu koncepcji
• Automatyczne tworzenie ujęć wideo na podstawie scenariusza
• Generowanie profesjonalnego głosu lektora
• Montaż finalnego spotu reklamowego
• Szczegółowe logowanie procesu i obsługa błędów

🛠️ Wymagania techniczne

API Keys

• Hailuo API Key
• GroupID (dostępne w tokenie JWT)

Środowisko

• Python 3.8+
• Dostęp do internetu
• Około 2GB wolnej przestrzeni dyskowej na pliki tymczasowe

📂 Struktura projektu

spot_maker/
├── app.py                 # Główna aplikacja GUI
├── requirements.txt       # Zależności
├── .env                  # Konfiguracja
├── utils/
│   ├── __init__.py
│   ├── logger.py         # System logowania
│   └── file_handler.py   # Obsługa plików
├── core/
│   ├── __init__.py
│   ├── shooting_board.py # Generator scenariusza
│   ├── video_gen.py      # Generator wideo
│   ├── audio_gen.py      # Generator audio
│   └── video_editor.py   # System montażu
└── tests/                # Testy jednostkowe

🚀 Instalacja i uruchomienie

1. Sklonuj repozytorium:

git clone <repository-url>
cd spot_maker

2. Zainstaluj zależności:

pip install -r requirements.txt

3. Skonfiguruj plik .env:

HAILUO_API_KEY=your_api_key
GROUP_ID=your_group_id

4. Uruchom aplikację:

python app.py

💡 Jak używać

1. Wprowadź koncepcję reklamową

   • Wpisz krótki opis koncepcji lub
   • Załaduj plik w formacie .txt/.doc(x)

2. Generowanie

   • Kliknij przycisk "Start"
   • Monitoruj postęp w pasku postępu
   • Sprawdzaj szczegółowe logi

3. Pobieranie

   • Po zakończeniu generowania, pobierz gotowy spot

🔄 Przepływ pracy

1. Analiza koncepcji i generowanie scenariusza przez LLM
2. Tworzenie 5 kluczowych ujęć wideo
3. Generowanie ścieżki dźwiękowej lektora
4. Montaż finalnego spotu
5. Dostosowanie długości ujęć do narracji

⚠️ Znane ograniczenia

• Maksymalna długość opisu koncepcji: 2000 znaków
• Limit 5 ujęć w spocie
• Czas generowania: 3-15 minut
• Wymagane stałe połączenie internetowe

🛟 Rozwiązywanie problemów

Jeśli napotkasz problemy:

1. Sprawdź logi w katalogu logs/
2. Upewnij się, że API keys są poprawne
3. Sprawdź połączenie internetowe
4. Zweryfikuj format danych wejściowych

📝 Licencja

Ten projekt jest udostępniony na licencji Apache 2.0.

📧 Kontakt

Jeśli masz pytania lub sugestie, zapraszam do kontaktu: staniszewski@heuristica.pl