AI Music Manager

中文文档

An intelligent music manager powered by AI, featuring playlist management, music library organization, and an AI chat assistant.

Project Structure

• backend/: FastAPI backend server.
• frontend/: HTML/JS/CSS frontend application.
  • components/: Modular UI components (Chat, Playlists, Library, Settings).
• music/: Directory for music files.

Setup & Run

1. Install Dependencies

   pip install -r requirements.txt

2. Start App

   python run.py

3. Package (Optional)

   pyinstaller ai-music-manager.spec

   Start dist/AI-Music-Manager.exe.

.env Configuration

• API_KEY / API_BASE_URL / MODEL_NAME: The Agent uses the ChatOpenAI interface, so the model needs to support OpenAI-compatible APIs; current example uses the glm model.
• IQS_API_KEY: Apply at Aliyun Console.
• IQS_MCP_URL: MCP server deployed via Aliyun FC.
• FETCH_MCP_URL: MCP server deployed via Aliyun FC.

Agent Capabilities

The AI Music Manager features a powerful agent powered by LangChain, designed to assist with music management and discovery.

Key Functions

• Music Management:
  • Create, delete, and modify playlists.
  • Add or remove songs from playlists.
  • Move music files between folders.
  • Scan and summarize local music library metadata.
• Information Retrieval:
  • Search the web for music information (artist bios, album details, lyrics).
  • Fetch and parse webpage content for detailed answers.
• Context Awareness:
  • Understands your current playlists and music library.
  • Remembers conversation history for natural interaction.

Available Tools

The agent has access to a suite of specialized tools:

• playlist_tool: Manage playlist creation and modification.
• delete_playlist_tool: Remove playlists.
• get_playlist_content_tool: View songs within a specific playlist.
• move_songs_tool: Organize physical music files.
• local_music_info_tool: Query metadata for specific local songs.
• summarize_music_info_tool: Scan the entire library and update metadata summaries.
• common_search: Perform web searches for real-time information.
• web_fetch: Retrieve and analyze content from specific URLs.

Features

• AI Chat Console: Interface for interacting with the AI music assistant.
  • Visual Thought Process: View the agent's step-by-step reasoning and tool usage.
• Playlists: Manage and view playlists (Visual demo).
• Music Library: Browse and play all music tracks from the music/ directory.
• Settings: Configure API keys and application preferences.
• Playback Control: Play, pause, previous, next, and progress bar.