---
license: apache-2.0
---
<p align="center" style="margin-bottom: 0;">
  <img src="https://github.com/huggingface/chat-macOS/raw/main/assets/banner.png" alt="HuggingChat macOS Banner">
</p>
<h1 align="center" style="margin-top: 0;">HuggingChat</h1>

### About
HuggingChat is a native chat interface designed specifically for macOS users, leveraging the power of open-source language models. It brings the capabilities of advanced AI conversation right to your desktop, offering a seamless and intuitive experience.

### Release Notes
```
* Fixed bugs related to focused inputs (https://github.com/huggingface/chat-macOS/issues/6), model selection (https://github.com/huggingface/chat-macOS/issues/5) and other performance issues.
* Dropped the 'Mac'. Just HuggingChat. It's cleaner. (https://github.com/huggingface/chat-macOS/issues/8)
* Added basic local model inference support for [GGUF](https://huggingface.co/docs/hub/en/gguf) with the ability to dynamically switch between local and server model using new keyboard shortcut `⌘+shift+\` (modifiable in Settings).
* Added a 'Components' pane in Settings for model download/import. 
* Added the ability to import local text files (e.g. source code and text)
* Conversations can now be set to clear at preset intervals
* Added acknowledgments section to the About section highlighting OS tools used within the app.
* Fixed app update server.
```

### Installation

1. Download the latest `HuggingChat.zip` file from this repository.
3. Unzip the downloaded file.
4. Drag the `HuggingChat.app` to your Applications folder.

That's it! You can now launch HuggingChat from your Applications folder or using the dedicated keyboard shortcut: `⌘ + Shift + Return`.

### Feedback

We value your input! If you have any suggestions, encounter issues, or want to share your experience, please feel free to reach out:

1. **Email**: Send your feedback directly to [this address](mailto:cyril.zakka@huggingface.co).

2. **Community Issues**: For bug reports or feature requests, please create an issue or discussion in this repository.

   - Provide a clear title and description of your feedback
   - Include steps to reproduce the issue (for bugs) or detailed explanation (for feature requests)
   - Include the app version number and macOS version
   - Submit the issue

Your feedback helps improve HuggingChat for everyone. Thank you for your support!