--- title: ReMind β€” Your Second 🧠 emoji: "🧠" colorFrom: blue colorTo: purple sdk: gradio sdk_version: 5.33.1 app_file: app.py pinned: false license: mit tags: - agents - mcp - gmail - bookmarks - web-search - agent-demo-track --- ## πŸŽ₯ Project Demo Video [![ReMind Demo Video](https://img.youtube.com/vi/CD0j2dGVycs/maxresdefault.jpg)](https://youtu.be/CD0j2dGVycs) **Watch the full project demonstration:** [https://youtu.be/CD0j2dGVycs](https://youtu.be/CD0j2dGVycs) --- # 🧠 ReMind β€” Bring your past to mind **ReMind is a unified digital-memory assistant that learns from your AI newsletters, curates your Chrome bookmarks, and lets you query both in natural languageβ€”all orchestrated by a multi-agent system.** Built for the **Agents & MCP Hackathon 2025 β€” Track 3: Agentic Demo Showcase**. > *"Email that teaches me, bookmarks that remember for me, answers when I need them."* --- ## ✨ Why ReMind? | Pain | ReMind Solution | | ------------------------------------------------ | ------------------------------------------------------- | | Newsletter overload every morning | One-click OAuth fetch, auto-tagging & summarisation | | Thousand-tab bookmark graveyard | AI categorisation & semantic search | | Context-switching between inbox, browser, search | Single chat interface powered by agents | | Opaque AI answers | Real-time "thought process" trace & clickable citations | --- ## πŸš€ Live Demo β€” 30-Second Flow 1. **Open the Space** and start with the **"ℹ️ About"** tab to understand the system architecture. 2. Switch to **"πŸ’¬ Chat Assistant"** tab to interact with the multi-agent system. 3. Ask questions like "Search my AI bookmarks" or "Show me my latest emails from news@alphasignal.ai". 4. Check the **"🏷️ Categories Dashboard"** to see your bookmarks organized by AI categories. 5. Watch the agents think in real-time and explore your organized digital knowledge. [β–ΆοΈŽ **Live Demo Space**](https://huggingface.co/spaces/Agents-MCP-Hackathon/ReMind) --- ## πŸ—οΈ Repo Layout (monorepo-style) ``` ReMind/ β”œβ”€ config/ # default prompts, yaml configs β”œβ”€ data/ # AI bookmarks cache & diagram β”œβ”€ src/ # package root (importable as `remind`) β”‚ β”œβ”€ agents/ # Manager, Gmail, Bookmark, Categorizer, Web Search β”‚ β”œβ”€ interfaces/ # Gradio interface with 3 tabs β”‚ β”œβ”€ tools/ # Gmail API wrapper, bookmark parser, utils β”‚ β”œβ”€ __init__.py β”‚ └─ main.py # entrypoint when imported as a module β”œβ”€ app.py # HF Spaces entrypoint β”œβ”€ .env.example # copy β†’ .env and fill in secrets β”œβ”€ requirements.txt # runtime deps β”œβ”€ pyproject.toml # tooling & formatting └─ README.md # you are here ``` The **root‐level `app.py`** is the single entrypoint required by Hugging Face Spaces. It loads the Gradio interface from `src/interfaces/gradio_interface.py`. --- ## βš™οΈ Quick Start (Local Dev) ```bash # 1. Clone & install $ git clone https://github.com/your-org/remind.git && cd remind $ pip install -r requirements.txt # 2. Configure secrets $ cp .env.example .env # then paste your tokens # 3. Launch the app $ python app.py # opens http://localhost:7860 ``` ### Required Environment Variables | Key | Description | | ---------------------------------------------- | -------------------------------------------------------- | | `HF_TOKEN` | Hugging Face token for Qwen3-32B model access | | `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` | OAuth credentials from Google Cloud Console | | `GOOGLE_REFRESH_TOKEN` / `GOOGLE_ACCESS_TOKEN` | Generated by Gmail OAuth setup for trusted email access | > **Tip β€” Gmail setup**: Configure Google Cloud Console OAuth for Gmail API access. Email reading is restricted to `news@alphasignal.ai` for security. --- ## πŸ› οΈ Key Components ![ReMind AI System Architecture](data/ai_diagram.png) *System architecture showing the multi-agent orchestration and data flow in ReMind* * **Multi-Agent Orchestrator** β€” built with *SmolagentS*; assigns Gmail parsing, bookmarking, and RAG tasks to specialists. * **LLM Stack** β€” Qwen3-32B for reasoning and natural language understanding * **Vector Store** β€” in-memory JSON caching for fast bookmark and email access * **Gradio 5 UI** β€” three-tab layout: About, Chat Assistant, and Categories Dashboard with real-time agent "thoughts". --- ## 🎯 Core Features (MVP) 1. **Chrome Bookmark Management** β€’ Import and cache AI resources from Chrome bookmarks β€’ Intelligent categorization into 10 AI-focused categories β€’ Search and filter by domain, keywords, and categories 2. **Gmail Integration (read-only)** β€’ Secure access to trusted AI newsletter sources β€’ Search and browse recent emails with intelligent filtering β€’ Email content reading with natural language queries 3. **Natural-Language Q&A** β€’ Multi-agent system for complex query handling β€’ Real-time web search integration for current information β€’ Transparent agent reasoning with step-by-step thinking display 4. **Categories Dashboard** β€’ Visual organization of AI bookmarks by category β€’ Statistics and insights about your AI knowledge base β€’ Easy browsing and discovery of forgotten resources --- ## πŸ›£οΈ Roadmap (Post-Hackathon) * Enhanced bookmark import from multiple browsers * Advanced categorization with machine learning * Email notification integration for real-time updates * Shared knowledge bases for teams and communities * Mobile-optimized interface for on-the-go access Contribute ideas β†’ [Discussions](https://huggingface.co/spaces/Agents-MCP-Hackathon/ReMind/discussions). --- ## 🀝 Contributing PRs welcome! During hack-week we operate on a **fast-merge** basis. * README with live demo & video βœ”οΈ * HF Space public & reproducible βœ”οΈ If ReMind sparks joy, **⭐️ the repo & "Like" the Space** β€” community engagement counts! --- ## πŸ‘©β€πŸ’» Authors | Name | GitHub | Role | | ------------ | -------------------------------------------------- | ------------------------------------ | | Habib Adoum | [@GhostDragon01](https://github.com/GhostDragon01) | Lead Full-Stack & Agent Orchestrator | | Omar Issa | [@omarissa24](https://github.com/omarissa24) | Contributor | | Ziad Mazzawi | [@zmazz](https://github.com/zmazz) | Contributor | Thanks to **Modal Labs**, **Hugging Face**, **Nebius**, **Anthropic**, **OpenAI**, **Hyperbolic Labs**, **MistralAI**, and **Sambanova.AI** for providing credits that power this demo. --- ## πŸ“„ License MIT β€” free to fork & learn. See `LICENSE`. --- > May your inbox be calm and your bookmarks memorable. --- *Built for the Agents-MCP-Hackathon 2025 by Habib*