krish-mind-mobile / README.md
Krishkanth's picture
Upload README.md with huggingface_hub
b74e0b4 verified
---
license: apache-2.0
tags:
- GGUF
- conversational
- krish-mind
- ai-assistant
- llama.cpp
- ollama
- mobile-ready
- on-device
language:
- en
pipeline_tag: text-generation
---
# πŸ“± Krish Mind Mobile β€” The Ultimate Pocket AI πŸš€
<div align="center">
**✨ Krish Mind is an elite independent AI assistant developed by Krish CS. ✨**
*🧠 Designed to be intelligent, helpful, and blazing fast β€” even on your phone!*
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Format: GGUF](https://img.shields.io/badge/Format-GGUF-orange)](https://github.com/ggerganov/llama.cpp)
[![Mobile Ready](https://img.shields.io/badge/Mobile-Ready%20βœ…-brightgreen)]()
[![Privacy Focused](https://img.shields.io/badge/Privacy-100%25%20Offline-blue)]()
</div>
---
## 🌟 What is Krish Mind Mobile?
**Krish Mind** is a state-of-the-art independent AI assistant developed by **Krish CS**. Krish Mind has its own unique identity, personality, and knowledge base. It is designed to be genuinely helpful, conversational, and easy to use for everyone.
**Krish Mind Mobile** is the ultra-compact edition engineered specifically to run **completely offline on smartphones**. It fits in under **2 GB**, making it the perfect AI companion in your pocket! 🦾
### πŸ’Ž Why Krish Mind Mobile?
- πŸ“± **Under 2 GB** β€” fits on almost any modern smartphone without a worry
- πŸ“΅ **Fully Offline** β€” works even in airplane mode, no internet needed
- πŸ’° **Completely Free** β€” no subscriptions, no hidden costs, ever
- πŸ”’ **100% Private** β€” your conversations never leave your device
- ⚑ **Blazing Fast** β€” optimized to respond instantly even on older phones
---
## πŸ—‚οΈ The Complete Krish Mind Family
Choose the version that matches your hardware!
| 🏷️ Version | πŸ“¦ Size | πŸ’Ύ RAM | πŸ“± Mobile Support | ⬇️ Action |
|---|---|---|---|---|
| πŸ“± **Mobile (This Repo)** | ~2 GB | 3-4 GB | βœ… Full Support | [πŸ“₯ Download Mobile](https://huggingface.co/Krishkanth/krish-mind-mobile/resolve/main/krish-mind-mobile.gguf) |
| ⚑ **Q4 Balanced** | ~5 GB | 8-16 GB | ❌ Desktop Only | [πŸ”— Visit Repository](https://huggingface.co/Krishkanth/krish-mind-gguf-Q4) |
| πŸš€ **Full Quality** | ~16 GB | 32+ GB | ❌ Desktop Only | [πŸ”— Visit Repository](https://huggingface.co/Krishkanth/krish-mind-gguf-standalone-16) |
---
| `krish-mind-mobile.gguf` | ~1.96 GB | [πŸ“₯ Download Now](https://huggingface.co/Krishkanth/krish-mind-mobile/resolve/main/krish-mind-mobile.gguf) |
---
## πŸš€ Live Demo - Chat Now!
You can test **Krish Mind Mobile** instantly without downloading anything! We have deployed a live version to Hugging Face Spaces:
**πŸ”— [Chat with Krish Mind Mobile (Live)](https://huggingface.co/spaces/Krishkanth/Krish-Mind)**
---
## 🀳 Running Krish Mind on Your Smartphone (Android & iOS)
This is where Krish Mind Mobile truly shines! Below are all the apps that support running GGUF models offline on your phone.
---
### πŸ€– Android β€” Step by Step
#### βœ… Option A: PocketPal AI (Most Recommended!)
PocketPal AI is the best Android app for running GGUF models. It has a built-in Hugging Face browser so you can find and download Krish Mind directly inside the app!
**Step 1:** Open the Google Play Store and search for **PocketPal AI**. Install it.
**Step 2:** Open the app. Tap the **Models** tab at the bottom.
**Step 3:** Tap **Add Model** and then tap **Search Hugging Face**.
**Step 4:** Type `Krishkanth/krish-mind-mobile` in the search bar and press search.
**Step 5:** Tap **Download** next to `krish-mind-mobile.gguf` (~2 GB). Wait for the download to complete.
**Step 6:** Tap the **Chat** tab. Select `krish-mind-mobile` from the model list and start chatting!
> πŸ’‘ You can now disable your Wi-Fi and the model will keep working perfectly offline!
---
#### βœ… Option B: SmolChat
SmolChat is a lightweight open-source Android app for running small AI models in GGUF format.
**Step 1:** Download `krish-mind-mobile.gguf` from the link above to your phone's storage.
**Step 2:** Install SmolChat from the Google Play Store or from GitHub.
**Step 3:** Open the app and tap the **+** (plus) button to add a model.
**Step 4:** Tap **Import from Storage** and navigate to your downloaded GGUF file.
**Step 5:** Set the **Prompt Template** to `ChatML` or `Default`. Tap **Load Model**.
**Step 6:** Start chatting! The model works completely offline.
---
#### βœ… Option C: LLM Hub
LLM Hub is an all-in-one Android AI assistant supporting text generation, image generation, and translation entirely offline.
**Step 1:** Download `krish-mind-mobile.gguf` to your phone.
**Step 2:** Install LLM Hub from the Google Play Store.
**Step 3:** Open the app and go to **Models** section.
**Step 4:** Tap **Import Local Model** and select your downloaded GGUF file.
**Step 5:** Tap **Load** and the model will be ready. Open the chat and start talking!
---
#### βœ… Option D: Off Grid (Open Source Power App)
Off Grid is a powerful open-source Android app for fully offline AI.
**Step 1:** Install Off Grid from the Play Store or download the APK from GitHub.
**Step 2:** Download `krish-mind-mobile.gguf` to your device.
**Step 3:** Open Off Grid and navigate to the **Language Model** section.
**Step 4:** Tap **Import GGUF** and select your file from storage.
**Step 5:** Once loaded, open the chat interface and begin your conversation!
---
### 🍎 iPhone & iPad β€” Step by Step
#### βœ… Option A: PocketPal AI (Most Recommended for iOS!)
PocketPal AI is available on the Apple App Store and is the most seamless iOS experience.
**Step 1:** Open the App Store and search for **PocketPal AI**. Install it.
**Step 2:** Open the app and go to the **Models** tab.
**Step 3:** Tap **Add Model** and search for `Krishkanth/krish-mind-mobile`.
**Step 4:** Download `krish-mind-mobile.gguf` directly inside the app. Wait for the download to complete.
**Step 5:** Go to **Chat**, select the model from the dropdown, and start chatting!
---
#### βœ… Option B: LLMFarm
LLMFarm is one of the most well-established iOS apps for running GGUF models.
**Step 1:** Install **LLMFarm** from the Apple App Store.
**Step 2:** On your iPhone, open **Safari** and download `krish-mind-mobile.gguf` from the download link above. When prompted, choose **Download** (not Open).
**Step 3:** Go to the **Files** app on your iPhone. Find `krish-mind-mobile.gguf` in your Downloads folder.
**Step 4:** Tap and hold the file, then tap **Share** and choose **LLMFarm** from the share sheet to import it.
**Step 5:** Open LLMFarm and tap the **+** button. Select your imported model file.
**Step 6:** Set the model type to **Auto** or **ChatML**. Tap **Load** and begin chatting!
---
#### βœ… Option C: ChatterUI
ChatterUI is a modern and clean iOS app for running local AI models.
**Step 1:** Install **ChatterUI** from the App Store.
**Step 2:** Download `krish-mind-mobile.gguf` via Safari and save it to your Files app.
**Step 3:** Open ChatterUI and tap **Model Settings** in the top right corner.
**Step 4:** Tap **Import Model** and select the GGUF file from your Files app.
**Step 5:** Tap **Load Model** and open the chat to start talking!
---
## πŸ’» Running Krish Mind on Your Laptop
### 🟒 Option 1 β€” Ollama (Recommended for Beginners!)
Ollama is a free, open-source tool for running AI models locally. Works on Windows, Mac, and Linux!
**Step 1: Install Ollama**
Download and install Ollama from: https://ollama.ai/download
Run the installer. No configuration needed.
**Step 2: Download the Model**
Download `krish-mind-mobile.gguf` from the link above. Save it to a convenient folder, for example:
- Windows: `C:\Users\YourName\krish-mind\`
- Mac/Linux: `~/krish-mind/`
**Step 3: Create a Modelfile**
Inside the same folder as your GGUF file, create a new plain text file named exactly `Modelfile` (no extension). Open it and paste this single line:
```
FROM ./krish-mind-mobile.gguf
```
Save and close the file.
**Step 4: Import into Ollama**
Open your terminal (or Command Prompt on Windows). Navigate to the folder where your Modelfile is:
```bash
cd C:\Users\YourName\krish-mind
```
Then run this command to register the model with Ollama:
```bash
ollama create krish-mind -f Modelfile
```
Wait for it to complete. This step only needs to be done once.
**Step 5: Start Chatting!**
```bash
ollama run krish-mind
```
Krish Mind is now loaded and ready. Type your message and press Enter!
**Useful Ollama Commands:**
```bash
ollama list # Show all installed models
ollama run krish-mind # Start a chat session
ollama rm krish-mind # Remove the model
```
---
### 🎨 Option 2 β€” LM Studio (Visual Desktop App, Zero Commands!)
LM Studio gives you a beautiful chat interface just like ChatGPT, running entirely locally.
**Step 1:** Download LM Studio from https://lmstudio.ai and install it.
**Step 2:** Download `krish-mind-mobile.gguf` to your computer.
**Step 3:** Open LM Studio. Click the folder icon on the left sidebar that says **My Models**.
**Step 4:** Click **Add Model** and drag your downloaded GGUF file into the window, or click **Browse** to find it.
**Step 5:** Go to the **AI Chat** tab (speech bubble icon on the left). At the top centre of the screen, click the model selector dropdown and choose `krish-mind-mobile`.
**Step 6:** Start typing your message and press Enter. Krish Mind will respond!
---
### πŸ› οΈ Option 3 β€” Python (For Developers)
Install llama-cpp-python:
```bash
pip install llama-cpp-python
```
Run Krish Mind in your Python code:
```python
from llama_cpp import Llama
llm = Llama(
model_path="./krish-mind-mobile.gguf",
n_ctx=4096,
n_threads=4,
)
response = llm.create_chat_completion(
messages=[{"role": "user", "content": "Hello! Who are you?"}]
)
print(response["choices"][0]["message"]["content"])
```
---
## πŸ› οΈ System Requirements
### Smartphone Requirements
| πŸ“± Platform | πŸ₯‰ Minimum | πŸ₯‡ Recommended |
|---|---|---|
| **Android** | 4 GB RAM, Android 10 | 8 GB RAM, Snapdragon 8 Gen 1+ |
| **iPhone** | iPhone 12+ | iPhone 14 Pro or newer |
### Laptop/Desktop Requirements
| πŸ’» Platform | πŸ₯‰ Minimum | πŸ₯‡ Recommended |
|---|---|---|
| **Windows** | 4 GB Free RAM, Any modern CPU | 8 GB RAM, Intel i5/AMD Ryzen 5 |
| **Mac** | 4 GB Free RAM, Apple M1 | Apple M2 or newer |
| **Linux** | 4 GB Free RAM | 8 GB RAM |
**Storage Space Required:** 2.5 GB free
---
## ❓ Frequently Asked Questions
**Q: Does it really work without internet?**
A: Yes! After the first download, Krish Mind runs 100% offline. You can even enable Airplane Mode.
**Q: My phone only has 4 GB RAM. Will it work?**
A: Yes. The Mobile version is specifically designed for devices with 4 GB of RAM. It will work on most modern mid-range smartphones.
**Q: Is it free forever?**
A: Yes. It is released under Apache 2.0. Free for personal and commercial use.
---
<div align="center">
**✨ Happy Chatting with Krish Mind Mobile! ✨**
*Made with ❀️ by Krish CS*
</div>