Skip to content

foskey51/mint

Repository files navigation

Mint: A General-Purpose AI Chatbot

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.

Mint App Banner


Features

  • 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.

How to Install and Run

To get started with Mint, follow these steps:

Prerequisites

Before you get started, make sure you have the following installed:

  1. 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.

  2. 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.

Installation

  1. Clone the repository to your local machine:

    git clone https://github.com/your-username/mint.git
  2. Navigate to the project directory:

    cd mint
  3. Install the necessary dependencies:

    npm install
  4. 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.


Contributing

Feel free to fork this repo, submit issues, or create pull requests! Contributions are always welcome.

  1. Fork the repository.
  2. Create your feature branch (git checkout -b feature/your-feature-name).
  3. Commit your changes (git commit -am 'Add new feature').
  4. Push to your branch (git push origin feature/your-feature-name).
  5. Open a pull request.

Acknowledgements

  • 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! 😊

About

Just an another AI wrapper of ollama (*llama 3.2:3b)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published