updated structure

.gitignore

@@ -4,50 +4,41 @@ __pycache__/
 *$py.class
 *.so
 .Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
 *.egg-info/
-.installed.cfg
-*.egg
+dist/
+build/
 
-# Virtual Environment
+# Virtual environments
+.venv/
 venv/
-env/
 ENV/
-.venv
+
+# Audio files (generated)
+audio/*.mp3
+audio/*.wav
+
+# Logs
+logs/*.log
+
+# User data
+user_data.json
 
 # IDE
 .vscode/
 .idea/
 *.swp
 *.swo
-*~
 
 # OS
 .DS_Store
 Thumbs.db
 
-# Environment variables
-.env
-
-# User data
-user_data.json
-*.mp3
-*.wav
-
-# Logs
-*.log
+# Temporary files
+*.part
+*.tmp
 
-# HuggingFace
-flagged/
+# ChromaDB
+chroma_db/
 
+# Music cache
+music_cache/

README.md

@@ -30,6 +30,25 @@ 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.
 
+## 📁 Project Structure
+
+```
+ai_radio/
+├── src/              # Source code
+│   ├── app.py        # Main Gradio application
+│   ├── config.py     # Configuration
+│   ├── radio_agent.py # AI agent logic
+│   ├── tts_service.py # Text-to-speech service
+│   ├── rag_system.py  # RAG system
+│   ├── voice_input.py # Voice input handling
+│   └── mcp_servers/  # MCP server implementations
+├── docs/             # Documentation files
+├── audio/            # Generated audio files
+├── logs/             # Log files
+├── requirements.txt  # Python dependencies
+└── run.py           # Application entry point
+```
+
 ## ✨ Features
 
 ### 🎵 Personalized Music
@@ -118,10 +137,16 @@ google_api_key: str = "your-gemini-api-key-here"
 
 4. Run the app:
 ```bash
+python run.py
+```
+
+Or from the src directory:
+```bash
+cd src
 python app.py
 ```
 
-5. Open your browser to `http://localhost:7860`
+5. Open your browser to `http://localhost:7863`
 
 ## 📖 How to Use
 

run.py

@@ -0,0 +1,18 @@
+#!/usr/bin/env python3
+"""Entry point for AI Radio application"""
+import sys
+import os
+
+# Add src directory to Python path
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "src"))
+
+# Import and run the app
+from app import demo
+
+if __name__ == "__main__":
+    demo.launch(
+        server_name="0.0.0.0",
+        server_port=7863,
+        share=False
+    )
+

src/__init__.py

@@ -0,0 +1,2 @@
+"""AI Radio - Personalized Radio Station with AI Host"""
+

app.py → src/app.py

@@ -7,6 +7,13 @@ import re
 from typing import Dict, Any, List, Optional
 import threading
 
+# Get project root directory (parent of src/)
+PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+AUDIO_DIR = os.path.join(PROJECT_ROOT, "audio")
+LOG_DIR = os.path.join(PROJECT_ROOT, "logs")
+os.makedirs(AUDIO_DIR, exist_ok=True)
+os.makedirs(LOG_DIR, exist_ok=True)
+
 from config import get_config
 from radio_agent import RadioAgent
 from tts_service import TTSService
@@ -180,7 +187,7 @@ def play_next_segment():
             if getattr(tts_service, "available", True):
                 audio_bytes = tts_service.text_to_speech(next_batch)
                 if audio_bytes:
-                    host_audio_file = f"segment_{radio_state['current_segment_index']}_batch_{batch_index}.mp3"
+                    host_audio_file = os.path.join(AUDIO_DIR, f"segment_{radio_state['current_segment_index']}_batch_{batch_index}.mp3")
                     tts_service.save_audio(audio_bytes, host_audio_file)
             
             # Build display info (same news segment)
@@ -233,7 +240,7 @@ def play_next_segment():
         if text and getattr(tts_service, "available", True):
             audio_bytes = tts_service.text_to_speech(text)
             if audio_bytes:
-                host_audio_file = f"segment_{radio_state['current_segment_index']}.mp3"
+                host_audio_file = os.path.join(AUDIO_DIR, f"segment_{radio_state['current_segment_index']}.mp3")
                 tts_service.save_audio(audio_bytes, host_audio_file)
     
     elif segment["type"] == "news":
@@ -245,7 +252,7 @@ def play_next_segment():
             if getattr(tts_service, "available", True):
                 audio_bytes = tts_service.text_to_speech(first_batch)
                 if audio_bytes:
-                    host_audio_file = f"segment_{radio_state['current_segment_index']}_batch_1.mp3"
+                    host_audio_file = os.path.join(AUDIO_DIR, f"segment_{radio_state['current_segment_index']}_batch_1.mp3")
                     tts_service.save_audio(audio_bytes, host_audio_file)
             # Store remaining batches for sequential playback
             segment["remaining_batches"] = script_batches[1:] if len(script_batches) > 1 else []
@@ -266,7 +273,7 @@ def play_next_segment():
         if commentary and getattr(tts_service, "available", True):
             audio_bytes = tts_service.text_to_speech(commentary)
             if audio_bytes:
-                host_audio_file = f"segment_{radio_state['current_segment_index']}_host.mp3"
+                host_audio_file = os.path.join(AUDIO_DIR, f"segment_{radio_state['current_segment_index']}_host.mp3")
                 tts_service.save_audio(audio_bytes, host_audio_file)
         
         # Get music track and create streaming player
@@ -363,7 +370,7 @@ def play_next_segment():
         if intro and getattr(tts_service, "available", True):
             audio_bytes = tts_service.text_to_speech(intro)
             if audio_bytes:
-                host_audio_file = f"segment_{radio_state['current_segment_index']}_host.mp3"
+                host_audio_file = os.path.join(AUDIO_DIR, f"segment_{radio_state['current_segment_index']}_host.mp3")
                 tts_service.save_audio(audio_bytes, host_audio_file)
     
     # Progress info
@@ -561,7 +568,7 @@ def handle_voice_request():
         if getattr(tts_service, "available", True):
             audio_bytes = tts_service.text_to_speech(host_response)
             if audio_bytes:
-                audio_file = f"voice_request_{int(time.time())}.mp3"
+                audio_file = os.path.join(AUDIO_DIR, f"voice_request_{int(time.time())}.mp3")
                 tts_service.save_audio(audio_bytes, audio_file)
         
         # Create music player HTML

radio_agent.py → src/radio_agent.py

@@ -16,7 +16,9 @@ from rag_system import RadioRAGSystem
 # -----------------------------------------------------------------------------
 # LLM Logging Setup
 # -----------------------------------------------------------------------------
-LOG_DIR = "logs"
+# Get project root directory (parent of src/)
+PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+LOG_DIR = os.path.join(PROJECT_ROOT, "logs")
 os.makedirs(LOG_DIR, exist_ok=True)
 
 llm_logger = logging.getLogger("ai_radio.llm")

rag_system.py → src/rag_system.py

@@ -7,6 +7,9 @@ from llama_index.core import VectorStoreIndex, Document, Settings
 from llama_index.core.storage.storage_context import StorageContext
 from llama_index.core.vector_stores import SimpleVectorStore
 from llama_index.llms.openai import OpenAI as LlamaOpenAI
+
+# Get project root directory (parent of src/)
+PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 # from llama_index.embeddings.gemini import GeminiEmbedding  # Commented out - using Nebius instead
 # from llama_index.llms.gemini import Gemini  # Commented out - using Nebius instead
 
@@ -65,7 +68,7 @@ class RadioRAGSystem:
         # Load existing index or create new one
         self.index = None
         self.documents = []
-        self.user_data_file = "user_data.json"
+        self.user_data_file = os.path.join(PROJECT_ROOT, "user_data.json")
         
         self._load_user_data()