Metadata-Version: 2.4
Name: desktop4mistral
Version: 0.1.0
Summary: A powerful desktop client for Mistral LLMs
Home-page: https://github.com/hathibelagal-dev/desktop4mistral
Author: Ashraff Hathibelagal
Project-URL: Source, https://github.com/hathibelagal-dev/desktop4mistral
Project-URL: Tracker, https://github.com/hathibelagal-dev/desktop4mistral/issues
Keywords: ai text-to-speech speech-synthesis nlp transformer voice
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6
Requires-Dist: requests
Requires-Dist: markdown
Requires-Dist: wikipedia
Requires-Dist: markdownify
Requires-Dist: git2string
Requires-Dist: str2speech>=0.3.0
Requires-Dist: sounddevice
Requires-Dist: scipy
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# desktop4mistral


A powerful desktop client for interacting with Mistral Large Language Models (LLMs)

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![PyPI - Version](https://img.shields.io/pypi/v/desktop4mistral)](https://pypi.org/project/desktop4mistral/)
[![Total Downloads](https://img.shields.io/pepy/dt/desktop4mistral)](https://pypi.org/project/desktop4mistral/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/desktop4mistral)
![PyPI - Status](https://img.shields.io/pypi/status/desktop4mistral)

## Overview

desktop4mistral is a Python-based desktop application that provides a user-friendly interface for chatting with Mistral AI models. Built with PySide6, it offers a modern GUI with features like model selection, chat history, and command support.

## Features

- Interactive chat interface with Mistral LLMs
- Support for multiple Mistral models with easy switching
- Full Markdown support.
- Command system (e.g., `/read` to fetch any local file or webpage, `wiki_search` to search Wikipedia, etc).
- Use `/save_markdown` to save your entire chat as a markdown file, which you could use in other tools, like Obsidian.

## Commands

Desktop4Mistral supports several commands.

- `/read` to read a local or remote file. Can also be used to reload a previous chat session.
- `/git` to read a github repository
- `/wiki_search` to search Wikipedia
- `/wiki_id` to look up the contents of a Wikipedia page
- `/save` to save the entire chat session as a JSON file
- `/save_markdown` to save the entire chat session as a markdown file
- `/talk` to turn talking `on` or `off`. Uses Kokoro as the TTS model. You can expect reasonable performance on most hardware.

## Screenshots

<img src="https://raw.githubusercontent.com/hathibelagal-dev/desktop4mistral/refs/heads/main/sshots/0.png" style="width:800px;"/>

<img src="https://raw.githubusercontent.com/hathibelagal-dev/desktop4mistral/refs/heads/main/sshots/1.png" style="width:800px;"/>

## Installation

### Prerequisites

- Python 3.11 or 3.12
- Mistral API key (get it from [Mistral AI](https://mistral.ai/))

## Quickstart

Install using `pip`.
```bash
pip install desktop4mistral
```

And run...
```bash
export MISTRAL_API_KEY='your-api-key-here'
desktop4mistral
```

or

```bash
python3 -m desktop4mistral.main
```

### Setup for development

1. Clone the repository:
```bash
git clone https://github.com/hathibelagal-dev/desktop4mistral.git
cd desktop4mistral
```

2. Install the app and its dependencies:
```bash
pip3 install .
```

## Usage

- Launch the application
- Select a Mistral model from the "Models" menu
- Type your message in the input field
- Press Ctrl+Enter or click "Send" to submit
- View responses in the chat window

## Support
For issues and feature requests, please use the GitHub [Issues](https://github.com/hathibelagal-dev/desktop4mistral/issues) page.

## License

This project is licensed under the GNU General Public License v3 (GPLv3) - see the LICENSE file for details.

