Metadata-Version: 2.4
Name: ollamate
Version: 0.0.1
Summary: Ollamate is a simple AI assistant for local LLMs hosted on your machine using Ollama. it will support some custom functions and a RAG system.
Project-URL: Homepage, https://github.com/iraj-jelo/ollamate
Project-URL: Issues, https://github.com/iraj-jelo/ollamate/issues
Author-email: Iraj Jelodari <Iraj.Jelo@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: GUI,ai,assistant,bot,chat,llama,llm,ollama
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Requires-Dist: ollama>0.4.0
Description-Content-Type: text/markdown

<img src='img/screenshot.png'> 

# <img src='img/og.png'> Ollamate

**Ollamate** (A playful combination of "Ollama" and "mate" implying a helpful companion ) is an **AI assistant**, using [Ollama](https://ollama.com) to run your favorite LLMs locally as your assistant.

It support an user-friendly GUI, making interaction with Ollama easier and more gentle than before. Additionally in future, it will support a simple RAG system and multiple different tools making daily routine tasks a no-brainer. 

<small>"This project is licensed under the terms of the MIT license."</small>

<hr>

### 💻 How To Use It

First, install the app using:

```bash
pip install ollamate
```

Then, before running the following command, make sure that you are running Ollama on your system and pulled your desired LLM model from [here](https://ollama.com/library).

⚠️ Notice that you may encounter **errors** such as:
 ```
 ImportError: No module named ‘Tkinter’
 ```
 or 
 ```
 ModuleNotFoundError: No module named 'tkinter' in Python
 ```
which are explained in the next section.

To run the app:

```bash
ollamate
```
Or simply run:

```bash
om
```

<hr>

### Q/A

#### I'm getting ImportError or ModuleNotFoundError errors.

The errors:
```
ImportError: No module named 'tkinter'
```
or 
```
ModuleNotFoundError: No module named 'tkinter' in Python
```

These happen due to lack of the Tk library on your machine: 

For **Ubuntu**:

```
sudo apt-get install python3-tk
```

For **Fedora**:

```
sudo dnf install python3-tkinter
```

For **macOS**:

```
brew install python-tk
```

#### How can I contribute in this project?

- **Fork** the project
- Make your **changes**
- Build a **pull-request** on the our main project's repository