friday-tony-stark-demo-main

# 💠 F.R.I.D.A.Y. — Tony Stark Demo > **"Fully Responsive Intelligent Digital Assistant for You"** [](https://www.python.org/) [](https://github.com/jlowin/fastmcp) [](https://livekit.io/) [](https://opensource.org/licenses/MIT) An Iron Man-inspired AI assistant architecture. F.R.I.D.A.Y. isn't just a chatbot; she is a sophisticated ecosystem consisting of a high-performance **MCP Server** and a real-time **Voice Agent** that communicate seamlessly to provide a premium user experience. --- ## 🚀 Vision F.R.I.D.A.Y. is designed to be your trusted aide—calm, sharp, and always informed. Whether she's briefing you on global events or initializing a visual world monitor, she operates with the dry wit and precision you'd expect in the Stark Lab. --- ## 🛠️ System Architecture F.R.I.D.A.Y. is split into two specialized components: | Component | Role | Entry Point | |:---|:---|:---| | **MCP Server** | The "Back-End Brain" that exposes tools, prompts, and resources. | `uv run friday` | | **Voice Agent** | The "Real-Time Interface" that handles listen/think/speak logic. | `uv run friday_voice` | ### **The Signal Flow** ```mermaid graph TD User((User Voice)) -->|Microphone| STT[Sarvam Saaras v3] STT -->|Text| LLM[Gemini 1.5 Flash] LLM <-->|Tool Calls| MCP[FastMCP Server] MCP -->|News/System Info| LLM LLM -->|Response| TTS[Sarvam Bulbul v3 / OpenAI] TTS -->|Audio| Speaker((Speaker)) LLM -.->|Visual Trigger| Browser[World Monitor Dashboard] ``` --- ## ✨ Key Features - **🌐 Global News Briefing**: Simultaneously fetches headlines from BBC, CNBC, and NYT for a comprehensive morning update. - **🖥️ Automated World Monitor**: Unprompted, F.R.I.D.A.Y. opens a visual dashboard (`worldmonitor.app`) after delivering news briefings. - **🎙️ State-of-the-Art Voice**: Optimized with **Sarvam Saaras/Bulbul v3** for Indian-English nuances and **OpenAI Nova** for a confident, female tone. - **🔍 Intelligent Search**: Ability to search the web and fetch full page content for real-time information retrieval. - **⚙️ System Awareness**: Real-time access to system diagnostics and time. --- ## 📦 Quick Start ### 1. Prerequisites - **Python 3.11+** - [**uv**](https://github.com/astral-sh/uv) (Recommended package manager) - **LiveKit Cloud** account (Free tier supported) ### 2. Installation ```bash # Clone the repository git clone https://github.com/rahulghosh111111/friday-tony-stark-demo-main.git cd friday-tony-stark-demo-main # Install dependencies uv sync ``` ### 3. Configuration Copy the `.env.example` to `.env` and fill in your API keys: ```bash cp .env.example .env ``` *Required: `LIVEKIT_URL`, `LIVEKIT_API_KEY`, `LIVEKIT_API_SECRET`, `GOOGLE_API_KEY`, `SARVAM_API_KEY`.* --- ## 🏃 Operation F.R.I.D.A.Y. requires both the brain (Server) and the voice (Agent) to be running simultaneously. ### **Step 1: Start the MCP Server** ```bash uv run friday ``` *Exposes SSE transport on `http://127.0.0.1:8000/sse`.* ### **Step 2: Start the Voice Agent** ```bash uv run friday_voice ``` *Joins your LiveKit room. Open the [LiveKit Agents Playground](https://agents-playground.livekit.io) to start talking.* --- ## 📡 Technology Stack - **Frameworks**: [FastMCP](https://github.com/jlowin/fastmcp), [LiveKit Agents](https://github.com/livekit/agents) - **STT**: Sarvam Saaras v3 - **LLM**: Google Gemini 1.5 Flash - **TTS**: Sarvam Bulbul v3 / OpenAI Nova - **Infrastructure**: HTTP/SSE for MCP-Agent communication ---