Instructions to use QuantFactory/Wayfarer-2-12B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use QuantFactory/Wayfarer-2-12B-GGUF with Transformers:
# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("QuantFactory/Wayfarer-2-12B-GGUF", dtype="auto") - llama-cpp-python
How to use QuantFactory/Wayfarer-2-12B-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="QuantFactory/Wayfarer-2-12B-GGUF", filename="Wayfarer-2-12B.Q2_K.gguf", )
output = llm( "Once upon a time,", max_tokens=512, echo=True ) print(output)
- Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use QuantFactory/Wayfarer-2-12B-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M # Run inference directly in the terminal: llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use QuantFactory/Wayfarer-2-12B-GGUF with Ollama:
ollama run hf.co/QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
- Unsloth Studio new
How to use QuantFactory/Wayfarer-2-12B-GGUF with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for QuantFactory/Wayfarer-2-12B-GGUF to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for QuantFactory/Wayfarer-2-12B-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for QuantFactory/Wayfarer-2-12B-GGUF to start chatting
- Docker Model Runner
How to use QuantFactory/Wayfarer-2-12B-GGUF with Docker Model Runner:
docker model run hf.co/QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
- Lemonade
How to use QuantFactory/Wayfarer-2-12B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull QuantFactory/Wayfarer-2-12B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Wayfarer-2-12B-GGUF-Q4_K_M
List all available models
lemonade list
Install from WinGet (Windows)
winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:# Run inference directly in the terminal:
llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF:Use pre-built binary
# Download pre-built binary from:
# https://github.com/ggerganov/llama.cpp/releases# Start a local OpenAI-compatible server with a web UI:
./llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:# Run inference directly in the terminal:
./llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF:Build from source code
git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-server llama-cli# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:# Run inference directly in the terminal:
./build/bin/llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF:Use Docker
docker model run hf.co/QuantFactory/Wayfarer-2-12B-GGUF:QuantFactory/Wayfarer-2-12B-GGUF
This is quantized version of LatitudeGames/Wayfarer-2-12B created using llama.cpp
Original Model Card
Wayfarer-2-12B
We’ve heard over and over from AI Dungeon players that modern AI models are too nice, never letting them fail or die. While it may be good for a chatbot to be nice and helpful, great stories and games aren’t all rainbows and unicorns. They have conflict, tension, and even death. These create real stakes and consequences for characters and the journeys they go on. We created Wayfarer as a response, and after much testing, feedback and refining, we’ve developed a worthy sequel.
Wayfarer 2 further refines the formula that made the original Wayfarer so popular, slowing the pacing, increasing the length and detail of responses and making death a distinct possibility for all characters—not just the user. The stakes have never been higher!
If you want to try this model for free, you can do so at https://aidungeon.com.
We plan to continue improving and open-sourcing similar models, so please share any and all feedback on how we can improve model behavior. Below we share more details on how Wayfarer was created.
Quantized GGUF weights can be downloaded here.
Model details
Wayfarer 2 12B received SFT training with a simple three ingredient recipe: the Wayfarer 2 dataset itself, a series of sentiment-balanced roleplay transcripts and a small instruct core to help retain its instructional capabilities.
How It Was Made
Wayfarer’s text adventure data was generated by simulating playthroughs of published character creator scenarios from AI Dungeon. Five distinct user archetypes played through each scenario, whose character starts all varied in faction, location, etc. to generate five unique samples.
One language model played the role of narrator, with the other playing the user. They were blind to each other’s underlying logic, so the user was actually capable of surprising the narrator with their choices. Each simulation was allowed to run for 8k tokens or until the main character died.
Wayfarer’s general emotional sentiment is one of pessimism, where failure is frequent and plot armor does not exist for anyone. This serves to counter the positivity bias so inherent in our language models nowadays.
Inference
The Nemo architecture is known for being sensitive to higher temperatures, so the following settings are recommended as a baseline. Nothing stops you from experimenting with these, of course.
"temperature": 0.8,
"repetition_penalty": 1.05,
"min_p": 0.025
Limitations
Wayfarer was trained exclusively on second-person present tense data (using “you”) in a narrative style. Other perspectives will work as well but may produce suboptimal results.
Prompt Format
ChatML was used for both finetuning stages.
<|im_start|>system
You're a masterful storyteller and gamemaster. Write in second person present tense (You are), crafting vivid, engaging narratives with authority and confidence.<|im_end|>
<|im_start|>user
> You peer into the darkness.<|im_end|>
<|im_start|>assistant
You have been eaten by a grue.
GAME OVER<|im_end|>
Credits
Thanks to Gryphe Padar for collaborating on this finetune with us!
- Downloads last month
- 48
2-bit
3-bit
4-bit
5-bit
6-bit
8-bit
Model tree for QuantFactory/Wayfarer-2-12B-GGUF
Base model
mistralai/Mistral-Nemo-Base-2407
Install from brew
# Start a local OpenAI-compatible server with a web UI: llama-server -hf QuantFactory/Wayfarer-2-12B-GGUF:# Run inference directly in the terminal: llama-cli -hf QuantFactory/Wayfarer-2-12B-GGUF: