Mint is a sleek, modern, and minimalist AI chatbot app built with React Native and Expo. It connects to Ollama's API (locally hosted) to bring you an intelligent and smooth chat experience right at your fingertips. Whether you need quick answers or want to engage in casual conversations, Mint delivers it all in a stylish package.
- Sleek & Minimalist Design: Focused on delivering a smooth, distraction-free user experience.
- General-Purpose AI: Powered by Ollama’s API to provide accurate and contextual responses.
- Local Hosting: Ollama’s API is locally hosted for faster and more reliable communication.
- Responsive UI: Optimized for both Android and iOS devices.
To get started with Mint, follow these steps:
Before you get started, make sure you have the following installed:
-
Node.js v20 or above: This project requires Node.js version 20 or higher. You can check your current Node.js version by running:
node -v
If you need to update Node.js, you can download the latest version from nodejs.org.
-
Ollama: To run the app, you'll need to have Ollama installed locally, as it powers the AI chatbot. Follow these steps to install Ollama:
-
First, download Ollama from the official website: https://ollama.com (make sure you're installing the correct version for your operating system).
-
Once installed, you can pull the required AI model. For example, to use a general-purpose model, run the following command:
ollama pull <model-name>
Replace
<model-name>
with the model you want to use (e.g., 'llama3.2:3b', etc.). -
After the model is downloaded, Ollama should be ready to run locally on your machine.
-
-
Clone the repository to your local machine:
git clone https://github.com/your-username/mint.git
-
Navigate to the project directory:
cd mint
-
Install the necessary dependencies:
npm install
-
Run the app with Expo:
For Android:
npx expo start --android
For iOS (if you're on a Mac):
npx expo start --ios
You can also open the app on your phone using the Expo Go app by scanning the QR code displayed in the terminal or browser.
Feel free to fork this repo, submit issues, or create pull requests! Contributions are always welcome.
- Fork the repository.
- Create your feature branch (
git checkout -b feature/your-feature-name
). - Commit your changes (
git commit -am 'Add new feature'
). - Push to your branch (
git push origin feature/your-feature-name
). - Open a pull request.
- Ollama API: For providing the powerful AI engine that powers Mint’s chatbot experience.
- React Native: For enabling cross-platform mobile app development.
- Expo: For making it easy to build and deploy React Native apps.
Enjoy chatting with Mint! 😊