README.md

---
title: README
emoji: 🦀
colorFrom: pink
colorTo: blue
sdk: static
pinned: false
---

# Welcome To KoboldCpp

![image/png](https://cdn-uploads.huggingface.co/production/uploads/63cd4b6d1c8a5d1d7d76a778/VWhfbNXd4dCCAHAoooJM2.png)

These repositories contain resources related to help newbies get started with KoboldCPP. 

First - you need to obtain KoboldCpp. You can do so by downloading it from the [KoboldCpp Github releases](https://github.com/LostRuins/koboldcpp/releases/latest)
Linux, Windows and MacOS are supported - pick the correct binary for your OS.

Next, you'll need to get a GGUF model. In the [kcppt repo](https://huggingface.co/koboldcpp/kcppt/tree/main) there are predefined templates for some popular models, loading them into koboldcpp will automatically download and load all the correct files required.
You can also find other GGUF models by searching around Huggingface. 
Finally, launch KoboldCpp, and it should open a Web UI in your browser. Enjoy!

## **Other repos here:**  
[kcppt](https://huggingface.co/koboldcpp/kcppt) - Contains premade KoboldCpp quick launch templates described above  
[tts](https://huggingface.co/koboldcpp/tts) - Contains text to speech models for KoboldCpp  
[whisper](https://huggingface.co/koboldcpp/whisper) - Contains voice recognition (transcriber) models for KoboldCpp  
[imgmodel](https://huggingface.co/koboldcpp/imgmodel) - Contains some sample stable diffusion models that work in KoboldCpp (many more work too)  
[mmproj](https://huggingface.co/koboldcpp/mmproj) - Contains multimodal projectors (mmproj) for Vision models to use in KoboldCpp (image recognition)  

If you ever get lost or have questions, check out the Wiki at https://github.com/LostRuins/koboldcpp/wiki or come to our discord at https://koboldai.org/discord