<div align="center">

# Icebreaker

[![Crates.io](https://img.shields.io/crates/v/icebreaker.svg)](https://crates.io/crates/icebreaker)
[![License](https://img.shields.io/crates/l/icebreaker.svg)](https://github.com/hecrj/icebreaker/blob/master/LICENSE)
[![Downloads](https://img.shields.io/crates/d/icebreaker.svg)](https://crates.io/crates/icebreaker)
[![Test Status](https://img.shields.io/github/actions/workflow/status/hecrj/icebreaker/test.yml?branch=master&event=push&label=test)](https://github.com/hecrj/icebreaker/actions)
[![Made with iced](https://iced.rs/badge.svg)](https://github.com/iced-rs/iced)

A local AI chat app powered by 🦀 Rust, 🧊 iced, 🤗 Hugging Face, and 🦙 llama.cpp

<img alt="Icebreaker" src="assets/showcase.gif" width="70%">

</div>

## Installation

No pre-built binaries yet! Use `cargo` to try it out:

```bash
cargo install --git https://github.com/hecrj/icebreaker.git
```

You also need either [`llama.cpp`] or [Docker] installed, for now.

[`llama.cpp`]: https://github.com/ggerganov/llama.cpp
[Docker]: https://www.docker.com/


## Why "Icebreaker"?

[Blame Mistral!](assets/naming.png)