A modern, elegant local AI chatbot application that connects with Ollama to provide a seamless chat experience with various LLM models.
⚠️ Currently Windows Only: This application is currently only available for Windows. Support for other platforms coming soon!
⭐ If you find this project helpful, please consider giving it a star! It helps others discover the project.
Windows Users: Download the latest installer
Just download MehrLocalChat-Setup.exe from the releases page and run it to install Mehr on your Windows system.
⚠️ Known Issue: Due to a current Vite limitation, the installer won't create a desktop shortcut automatically. You have two options:Option 1: Pin to Taskbar (Recommended)
- Launch the app from Start Menu
- Right-click the app icon in the taskbar
- Click "Pin to taskbar"
Option 2: Create Desktop Shortcut
- Pin to taskbar first (follow Option 1)
- Right-click the pinned icon in taskbar
- Right-click "Mehr" in the menu
- Click "Properties"
- Click "Open File Location"
- Right-click the application and select "Create shortcut"
- Move the shortcut to your desktop
- 🤖 Local AI Integration: Connects with Ollama to run AI models locally on your machine
- 🌐 Bilingual Support: Full support for English and Persian (فارسی)
- 💅 Modern UI: Built with React, Electron, and shadcn/ui for a beautiful, responsive interface
- ✍️ Markdown Support: Rich text formatting in chat messages
- 🎛️ Advanced Settings:
- Temperature control for response creativity
- Streaming support for real-time responses
- 💬 Chat Features:
- Real-time message streaming
- Message history within conversations
- Markdown formatting support
- Emoji support 🎉
This project is built upon the excellent electron-shadcn template, which provided the foundational structure for combining Electron with shadcn/ui. I've extended it significantly to create a full-featured AI chat application.
- 📚 Chat History
- Save and organize your conversations
- Browse through past chats
- Create and manage multiple chat sessions
- 📄 Document Support
- PDF file integration
- Document analysis and Q&A
- 🖼️ Multimodal Support
- Image understanding and generation
- Enhanced media interaction
- Ollama installed on your system
- Node.js and npm/yarn installed (only needed for development)
- Download the Windows Installer
- Run
MehrLocalChat-Setup.exe - Follow the installation wizard
- Important: To create a desktop shortcut, follow the steps in the note above about the known Vite issue
# Clone the repository
git clone https://github.com/xmannii/MehrLocalChat
# Navigate to the project directory
cd MehrLocalChat
# Install dependencies
npm install
# Start the application
npm run start- Start Ollama on your system
- Launch Mehr
- Select your preferred language (English/Persian)
- Choose an AI model from your local Ollama installation
- Start chatting!
You can customize your chat experience through the settings panel:
- Language: Switch between English and Persian
- Theme: Toggle between light and dark modes
- Temperature: Adjust the creativity level of responses (0.0 - 1.0)
- Streaming: Enable/disable real-time response streaming
# Run in development mode
npm run start
# Build the application
npm run make
- Electron
- React
- Vite
- TypeScript
- TailwindCSS
- shadcn/ui
- Ollama API
- i18
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
- Ollama for making local AI accessible
- shadcn/ui for the beautiful UI components
- electron-shadcn template for the project structure
- All contributors and supporters of the project
مِهر یک نرم‌افزار مدرن و زیبا برای گفتگو با مدل‌های هوش مصنوعی است که به صورت محلی روی سیستم شما اجرا می‌شود.
- پشتیبانی از زبان فارسی و انگلیسی 🌐
- رابط کاربری مدرن و زیبا 💅
- پشتیبانی از مارک‌داون ✍️
- تنظیمات پیشرفته برای خروجی‌های متنوع 🎛️
- پخش زنده پاسخ‌ها 💬
- پشتیبانی از ایموجی 🎉
به زودی: تاریخچه گفتگوها، پشتیبانی از PDF و قابلیت‌های چندرسانه‌ای 🚀