v3

DEPLOY_HF.md

@@ -1,79 +0,0 @@
-# Deploying to HuggingFace Spaces
-
-## Step-by-Step Guide
-
-### 1. Create a New Space
-
-1. Go to [HuggingFace Spaces](https://huggingface.co/spaces)
-2. Click "Create new Space"
-3. Fill in:
-   - **Space name**: `ai-radio` (or your preferred name)
-   - **SDK**: Select **Gradio**
-   - **Hardware**: CPU (or GPU if available)
-   - **Visibility**: Public or Private
-
-### 2. Configure Secrets
-
-After creating the Space, go to **Settings → Secrets** and add:
-
-| Secret Name | Value | Required |
-|------------|-------|----------|
-| `ELEVENLABS_API_KEY` | Your ElevenLabs API key | ✅ Yes |
-| `NEBIUS_API_KEY` | Your Nebius API key | ✅ Yes |
-| `LLAMAINDEX_API_KEY` | Your LlamaIndex API key | ⚠️ Optional |
-| `OPENAI_API_KEY` | Your OpenAI API key (for embeddings fallback) | ⚠️ Optional |
-
-### 3. Push Your Code
-
-You can either:
-
-**Option A: Git Push**
-```bash
-git remote add hf https://huggingface.co/spaces/<your-username>/<space-name>
-git push hf main
-```
-
-**Option B: Upload via Web UI**
-- Go to your Space page
-- Click "Files and versions"
-- Upload all files from your local `ai_radio` directory
-
-### 4. Required Files
-
-Make sure these files are in your Space repository:
-
-- ✅ `app.py` - Entry point (already created)
-- ✅ `requirements.txt` - Dependencies
-- ✅ `README.md` - Space description
-- ✅ `src/` - Source code directory
-- ✅ `.gitignore` - Git ignore rules
-
-### 5. Verify Deployment
-
-1. Check the **Logs** tab in your Space
-2. Wait for the build to complete
-3. The app should be available at: `https://huggingface.co/spaces/<your-username>/<space-name>`
-
-## Troubleshooting
-
-### Build Fails
-- Check that `requirements.txt` has all dependencies
-- Verify Python version compatibility (3.9+)
-- Check logs for specific error messages
-
-### App Doesn't Start
-- Verify all required secrets are set
-- Check that `app.py` is at the root level
-- Ensure port is set to 7860 (HF Spaces default)
-
-### API Errors
-- Double-check that API keys are correctly set as secrets
-- Verify API keys are valid and have sufficient credits/quota
-
-## Notes
-
-- The app uses port 7860 by default on HF Spaces (configured in `app.py`)
-- Audio files are stored temporarily in `audio/` directory
-- User data persists in `user_memory.json` and `user_data.json`
-- Logs are available in the Space's Logs tab
-

README.md

@@ -1,27 +1,16 @@
----
 title: AI Radio - Personalized Radio Station
 emoji: 🎵
 colorFrom: purple
 colorTo: pink
 sdk: gradio
-sdk_version: 4.44.0
+sdk_version: 4.44.1
 app_file: app.py
 pinned: false
 license: mit
+short_description: Entertaining AI Radio with LLM as a Host
 tags:
-  - mcp
   - mcp-in-action-track-consumer
-  - hackathon
-  - ai
-  - radio
-  - music
-  - nebius
-  - gpt-oss-120b
-  - elevenlabs
-  - llamaindex
-  - rag
-  - autonomous-agent
----
+  - mcp-in-action-track-creative
 
 # 🎵 AI Radio - Your Personal Radio Station
 
@@ -31,6 +20,28 @@ tags:
 
 **AI Radio** is an intelligent, personalized radio station powered by cutting-edge AI technology. It creates a unique listening experience tailored to your preferences, mood, and interests. Built for the **MCP 1st Birthday Competition**, this app demonstrates autonomous agent behavior, MCP integration, and advanced RAG capabilities.
 
+## 🦾 Participants
+https://huggingface.co/nikimakarov
+
+## 🛠️ Technology Stack
+
+- **Gradio**: Interactive web interface
+- **OpenAI GPT-OSS-120B provided by Nebius** : LLM for content generation, host commentary, and reasoning
+- **ElevenLabs**: High-quality text-to-speech for voice generation
+- **LlamaIndex**: RAG system for personalized recommendations and user preference management
+- **MCP (Model Context Protocol)**: Structured tool servers for modular functionality
+- **Python**: Core application logic
+- **RSS Feeds**: Real-time news aggregation
+
+## 🙏 Acknowledgments
+
+- **Gradio Team** for the beautiful UI framework
+- **MCP Team** for the amazing protocol and competition
+- **OpenAI** for creating GPT-OSS-120B
+- **Nebius** for providing models API
+- **ElevenLabs** for text-to-speech technology
+- **LlamaIndex** for RAG capabilities
+
 ## 📁 Project Structure
 
 ```
@@ -86,7 +97,7 @@ ai_radio/
 
 This app fulfills all requirements for **Track 2: MCP in Action**:
 
-✅ **Autonomous Agent Behavior**: The RadioAgent demonstrates planning (show planning), reasoning (segment selection based on preferences), and execution (content generation and delivery)
+✅ **Autonomous Agent Behavior**: The Radio Agent demonstrates planning (show planning), reasoning (segment selection based on preferences), and execution (content generation and delivery)
 
 ✅ **MCP Servers as Tools**: Implements three MCP servers:
 - **MusicMCPServer**: Music search and playlist generation
@@ -100,15 +111,6 @@ This app fulfills all requirements for **Track 2: MCP in Action**:
 - **Context Engineering**: Personalizes content based on user preferences and history
 - **Streaming Capabilities**: Efficient audio generation and playback
 
-## 🛠️ Technology Stack
-
-- **Gradio**: Interactive web interface
-- **Nebius GPT-OSS-120B** (OpenAI-compatible): LLM for content generation, host commentary, and reasoning
-- **ElevenLabs**: High-quality text-to-speech for voice generation
-- **LlamaIndex**: RAG system for personalized recommendations and user preference management
-- **MCP (Model Context Protocol)**: Structured tool servers for modular functionality
-- **Python**: Core application logic
-- **RSS Feeds**: Real-time news aggregation
 
 ## 🚀 Getting Started
 
@@ -279,17 +281,10 @@ This is a hackathon submission, but contributions and feedback are welcome!
 
 MIT License - feel free to use and modify as needed.
 
-## 🙏 Acknowledgments
-
-- **MCP Team** for the amazing protocol and competition
-- **Nebius** for GPT-OSS-120B API
-- **ElevenLabs** for text-to-speech technology
-- **LlamaIndex** for RAG capabilities
-- **Gradio** for the beautiful UI framework
-
 ## 📧 Contact
 
 Built with ❤️ for the MCP 1st Birthday Competition
+Contact: @nikimakarov 
 
 ---
 

README_HF_SPACES.md

@@ -1,56 +0,0 @@
-# AI Radio - HuggingFace Spaces Deployment
-
-This is the deployment guide for hosting AI Radio on HuggingFace Spaces.
-
-## 🚀 Quick Start
-
-1. **Create a new Space** on HuggingFace Spaces
-   - Choose "Gradio" as the SDK
-   - Set the hardware to "CPU" (or "GPU" if available)
-
-2. **Configure Secrets** in your Space settings:
-   Go to **Settings → Secrets** and add the following:
-   
-   **Required Secrets:**
-   - `ELEVENLABS_API_KEY` - Your ElevenLabs API key (for text-to-speech)
-   - `NEBIUS_API_KEY` - Your Nebius API key (for GPT-OSS-120B LLM)
-   
-   **Optional Secrets:**
-   - `LLAMAINDEX_API_KEY` - Your LlamaIndex API key (for embeddings, fallback to local)
-   - `OPENAI_API_KEY` - OpenAI API key (for embeddings fallback, optional)
-   
-   📖 **Detailed instructions:** See `SECRETS_SETUP.md` for step-by-step guide
-
-3. **Push your code** to the Space repository
-
-## 📁 File Structure
-
-The Space expects:
-- `app.py` - Entry point (already created)
-- `requirements.txt` - Python dependencies (already exists)
-- `src/` - Source code directory
-- `README.md` - This file (will be displayed on Space)
-
-## 🔧 Configuration
-
-API keys are loaded from environment variables (set as Secrets in HF Spaces):
-- `ELEVENLABS_API_KEY` - Required for text-to-speech
-- `NEBIUS_API_KEY` - Required for LLM (GPT-OSS-120B)
-- `LLAMAINDEX_API_KEY` - Optional, for LlamaIndex embeddings
-- `OPENAI_API_KEY` - Optional, for OpenAI embeddings fallback
-
-## 📝 Notes
-
-- The app will run on port 7860 (HF Spaces default)
-- Audio files are stored in `audio/` directory
-- User data is stored in `user_memory.json` and `user_data.json`
-- Logs are stored in `logs/` directory
-
-## 🐛 Troubleshooting
-
-If the app doesn't start:
-1. Check that all required secrets are set
-2. Check the logs in the Space
-3. Ensure `requirements.txt` has all dependencies
-4. Verify that `app.py` is at the root level
-

SECRETS_SETUP.md

@@ -1,57 +0,0 @@
-# 🔐 Настройка Secrets для HuggingFace Spaces
-
-## Необходимые Secrets
-
-Перейдите в **Settings → Secrets** вашего Space и добавьте следующие секреты:
-
-### Обязательные Secrets:
-
-1. **`ELEVENLABS_API_KEY`**
-   - Значение: Ваш API ключ от ElevenLabs
-   - Использование: Текст-в-речь (TTS)
-   - Где получить: https://elevenlabs.io/
-
-2. **`NEBIUS_API_KEY`**
-   - Значение: Ваш API ключ от Nebius
-   - Использование: LLM (GPT-OSS-120B) для генерации контента
-   - Где получить: https://nebius.com/
-
-### Опциональные Secrets:
-
-3. **`LLAMAINDEX_API_KEY`**
-   - Значение: Ваш API ключ от LlamaIndex
-   - Использование: Embeddings для RAG системы (если не используется локальный)
-   - Где получить: https://llamaindex.ai/
-   - Примечание: Если не указан, используется локальный sentence-transformers
-
-4. **`OPENAI_API_KEY`**
-   - Значение: Ваш API ключ от OpenAI
-   - Использование: Fallback для embeddings (если LlamaIndex недоступен)
-   - Где получить: https://platform.openai.com/
-   - Примечание: Опционально, используется только как fallback
-
-## Как добавить Secrets в HF Spaces:
-
-1. Откройте ваш Space: https://huggingface.co/spaces/MCP-1st-Birthday/AI-RADIO
-2. Перейдите в **Settings** (вкладка справа)
-3. Прокрутите до раздела **Secrets**
-4. Нажмите **"New secret"**
-5. Введите имя секрета (например, `ELEVENLABS_API_KEY`)
-6. Введите значение секрета
-7. Нажмите **"Add secret"**
-8. Повторите для всех необходимых секретов
-
-## Проверка:
-
-После добавления всех секретов:
-1. Перейдите во вкладку **Logs**
-2. Дождитесь перезапуска Space
-3. Проверьте логи на наличие предупреждений о недостающих ключах
-
-## Важно:
-
-- ✅ Все API ключи теперь читаются ТОЛЬКО из переменных окружения
-- ✅ Никакие ключи не хранятся в коде
-- ✅ Код безопасен для публичного репозитория
-- ⚠️ Убедитесь, что все необходимые секреты добавлены перед запуском
-