marm-mcp

<div align="center"> <picture> <img src="https://github.com/Lyellr88/MARM-Systems/blob/MARM-main/media/marm-main.JPG?raw=true" alt="MARM - The AI That Remembers Your Conversations" width="700" height="350"> </picture> <h1 align="center">MARM: The AI That Remembers Your Conversations</h1> <h4 align="center">Memory Accurate Response Mode v2.0 - Build smarter AI conversations with structured memory and transparent logic.</h4>    [](https://github.com/Lyellr88/MARM-Systems/blob/MARM-main/LICENSE)  <h2 align="center">🎯 What is MARM? </h2> <picture> <img src="https://github.com/Lyellr88/MARM-Systems/blob/MARM-main/media/google-overview.png" alt="MARM - The AI That Remembers Your Conversations" width="525" height="600" style="filter: brightness(0.9) contrast(1.05);"> </picture> </div> <p align="center">*As recognized by Google AI Overview:* --- ## ❌ Before MARM vs ✅ After MARM **❌ Without MARM:** - "Wait, what were we discussing about the database schema?" - AI repeats previous suggestions you already rejected - Loses track of project requirements mid-conversation - Starts from scratch every time you return **✅ With MARM:** - AI references your logged project notes and decisions - Maintains context across multiple sessions - Builds on previous discussions instead of starting over - Remembers what works and what doesn't for your project ## 📌 Overview MARM is a protocol for AI reliability. It gives you control over memory and logic by letting you log sessions, store your own notes, and compile summaries. The result: fewer hallucinations, transparent reasoning, and conversations that stay on track. **Steer the AI instead of chasing it.** > For copy-and-paste prompt users and full technical details, see [`PROTOCOL.md`](./PROTOCOL.md) [Try MARM Chatbot](https://marm-systems-chatbot.onrender.com) --- ## 📄 Table of Contents - [Overview](#-overview) - [Who is Marm Built For?](#-built-for-research--real-use) - [Why MARM?](#-why-marm) - [Commands & Features](#-key-features--command-overview) - [Live Demo](#-try-marm-now---no-setup-required) - [Install Locally](#%EF%B8%8F-install-locally) - [Community](#-join-the-marm-community) - [Feedback](#-feedback--community-mentions) - [Project Files](#-project-files) --- ## ❓ Why MARM? Modern LLMs often lose context or fabricate information. MARM introduces a session memory kernel, structured logs, and a user-controlled knowledge library. Anchoring the AI to *your* logic and data. It’s more than a chatbot wrapper. It’s a methodology for accountable AI. ### Read Before You Start - Start MARM in a **new session** for best results - MARM **does not persist** across threads - To resume long sessions, use `/summary:` and reseed manually - Commands are **manual by design** to ensure transparency and user control --- ## 🔑 Key Features & Command Overview ### Key Features - **Session memory kernel** – Tracks user intent and prompts clarification - **Structured logs** – Use `/log` and `/summary:` to build summaries - **Personal library** – Use `/notebook` to guide model outputs with your notes - **Accuracy guardrails** – Optional logic checks to reduce false outputs ### Command Overview Session Commands - `/start marm` → Activate protocol - `/refresh marm` → Reaffirm/reset context Core Commands - `/log` → Start structured session logging - `/notebook` → Store key data - `/summary:` → Summarize and reseed sessions Advanced Tools - `/deep dive` → Request context-aware response - `/show reasoning` → Reveal logic trail of last answer #### Quick Start (for copy and paste protocol) ```text /start marm /log entry: [YYYY-MM-DD - topic - summary] /summary: SessionName ``` Need a walkthrough or troubleshooting help? The [`HANDBOOK.md`](./HANDBOOK.md) covers all aspects of using MARM. --- <div align="center"> <h3>🚀 Try MARM Now - No Setup Required</h3> <a href="https://marm-systems-chatbot.onrender.com"> <img src="https://img.shields.io/badge/Launch_Live_Demo-MARM_Chatbot-FF6B6B?style=for-the-badge&logo=rocket&logoColor=white" width="300"> </a> <p><i>Experience all features instantly in your browser</i></p> </div> --- <div align="center"> <picture> <img src="https://github.com/Lyellr88/MARM-Systems/blob/MARM-main/media/chatbot-dark.png" width="700" height="350"> </picture> </div> <div align="center"> ### User Experience (Chatbot) **Browser optimized** - Professional web interface (mobile support coming soon) **Modern card-style chat** - Glass effects with indigo/amber color palette **File upload system** - Upload and analyze text/code files with syntax highlighting **MARM protocol toggle** - Switch between structured MARM mode and free conversation **Command menu redesign** - Contextual popup menu next to input with glassmorphism effects **Save and revisit chat sessions** - Name and organize your conversations with session persistence **Enhanced notebook system** - Store user knowledge with add/use/clear/status commands **Voice synthesis** - Listen to MARM responses (Chrome/Edge recommended) **XSS protection** - Professional -level security with comprehensive input sanitization **Llama 4 Maverick powered** - 400B parameter model with 10M token context **No setup required** - Just open and start chatting **Professional error handling** - Clear feedback with improved timeout handling </div> --- ## 🛠️ Install Locally Run MARM on your own machine using Replicate API (LLaMA 4 Maverick). Great for developers, power users, or those who want full control. ### Requirements - Node.js v16+ - Git - Replicate API Key (free or paid) **Install Node.js first (if not installed):** ```bash # Windows/Mac: Download from https://nodejs.org/ # Linux: sudo apt install nodejs npm node --version # Should show v16+ ``` ### 1. Clone the Repository ```bash git clone https://github.com/Lyellr88/MARM-Systems.git cd MARM-Systems/webchat ``` ### 2. Install Dependencies ```bash npm install ``` ### 3. Add API Key Create a `.env` file and add your Replicate key: ```bash touch .env echo "REPLICATE_API_TOKEN=your_token_here" >> .env ``` ### 4. Start the App ```bash npm start ``` ### 5. Go to Website ```bash http://localhost:8080 ``` ### Need detailed steps, troubleshooting, or multi-provider setup? See [`SETUP.md`](./SETUP.md) for complete installation guide with Node.js setup and troubleshooting. --- ## 🧪 Built For Research + Real Use MARM is both a power-user tool and a research scaffold: ### AI Safety & Reasoning Research - Study systematic reasoning in language models - Analyze memory persistence across sessions - Measure hallucination reduction with structured prompts ### Business Intelligence - Maintain context across long analytical threads - Build organizational knowledge into sessions - Reinforce consistent decision-making frameworks ### Educational & Training Use - Teach critical thinking via structured interaction - Build personalized learning repositories - Guide model reasoning with user-curated facts ### Not built for Small talk • Throwaway chats • Passive use --- <div align="center"> [](https://star-history.com/#Lyellr88/MARM-Systems&Date) </div> --- ## 🚀 Join the MARM Community **Help build the future of AI memory - no coding required!** ### Easy Ways to Get Involved - **Try the demo** and share your experience - **Star the repo** if MARM solves a problem for you - **Share on social** - help others discover memory-enhanced AI - **Open issues** with bugs, feature requests, or use cases - **Join discussions** about AI reliability and memory ### For Developers - **Build integrations** - MCP, browser extensions, API wrappers - **Improve the protocol** - enhance memory systems - **Add new platforms** - expand beyond web chat ### Growing Community - **126+ GitHub stars** and growing - **Active discussions** on Reddit and Discord - **Real users** solving daily AI frustration [Discord server link coming soon] --- ## 📣 Feedback & Community Mentions MARM is actively being tested and adopted across platforms. - Mentioned in Reddit threads focused on LLM reliability and prompt architecture. - Direct messages from early users highlight reduced drift and improved memory handling - Recognized in Google's AI-related search results as a structured memory protocol **Reddit Feedback – Follow-up Thread** [Reddit Feedback 1 (View Image)](media/Reddit%20Community%20Feedback%201.jpg) **Reddit Feedback – Upvoted Response** [Reddit Feedback 2 (View Image)](media/Reddit%20Community%20Feedback%202.jpg) *Additional feedback and screenshots will be added as adoption grows.*