{"id":30742024,"url":"https://github.com/moleculeprotocol/mira-ai-prototype-v0","last_synced_at":"2025-09-04T01:11:17.134Z","repository":{"id":306073237,"uuid":"1024914353","full_name":"moleculeprotocol/mira-ai-prototype-v0","owner":"moleculeprotocol","description":"Ask anything about DeSci \u0026 Molecule! Smart chatbot with local knowledge + web search fallback","archived":false,"fork":false,"pushed_at":"2025-08-19T09:39:55.000Z","size":20662,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-19T11:39:04.869Z","etag":null,"topics":["agentic-rag","ai","ai-assistant","chatbot","desci","lancedb","rag","retrieval-augmented-generation","web3"],"latest_commit_sha":null,"homepage":"https://mira.molecule.xyz","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moleculeprotocol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-23T12:44:01.000Z","updated_at":"2025-08-19T09:40:00.000Z","dependencies_parsed_at":"2025-07-23T14:50:54.244Z","dependency_job_id":null,"html_url":"https://github.com/moleculeprotocol/mira-ai-prototype-v0","commit_stats":null,"previous_names":["moleculeprotocol/mira-ai-prototype-v0"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/moleculeprotocol/mira-ai-prototype-v0","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moleculeprotocol%2Fmira-ai-prototype-v0","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moleculeprotocol%2Fmira-ai-prototype-v0/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moleculeprotocol%2Fmira-ai-prototype-v0/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moleculeprotocol%2Fmira-ai-prototype-v0/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moleculeprotocol","download_url":"https://codeload.github.com/moleculeprotocol/mira-ai-prototype-v0/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moleculeprotocol%2Fmira-ai-prototype-v0/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273535173,"owners_count":25122796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-rag","ai","ai-assistant","chatbot","desci","lancedb","rag","retrieval-augmented-generation","web3"],"created_at":"2025-09-04T01:11:16.166Z","updated_at":"2025-09-04T01:11:17.105Z","avatar_url":"https://github.com/moleculeprotocol.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MIRA v0 Prototype 🧬\n\n## AI-Powered Knowledge Assistant for DeSci \u0026 Molecule\n\nMIRA (Molecule Insights Research Assistant) is an experimental prototype that demonstrates how modern AI can intelligently provide accurate information about decentralized science (DeSci) and Molecule's ecosystem.\n\n## 🎯 What is MIRA?\n\nMIRA is a smart chatbot that can answer questions about **anything related to Molecule and the DeSci ecosystem**. This includes, but is not limited to:\n\n- **DeSci (Decentralized Science)** - The movement to make scientific research more open and accessible\n- **Molecule Platform** - All features, products, and services offered by Molecule\n- **IP-NFTs** - Tokenizing intellectual property and research assets\n- **Research Funding** - Grants, investments, and new funding mechanisms\n- **DAOs \u0026 Governance** - BioDAOs, VitaDAO, and decentralized organizations\n- **DeSci Tools** - Various tools and protocols in the ecosystem\n- **Community \u0026 Events** - DeSci conferences, initiatives, and collaborations\n- **And much more!** - Any topic connected to Molecule's mission and the broader DeSci movement\n\n### Key Features\n\n- **🤖 Smart Decision Making**: MIRA decides on its own whether it has enough information to answer your question\n- **📚 Local Knowledge Base**: Contains curated information about Molecule and DeSci\n- **🌐 Web Search Fallback**: Automatically searches the web when local knowledge isn't enough\n- **👍👎 Feedback System**: Help improve MIRA by rating responses\n- **🔍 Source Transparency**: Always shows where information comes from\n\n## 🏗️ How It Works\n\nMIRA uses a three-step intelligent process called \"Agentic RAG\" (Retrieval Augmented Generation):\n\n### 1. **Search Local Knowledge**\nWhen you ask a question, MIRA first searches its local knowledge base for relevant information using advanced semantic search that understands meaning, not just keywords.\n\n### 2. **Evaluate \u0026 Decide**\nMIRA then evaluates the information it found:\n- **Sufficient Context?** → Use local knowledge to answer\n- **Insufficient but Relevant?** → Search the web for current information\n- **Off-topic?** → Politely decline with an explanation\n\n### 3. **Generate Response**\nBased on its decision, MIRA either:\n- Provides an answer from trusted local sources\n- Searches the web for up-to-date information (focusing on trusted domains)\n- Explains that the question is outside its expertise\n\n## 🛠️ Technology Stack\n\nMIRA combines several technologies:\n\n### **Chainlit** (User Interface)\n- Responsive chat interface\n- Real-time streaming responses\n- Interactive feedback buttons\n\n### **LanceDB** (Knowledge Storage)\n- **Vector Search**: Finds information by meaning and context\n- **Hybrid Search**: Combines semantic understanding with keyword matching\n- **Fast \u0026 Efficient**: Delivers relevant results quickly\n\n### **OpenAI GPT-4o** (AI Brain)\n- Understands natural language questions\n- Evaluates context quality\n- Generates human-like responses\n- Web search capabilities for current information\n\n### **Langfuse** (Monitoring \u0026 Analytics)\n- Tracks system performance\n- Collects user feedback\n- Helps improve responses over time\n- Ensures quality and reliability\n\n## 📊 The Workflow\n\nHere's how MIRA processes your questions:\n\n```\n┌─────────────────────┐\n│   User Question     │\n└──────────┬──────────┘\n           │\n           ▼\n┌─────────────────────┐\n│  Search Local       │\n│  Knowledge Base     │\n│  (LanceDB)          │\n└──────────┬──────────┘\n           │\n           ▼\n┌─────────────────────┐\n│  Evaluate Context   │\n│  Is it sufficient?  │\n└──────────┬──────────┘\n           │\n    ┌──────┴──────┬─────────────┐\n    │             │             │\n    ▼             ▼             ▼\n┌─────────┐ ┌─────────┐ ┌─────────┐\n│   Yes   │ │   No,   │ │   No \u0026  │\n│         │ │   but   │ │  Off-   │\n│  Local  │ │Relevant │ │  topic  │\n│ Answer  │ │         │ │         │\n└─────────┘ │   Web   │ └─────────┘\n            │ Search  │\n            │ (GPT-4o)│\n            └─────────┘\n                │\n    ┌───────────┴─────────────┐\n    │                         │\n    ▼                         ▼\n┌─────────────────────┐ ┌─────────────────────┐\n│  Generate Answer    │ │ \"Sorry, I can't     │\n│  with Sources       │ │  help with that\"    │\n└──────────┬──────────┘ └──────────┬──────────┘\n           │                       │\n           └───────────┬───────────┘\n                       │\n                       ▼\n            ┌─────────────────────┐\n            │   Display Answer    │\n            │   👍    👎          │\n            └─────────────────────┘\n                       │\n                       ▼\n            ┌─────────────────────┐\n            │ Langfuse Monitoring │\n            │ (Track \u0026 Improve)   │\n            └─────────────────────┘\n```\n\n### The Decision Process Explained:\n\n1. **You ask a question** → MIRA receives your query\n2. **Searches local knowledge** → Uses LanceDB's semantic search to find relevant information\n3. **Makes a smart decision**:\n   - ✅ **Sufficient info?** → Answers from local knowledge\n   - 🌐 **Not enough but relevant?** → Searches the web for current info\n   - ❌ **Off-topic?** → Politely declines\n4. **Generates response** → Creates a helpful answer with sources\n5. **You rate the answer** → Helps MIRA improve over time\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Python 3.8 or higher\n- Virtual environment (recommended)\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone [repository-url]\n   cd molecule-chainlit\n   ```\n\n2. **Create and activate virtual environment**\n   ```bash\n   python -m venv .venv\n   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\n   ```\n\n3. **Install dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Set up environment variables**\n   Create a `.env` file with:\n   ```\n   OPENAI_API_KEY=your_openai_api_key\n   LANGFUSE_PUBLIC_KEY=your_langfuse_public_key\n   LANGFUSE_SECRET_KEY=your_langfuse_secret_key\n   ```\n\n5. **Run the application**\n   ```bash\n   chainlit run app.py\n   ```\n\n6. **Open your browser**\n   Navigate to `http://localhost:8000`\n\n## ⚠️ Important Notes\n\n### This is a Prototype\n- MIRA v0 is an **experimental prototype**, not a production-ready application\n- Used for learning about robust AI systems and gathering user feedback\n- Responses should be verified for critical decisions\n\n### Data Sources\n- Local knowledge base contains curated information about Molecule and DeSci\n- Web search results are filtered to prioritize trusted domains like:\n  - molecule.to\n  - molecule.xyz\n  - bio.xyz\n  - vitadao.com\n  - ...\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoleculeprotocol%2Fmira-ai-prototype-v0","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoleculeprotocol%2Fmira-ai-prototype-v0","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoleculeprotocol%2Fmira-ai-prototype-v0/lists"}