Spaces:
Running
Running
| title: LifeAdmin AI - Autonomous Life Management Agent | |
| emoji: 🤖 | |
| colorFrom: purple | |
| colorTo: blue | |
| sdk: gradio | |
| sdk_version: 6.0.1 | |
| app_file: app.py | |
| pinned: true | |
| license: mit | |
| tags: | |
| - mcp-in-action-track-enterprise | |
| - mcp-in-action-track-consumer | |
| - mcp-in-action-track-creative | |
| # 🤖 LifeAdmin AI - Your Autonomous Life Management Agent | |
| > **🏆 Hugging Face MCP Birthday Hackathon Submission** | |
| > **Track 2:** MCP in Action | |
| > **Tags:** | |
| - mcp-in-action-track-enterprise | |
| - mcp-in-action-track-consumer | |
| - mcp-in-action-track-creative | |
| ## 📺 Demo Video | |
| **▶️ Watch Demo Video** https://drive.google.com/file/d/1Hdo_hHE-tohYYDmbmX5NJuZY1hrBKcW-/view?usp=sharing | |
| ## 📱 Social Media | |
| **LinkedIn Post:** https://www.linkedin.com/posts/maheen-touqeer-3b5b03289_mcp1stbirthday-aiagents-mcp-activity-7400925160662405121-4n97?utm_source=share&utm_medium=member_desktop&rcm=ACoAAEYb6nkB0latOGw2UbEtSUJfOzMNGaP4OPs | |
| ## 🎯 Overview | |
| **LifeAdmin AI** is an autonomous AI agent that revolutionizes how professionals manage life administration tasks. Built with Gradio 6 and powered by the Model Context Protocol (MCP), it demonstrates advanced autonomous reasoning, planning, and execution capabilities. | |
| ### The Problem | |
| Professionals waste **4-6 hours weekly** on repetitive admin tasks: | |
| - Manual form filling | |
| - Document organization | |
| - Calendar management | |
| - Email composition | |
| - Deadline tracking | |
| - File searching | |
| ### Our Solution | |
| An **autonomous AI agent** that: | |
| ✅ Understands complex requests through natural language | |
| ✅ Plans multi-step workflows autonomously | |
| ✅ Executes tasks using 7+ MCP tools | |
| ✅ Learns from past interactions via persistent memory | |
| ✅ Provides real-time feedback on reasoning process | |
| ## ✨ Key Features | |
| ### 🤖 **Autonomous Agent Capabilities** | |
| #### 1. **Intelligent Planning** | |
| - Analyzes user requests and breaks them into actionable tasks | |
| - Selects appropriate MCP tools for each subtask | |
| - Handles dependencies and sequential execution | |
| #### 2. **Contextual Reasoning** | |
| - Uses RAG (Retrieval-Augmented Generation) to search uploaded documents | |
| - Leverages conversation history from persistent memory | |
| - Makes intelligent decisions based on available context | |
| #### 3. **Multi-Step Execution** | |
| - Executes complex workflows autonomously | |
| - Provides real-time thought traces showing reasoning | |
| - Handles errors gracefully with fallback strategies | |
| ### 🔧 **MCP Tool Suite (7 Tools)** | |
| 1. **📄 OCR Text Extraction** - Extract text from images and scanned documents | |
| 2. **📑 PDF Analysis** - Summarize PDFs and extract metadata (dates, amounts, entities) | |
| 3. **📋 Smart Form Filler** - Auto-fill DOCX/XLSX forms with intelligent field matching | |
| 4. **✉️ Email Drafter** - Generate context-aware professional emails | |
| 5. **📅 Calendar Generator** - Create ICS calendar events from natural language | |
| 6. **🗂️ File Organizer** - Organize files by type, date, or size | |
| 7. **🔍 RAG Search** - Semantic document search with vector embeddings | |
| ### 💬 **Three Interaction Modes** | |
| #### 1. **Manual Dashboard** - Granular Control | |
| Direct access to each MCP tool with visual interface for precise control. | |
| #### 2. **LifeAdmin Coach** - Conversational AI | |
| Chat with an AI assistant that: | |
| - Answers questions about uploaded documents | |
| - Automatically calls appropriate tools | |
| - Provides summarization and insights | |
| - Tracks conversation history | |
| #### 3. **Voice Agent** - Hands-Free Operation | |
| Speak commands naturally and watch the agent: | |
| - Transcribe speech (Groq Whisper) | |
| - Plan and execute tasks | |
| - Respond with synthesized speech (ElevenLabs) | |
| ## 🏗️ Architecture | |
| ### **Tech Stack** | |
| ``` | |
| Frontend: Gradio 6.0 | |
| Agent: Custom autonomous agent with planning & reflection | |
| MCP: 7 custom MCP tool servers (local fallback mode) | |
| RAG: ChromaDB + Sentence Transformers (all-MiniLM-L6-v2) | |
| Memory: SQLite persistent storage | |
| LLMs: OpenAI GPT-4, Hyperbolic, Groq Llama 3.3 (fallback chain) | |
| Voice: Groq Whisper (STT), ElevenLabs (TTS) | |
| ``` | |
| ### **Agent Architecture** | |
| ``` | |
| User Request | |
| ↓ | |
| ┌─────────────────┐ | |
| │ Agent Core │ | |
| │ - Planning │ ←→ [Memory Store] | |
| │ - Reasoning │ ←→ [RAG Engine] | |
| │ - Execution │ | |
| └────────┬────────┘ | |
| ↓ | |
| ┌────────────────────┐ | |
| │ MCP Client │ | |
| │ Tool Router │ | |
| └────────┬───────────┘ | |
| ↓ | |
| ┌─────────────────────────────────┐ | |
| │ MCP Tool Servers (7) │ | |
| │ • OCR • PDF • Forms │ | |
| │ • Email • Calendar • Files │ | |
| │ • RAG │ | |
| └─────────────────────────────────┘ | |
| ``` | |
| ### **Key Technical Decisions** | |
| 1. **Local MCP Execution** - All tools run locally with async fallback for reliability | |
| 2. **Multi-Provider LLM** - Graceful degradation across OpenAI → Hyperbolic → Groq | |
| 3. **RAG Integration** - Document context enhances agent decision-making | |
| 4. **Persistent Memory** - SQLite stores conversations and user preferences | |
| 5. **Async-First Design** - Non-blocking I/O for responsive UX | |
| ## 🎬 Real-World Use Cases | |
| ### **Use Case 1: Automated Form Filling** | |
| ``` | |
| User uploads membership form + provides data | |
| Agent: Plans extraction → Fills form → Returns completed document | |
| Time saved: 15 minutes → 30 seconds | |
| ``` | |
| ### **Use Case 2: Document Analysis** | |
| ``` | |
| User: "What are the key deadlines in my PDF?" | |
| Agent: Searches RAG → Extracts dates → Summarizes deadlines | |
| Output: Structured deadline list with context | |
| ``` | |
| ### **Use Case 3: Email Workflow** | |
| ``` | |
| User: "Draft a follow-up email for my membership application" | |
| Agent: Retrieves application context → Generates professional email → Offers editing | |
| Result: Publication-ready email in seconds | |
| ``` | |
| ### **Use Case 4: Calendar Management** | |
| ``` | |
| User: "Create a meeting next Tuesday at 2pm" | |
| Agent: Parses natural language → Generates ICS file → Ready for import | |
| Integration: Works with Google Calendar, Outlook, Apple Calendar | |
| ``` | |
| ## 📖 How to Use | |
| ### **1. Manual Dashboard** | |
| 1. Upload files (PDF, images, documents) | |
| 2. Select a tool (OCR, PDF, Forms, etc.) | |
| 3. Configure parameters | |
| 4. Execute and download results | |
| ### **2. LifeAdmin Coach** | |
| 1. Upload documents in Manual Dashboard first | |
| 2. Switch to Coach tab | |
| 3. Ask questions like: | |
| - "What documents have I uploaded?" | |
| - "Summarize my PDF" | |
| - "What's on my calendar?" | |
| - "Draft an email about X" | |
| ### **3. Voice Agent** | |
| 1. Upload files (optional) | |
| 2. Click microphone or type command | |
| 3. Click "Execute Command" | |
| 4. Watch agent reasoning in real-time | |
| 5. Receive voice + text response | |
| ## 🏆 Why LifeAdmin AI? | |
| ### **Judging Criteria Alignment** | |
| #### ✅ **Design/Polished UI-UX** | |
| - Clean, modern interface with Gradio 6 | |
| - Responsive mobile design | |
| - Intuitive tab-based navigation | |
| - Real-time feedback and progress indicators | |
| - Professional gradient theming | |
| #### ✅ **Functionality** | |
| - **Autonomous agents:** Full planning-reasoning-execution cycle | |
| - **MCP integration:** 7 custom MCP tools | |
| - **Advanced features:** RAG, persistent memory, multi-modal I/O | |
| - **Gradio 6 features:** SSR, mobile support, async operations | |
| #### ✅ **Creativity** | |
| - Novel combination of voice + chat + manual control | |
| - Intelligent form-filling with fuzzy matching | |
| - Thought trace visualization for transparency | |
| - Context-aware tool selection | |
| #### ✅ **Documentation** | |
| - Comprehensive README with architecture diagrams | |
| - Demo video showing all features | |
| - Clear setup instructions | |
| - Code comments and docstrings | |
| #### ✅ **Real-World Impact** | |
| - **Target users:** 100M+ professionals worldwide | |
| - **Time savings:** 4-6 hours/week per user | |
| - **Pain points addressed:** Forms, emails, documents, scheduling | |
| - **Scalability:** Cloud-ready architecture | |
| ###🚀 **Quick Start** | |
| Try it Online | |
| 👉 Open LifeAdmin AI on Hugging Face | |
| https://huggingface.co/spaces/MCP-1st-Birthday/LifeAdmin-AI | |
| Run Locally | |
| bash# Clone repository | |
| git clone https://github.com/MCP-1st-Birthday/LifeAdmin-AI.git | |
| cd LifeAdmin-AI | |
| # Install dependencies | |
| pip install -r requirements.txt | |
| # Set up API keys (at least one required) | |
| export OPENAI_API_KEY="your_key" | |
| export GROQ_API_KEY="your_key" | |
| export ELEVENLABS_API_KEY="your_key" | |
| export HYPERBOLIC_API_KEY="your_key" | |
| # Launch app | |
| python app.py | |
| Visit http://localhost:7860 | |
| ## 🤝 Team | |
| **Solo Developer:** Maheen Touqeer | |
| **HuggingFace:** https://huggingface.co/Maheentouqeer1 | |
| **LinkedIn:** https://www.linkedin.com/in/maheen-touqeer-3b5b03289/ | |
| ## 🙏 Acknowledgments | |
| Built for **MCP's 1st Birthday Hackathon** hosted by: | |
| - **Anthropic** - For the amazing Claude API and MCP protocol | |
| - **Gradio Team** - For Gradio 6 and excellent documentation | |
| - **Hugging Face** - For hosting infrastructure and community | |
| - **Sponsor APIs** - OpenAI, Groq, ElevenLabs, Hyperbolic | |
| Special thanks to the MCP community for inspiration and support! 🎉 | |
| ## 📞 Contact & Feedback | |
| **Questions?** Reach out on Hugging Face Space Community | |
| **Found it useful?** ⭐ Star this Space and share with your network! | |
| Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference | |