README.md

---
license: apache-2.0
library_name: transformers
tags:
- chemistry
- biology
- code
- medical
- not-for-all-audiences
- TensorBlock
- GGUF
datasets:
- Locutusque/Hercules-v3.0
base_model: Locutusque/Hercules-3.1-Mistral-7B
model-index:
- name: Hercules-3.1-Mistral-7B
  results:
  - task:
      type: text-generation
      name: Text Generation
    dataset:
      name: AI2 Reasoning Challenge (25-Shot)
      type: ai2_arc
      config: ARC-Challenge
      split: test
      args:
        num_few_shot: 25
    metrics:
    - type: acc_norm
      value: 61.18
      name: normalized accuracy
    source:
      url: https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=Locutusque/Hercules-3.1-Mistral-7B
      name: Open LLM Leaderboard
  - task:
      type: text-generation
      name: Text Generation
    dataset:
      name: HellaSwag (10-Shot)
      type: hellaswag
      split: validation
      args:
        num_few_shot: 10
    metrics:
    - type: acc_norm
      value: 83.55
      name: normalized accuracy
    source:
      url: https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=Locutusque/Hercules-3.1-Mistral-7B
      name: Open LLM Leaderboard
  - task:
      type: text-generation
      name: Text Generation
    dataset:
      name: MMLU (5-Shot)
      type: cais/mmlu
      config: all
      split: test
      args:
        num_few_shot: 5
    metrics:
    - type: acc
      value: 63.65
      name: accuracy
    source:
      url: https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=Locutusque/Hercules-3.1-Mistral-7B
      name: Open LLM Leaderboard
  - task:
      type: text-generation
      name: Text Generation
    dataset:
      name: TruthfulQA (0-shot)
      type: truthful_qa
      config: multiple_choice
      split: validation
      args:
        num_few_shot: 0
    metrics:
    - type: mc2
      value: 42.83
    source:
      url: https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=Locutusque/Hercules-3.1-Mistral-7B
      name: Open LLM Leaderboard
  - task:
      type: text-generation
      name: Text Generation
    dataset:
      name: Winogrande (5-shot)
      type: winogrande
      config: winogrande_xl
      split: validation
      args:
        num_few_shot: 5
    metrics:
    - type: acc
      value: 79.01
      name: accuracy
    source:
      url: https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=Locutusque/Hercules-3.1-Mistral-7B
      name: Open LLM Leaderboard
  - task:
      type: text-generation
      name: Text Generation
    dataset:
      name: GSM8k (5-shot)
      type: gsm8k
      config: main
      split: test
      args:
        num_few_shot: 5
    metrics:
    - type: acc
      value: 42.3
      name: accuracy
    source:
      url: https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=Locutusque/Hercules-3.1-Mistral-7B
      name: Open LLM Leaderboard
---

<div style="width: auto; margin-left: auto; margin-right: auto">
<img src="https://i.imgur.com/jC7kdl8.jpeg" alt="TensorBlock" style="width: 100%; min-width: 400px; display: block; margin: auto;">
</div>
<div style="display: flex; justify-content: space-between; width: 100%;">
    <div style="display: flex; flex-direction: column; align-items: flex-start;">
        <p style="margin-top: 0.5em; margin-bottom: 0em;">
            Feedback and support: TensorBlock's  <a href="https://x.com/tensorblock_aoi">Twitter/X</a>, <a href="https://t.me/TensorBlock">Telegram Group</a> and <a href="https://x.com/tensorblock_aoi">Discord server</a>
        </p>
    </div>
</div>

## Locutusque/Hercules-3.1-Mistral-7B - GGUF

This repo contains GGUF format model files for [Locutusque/Hercules-3.1-Mistral-7B](https://huggingface.co/Locutusque/Hercules-3.1-Mistral-7B).

The files were quantized using machines provided by [TensorBlock](https://tensorblock.co/), and they are compatible with llama.cpp as of [commit b4011](https://github.com/ggerganov/llama.cpp/commit/a6744e43e80f4be6398fc7733a01642c846dce1d).


<div style="text-align: left; margin: 20px 0;">
    <a href="https://tensorblock.co/waitlist/client" style="display: inline-block; padding: 10px 20px; background-color: #007bff; color: white; text-decoration: none; border-radius: 5px; font-weight: bold;">
        Run them on the TensorBlock client using your local machine ↗
    </a>
</div>

## Prompt template


```

```

## Model file specification

| Filename | Quant type | File Size | Description |
| -------- | ---------- | --------- | ----------- |
| [Hercules-3.1-Mistral-7B-Q2_K.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q2_K.gguf) | Q2_K | 2.532 GB | smallest, significant quality loss - not recommended for most purposes |
| [Hercules-3.1-Mistral-7B-Q3_K_S.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q3_K_S.gguf) | Q3_K_S | 2.947 GB | very small, high quality loss |
| [Hercules-3.1-Mistral-7B-Q3_K_M.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q3_K_M.gguf) | Q3_K_M | 3.277 GB | very small, high quality loss |
| [Hercules-3.1-Mistral-7B-Q3_K_L.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q3_K_L.gguf) | Q3_K_L | 3.560 GB | small, substantial quality loss |
| [Hercules-3.1-Mistral-7B-Q4_0.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q4_0.gguf) | Q4_0 | 3.827 GB | legacy; small, very high quality loss - prefer using Q3_K_M |
| [Hercules-3.1-Mistral-7B-Q4_K_S.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q4_K_S.gguf) | Q4_K_S | 3.856 GB | small, greater quality loss |
| [Hercules-3.1-Mistral-7B-Q4_K_M.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q4_K_M.gguf) | Q4_K_M | 4.068 GB | medium, balanced quality - recommended |
| [Hercules-3.1-Mistral-7B-Q5_0.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q5_0.gguf) | Q5_0 | 4.654 GB | legacy; medium, balanced quality - prefer using Q4_K_M |
| [Hercules-3.1-Mistral-7B-Q5_K_S.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q5_K_S.gguf) | Q5_K_S | 4.654 GB | large, low quality loss - recommended |
| [Hercules-3.1-Mistral-7B-Q5_K_M.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q5_K_M.gguf) | Q5_K_M | 4.779 GB | large, very low quality loss - recommended |
| [Hercules-3.1-Mistral-7B-Q6_K.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q6_K.gguf) | Q6_K | 5.534 GB | very large, extremely low quality loss |
| [Hercules-3.1-Mistral-7B-Q8_0.gguf](https://huggingface.co/tensorblock/Hercules-3.1-Mistral-7B-GGUF/blob/main/Hercules-3.1-Mistral-7B-Q8_0.gguf) | Q8_0 | 7.167 GB | very large, extremely low quality loss - not recommended |


## Downloading instruction

### Command line

Firstly, install Huggingface Client

```shell
pip install -U "huggingface_hub[cli]"
```

Then, downoad the individual model file the a local directory

```shell
huggingface-cli download tensorblock/Hercules-3.1-Mistral-7B-GGUF --include "Hercules-3.1-Mistral-7B-Q2_K.gguf" --local-dir MY_LOCAL_DIR
```

If you wanna download multiple model files with a pattern (e.g., `*Q4_K*gguf`), you can try:

```shell
huggingface-cli download tensorblock/Hercules-3.1-Mistral-7B-GGUF --local-dir MY_LOCAL_DIR --local-dir-use-symlinks False --include='*Q4_K*gguf'
```