MirAI, more than AI.
A simple, lightweight, and responsive web interface to interact directly with the Google Gemini API — now smarter, more personal, and more powerful than ever.
- ☁️ Google Drive Backup & Auto‑Sync – Connect your Drive account and enjoy automatic backups every 10 minutes. Restore previous sessions with a single click. Backups are stored in Drive’s private
appDataFolderand older ones are automatically rotated. - 🔁 Cross‑Device Continuity – Log in to your Google account (Firebase) or connect Drive – or both. Your chat history, API keys, personas, accent colours, and search engine configs follow you everywhere.
- 📎 Multi‑Format Attachments – The
+button now supports images, audio (MP3, WAV, OGG), and documents (PDF, DOCX, TXT, MD, JSON) with inline previews. - 🔇 TTS Stop Control – Click the speaker icon again while the AI is speaking to stop immediately.
- 🧠 Improved Memory Management – Chat trimming only happens when you save settings or exceed the limit, with a clear warning.
- 🔍 Smart Search Mode – Automatically switches between external search engines (SearchAPI.io, Google, DuckDuckGo, Wikipedia) and AI knowledge base when no engines are enabled.
- 🎨 Custom Accent Color – Choose any hex colour; dark colours are filtered to maintain readability.
- 🔐 Encrypted Backup (.medf) – Export your entire chat history, settings, and API keys with password protection and authenticity signature.
- ⚡ Gemini 2.5 Flash – Default model is now
gemini-2.5-flashfor faster, more reliable responses. - 🌍 Better TTS Language Support – Strips markdown characters before speaking; respects Indonesian, English (US/UK), and Japanese.
(For the complete update history, see the Changelog.)
- 💾 Session Persistence – Your conversation is automatically saved in your browser. Pick up where you left off, anytime.
- ☁️ Google Drive Backup & Auto‑Sync – Connect your Drive account for scheduled (every 10 min) and manual backups; restore from any previous backup.
- ✅ Responsive Chat Interface – Comfortable layout for both mobile and desktop.
- 🎭 Customizable AI Persona – Choose between Default (Relaxed & Casual), Formal, Creative, or write your own custom persona.
- 🌐 Multi-language Support – Indonesian, English (US & UK), and Japanese.
- 🔑 API Key Configuration – Enter your own Gemini API key directly from the settings menu.
- 🚀 Enhanced Slash Commands & Tools Menu – Use the
+menu or type commands like/translate,/summarize,/code, and/fix. Real‑time suggestions as you type. - 🖼️ Multimodal Input – Upload images, audio, and documents (PDF, TXT, MD, JSON, DOCX) alongside your text prompts.
- 🔊 Text-to-Speech (TTS) – Click the speaker icon to read the AI’s response aloud; click again to stop.
- 🛑 Stop Generation – Immediately halt the AI’s response when needed.
- 📝 Markdown Parsing – Responses with formatting (code blocks, lists, tables) are displayed correctly.
- ⏰ Time-aware Context – The AI knows the current date and time for more relevant answers.
- 📤 Backup & Restore (Local) – Export/import to encrypted
.medfor plain.mdf/.jsonfiles with authenticity verification. - 📲 Progressive Web App (PWA) – Install MirAI as a native‑like app on your device with offline capabilities.
- 🔒 Encrypted Config System – Secure
.medffile format with authenticity signatures for API key storage. ⚠️ Public API Usage Limits – Intelligent tracking and warnings for fair usage of the public API key.- 📋 One-Click Copy – Easily copy AI responses to clipboard with proper attribution.
- 🌐 Connection Status Indicator – Visual online/offline indicator.
- 🔄 Model Switching – Support for Gemini 2.5 Flash (stable) and Gemini 3 Flash Preview (beta) via URL parameters.
- 🔍 Advanced Search Integration – Powerful
/searchcommand with multiple search engines (SearchAPI.io, Google, DuckDuckGo, Wikipedia) or AI Knowledge Base fallback. - ⚙️ Configurable Search Engines – Enable/disable individual search engines with API key configuration.
- 🎨 Custom Accent Color – Personalise the interface with your own hex colour; automatic readability checks.
- ➡️ Try the Web Version (Netlify)
- ⬇️ Download HTML File (Offline Version)
- 📱 Install as PWA (TWA Android)
- 🧪 Try Beta Model (Gemini 3 Flash Preview)
For the best performance and security, it is highly recommended to use your own Google Gemini API Key.
➡️ Click here for a complete tutorial on obtaining an API Key.
[ same existing tutorial content – unchanged ]
Or watch the video tutorial:
- Connect Drive – Authenticate using your Google account (OAuth 2.0) and grant access to the
appDataFolder(hidden, only accessible by MirAI). - Manual Backup – Click “Backup to Drive” to instantly save your entire app state (chat history, settings, API keys, search config, accent colour).
- Restore – Choose any previous backup from the list and restore it with a single click.
- Auto‑Sync – Every 10 minutes, MirAI automatically uploads a backup if changes are detected (SHA‑256 hash comparison). Older automatic backups are rotated to keep at most 5 files.
- Images: JPEG, PNG, WebP – previewed inline.
- Audio: MP3, WAV, OGG – labelled with file name.
- Documents: PDF, TXT, MD, JSON, DOCX – shown with file icon and name.
- All attachments are processed with Gemini’s multimodal API.
- Click the speaker icon to read the AI’s response aloud.
- Click again while speaking to stop.
- Strips markdown characters before speaking for clean voice output.
- Local Export/Import – Save to
.medf(encrypted + signature) or.mdf/.json(plain). - Drive Backup – Cloud storage with auto‑sync and manual restore.
- Multiple Search Engines – SearchAPI.io (default), Google Custom Search, DuckDuckGo, Wikipedia.
- Configurable – Enable/disable engines and store API keys in Settings.
- Two modes – External search (real‑time web) or AI Knowledge Base (training data only).
- Search parameters – Use
[engine:name],[results:N],[type:web/news/images]. - Search cache – Speeds up repeated queries.
- Installable – Add to home screen, offline support, push notifications.
- .medf encryption – AES‑GCM with password, authenticity signatures.
- API Key visibility toggle – Show/hide keys in settings.
- Public API limiter – Prevents abuse of the default public key.
- Splash screen – With progress bar.
- Chat memory slider – Adjustable from 25 to 85 bubbles.
- Abort controller – Cancel ongoing AI responses.
- Search cache – Redundant API call reduction.
- Hash‑based navigation (
#settings). - Persona & language sync across backups and Drive.
- Live search mode indicator.
- Accent color picker with validation.
- HTML, CSS, JavaScript (Vanilla)
- Google Gemini API (
gemini-2.5-flash,gemini-3-flash-preview) - Marked.js – Markdown parsing
- SuperRoundedUI – Design guidelines
- .medf – Original encrypted format by Allwaysever
- Web Crypto API – Encryption/decryption
- Service Workers – PWA offline capabilities
- OneSignal – Push notifications
- Web Speech API – Text‑to‑speech
- Google Drive API – Backup & auto‑sync (
appDataFolder) - Firebase Authentication & Firestore – Cloud settings sync
- Multiple Search APIs – SearchAPI.io, Google Custom Search, DuckDuckGo, Wikipedia API
- ❓ FAQ
- 🛠️ Troubleshooting Guide
- 🔄 Changelog
- 🤝 Contributing Guide
- 🔒 .medf File Format Specification
- 🔍 Search Engine Configuration Guide
Apache License 2.0
Note
The .medf format specification is an original innovation by Allwaysever. While the implementation is open source, we encourage developers to respect the branding and integrity of this format.
Important
The default public API key has usage limits. For uninterrupted access, please use your personal API key.
Tip
Search engines are disabled by default for first‑time users. Enable them in Settings → Search Configuration to use /search with external sources.
MirAI 3 – more than AI.
Your intelligent, personalised, and beautifully rounded companion.