Instructions to use datamatters24/CaroleNDVoice with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use datamatters24/CaroleNDVoice with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf datamatters24/CaroleNDVoice:Q4_K_M # Run inference directly in the terminal: llama cli -hf datamatters24/CaroleNDVoice:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf datamatters24/CaroleNDVoice:Q4_K_M # Run inference directly in the terminal: llama cli -hf datamatters24/CaroleNDVoice: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 datamatters24/CaroleNDVoice:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf datamatters24/CaroleNDVoice: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 datamatters24/CaroleNDVoice:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf datamatters24/CaroleNDVoice:Q4_K_M
Use Docker
docker model run hf.co/datamatters24/CaroleNDVoice:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use datamatters24/CaroleNDVoice with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "datamatters24/CaroleNDVoice" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "datamatters24/CaroleNDVoice", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/datamatters24/CaroleNDVoice:Q4_K_M
- Ollama
How to use datamatters24/CaroleNDVoice with Ollama:
ollama run hf.co/datamatters24/CaroleNDVoice:Q4_K_M
- Unsloth Studio
How to use datamatters24/CaroleNDVoice 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 datamatters24/CaroleNDVoice 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 datamatters24/CaroleNDVoice to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for datamatters24/CaroleNDVoice to start chatting
- Pi
How to use datamatters24/CaroleNDVoice with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf datamatters24/CaroleNDVoice:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "datamatters24/CaroleNDVoice:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use datamatters24/CaroleNDVoice with Docker Model Runner:
docker model run hf.co/datamatters24/CaroleNDVoice:Q4_K_M
- Lemonade
How to use datamatters24/CaroleNDVoice with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull datamatters24/CaroleNDVoice:Q4_K_M
Run and chat with the model
lemonade run user.CaroleNDVoice-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use datamatters24/CaroleNDVoice with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf datamatters24/CaroleNDVoice:Q4_K_M
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default datamatters24/CaroleNDVoice:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use datamatters24/CaroleNDVoice with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf datamatters24/CaroleNDVoice:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "datamatters24/CaroleNDVoice:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf datamatters24/CaroleNDVoice:Q4_K_M# Run inference directly in the terminal:
llama cli -hf datamatters24/CaroleNDVoice:Q4_K_MInstall from WinGet (Windows)
winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf datamatters24/CaroleNDVoice:Q4_K_M# Run inference directly in the terminal:
llama cli -hf datamatters24/CaroleNDVoice:Q4_K_MUse 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 datamatters24/CaroleNDVoice:Q4_K_M# Run inference directly in the terminal:
./llama-cli -hf datamatters24/CaroleNDVoice:Q4_K_MBuild 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 datamatters24/CaroleNDVoice:Q4_K_M# Run inference directly in the terminal:
./build/bin/llama-cli -hf datamatters24/CaroleNDVoice:Q4_K_MUse Docker
docker model run hf.co/datamatters24/CaroleNDVoice:Q4_K_MCaroleNDVoice
A fine-tuned Llama 3.1 8B Instruct chatbot designed for neurodivergent users โ particularly those who experience rejection-sensitive dysphoria (RSD), the visceral spike that comes with criticism or perceived rejection.
Built with Llama.
Carole is a portfolio / educational project. She is named after the author's wife, who has a way of holding hard conversations: validate first, redirect with a question. The model was trained to mirror that pattern.
The live demo is at meetcarole.com (gated).
What this is
- A QLoRA fine-tune of
meta-llama/Meta-Llama-3.1-8B-Instruct - Trained on ~1,500 synthetic conversations seeded from 50 hand-written golden examples
- Quantized to Q4_K_M GGUF (~4.6GB) for inference via
llama.cpp - Deployed end-to-end with a RAG layer (ChromaDB, all-MiniLM-L6-v2 embeddings, 1,732 chunks)
The defining behavior is validate, then redirect โ not as a softener for sycophancy but as a way to deliver pushback without triggering RSD.
What this is not
- Not therapy. Not medical advice. Not a substitute for a clinician.
- Not a transformers checkpoint. This repo ships GGUF + LoRA adapter artifacts, not merged
safetensorsweights. Do not deploy as a standard Text Generation / transformers endpoint.
Files in this repo
| File | Purpose |
|---|---|
carole-q4_k_m.gguf |
Production inference artifact (llama.cpp / HF GGUF endpoint) |
final_adapter/ |
LoRA adapter (reproduce merge or fine-tune further) |
logs/ |
Training logs |
There is no root config.json โ that is expected for a GGUF repo.
Quickstart (llama.cpp)
llama-server \
--hf-repo datamatters24/CaroleNDVoice \
--hf-file carole-q4_k_m.gguf \
--host 127.0.0.1 --port 8085 \
--ctx-size 4096
Then POST to http://127.0.0.1:8085/v1/chat/completions with an OpenAI-compatible payload.
Hugging Face Inference Endpoint
Do not create a transformers Text Generation endpoint โ it will fail looking for config.json and weight shards.
Instead:
- Open Inference Endpoints
- New endpoint โ repo
datamatters24/CaroleNDVoice - Engine: GGUF / llama.cpp (auto-selected when a
.gguffile is present) - GGUF file:
carole-q4_k_m.gguf - Hardware: GPU recommended (e.g. L4 / T4 โ ~6GB+ VRAM for Q4 8B)
- Deploy โ OpenAI-compatible URL at
/v1/chat/completions
Use that URL with Vercel AI SDK (@ai-sdk/huggingface) or the Vercel Connect integration.
Training
| Setting | Value |
|---|---|
| Base | meta-llama/Meta-Llama-3.1-8B-Instruct |
| Method | QLoRA (4-bit NF4 + LoRA) via TRL SFTTrainer |
| LoRA rank / alpha | 64 / 128 |
| Learning rate | 2e-4, cosine schedule |
| Epochs | 3, best checkpoint epoch 2 (eval_loss = 1.40) |
| Hardware | 1ร A100 80GB on RunPod |
Intended use
Educational / portfolio demonstrations of a non-sycophantic, neurodivergence-aware conversational pattern with RAG.
Out of scope
- Crisis intervention or clinical mental-health use
- Medical / legal / financial advice
- Unrestricted public deployment without rate limiting and disclaimer
License
Derivative of Meta Llama 3.1 8B Instruct under the Llama 3.1 Community License.
Built with Llama.
- Downloads last month
- 30
4-bit
Model tree for datamatters24/CaroleNDVoice
Base model
meta-llama/Llama-3.1-8B
# Gated model: Login with a HF token with gated access permission hf auth login