Metadata-Version: 2.4
Name: desktop4mistral
Version: 0.1.2
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).
- Some commands also support a more natural language syntax. You can, for instance, say "read the contents of /tmp/myfile.txt".
- Use `/save_markdown` to save your entire chat as a markdown file, which you could use in other tools, like Obsidian.
- Supports Python code execution. Ideally, you should first ask it to write some Python code. In the next prompt you can just say something like "run it". This way you can be sure what the model's doing.

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

