Text Generation
Safetensors
GGUF
Chinese
English
patient-education
qa
rag
qwen3
lora
retrieval-augmented-generation
conversational
Instructions to use chenhaodev/patient-edu-qa 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 chenhaodev/patient-edu-qa 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 chenhaodev/patient-edu-qa:Q8_0 # Run inference directly in the terminal: llama cli -hf chenhaodev/patient-edu-qa:Q8_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf chenhaodev/patient-edu-qa:Q8_0 # Run inference directly in the terminal: llama cli -hf chenhaodev/patient-edu-qa:Q8_0
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 chenhaodev/patient-edu-qa:Q8_0 # Run inference directly in the terminal: ./llama-cli -hf chenhaodev/patient-edu-qa:Q8_0
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 chenhaodev/patient-edu-qa:Q8_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf chenhaodev/patient-edu-qa:Q8_0
Use Docker
docker model run hf.co/chenhaodev/patient-edu-qa:Q8_0
- LM Studio
- Jan
- vLLM
How to use chenhaodev/patient-edu-qa with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "chenhaodev/patient-edu-qa" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "chenhaodev/patient-edu-qa", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/chenhaodev/patient-edu-qa:Q8_0
- Ollama
How to use chenhaodev/patient-edu-qa with Ollama:
ollama run hf.co/chenhaodev/patient-edu-qa:Q8_0
- Unsloth Desktop
- Pi
How to use chenhaodev/patient-edu-qa with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf chenhaodev/patient-edu-qa:Q8_0
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": "chenhaodev/patient-edu-qa:Q8_0" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use chenhaodev/patient-edu-qa with Docker Model Runner:
docker model run hf.co/chenhaodev/patient-edu-qa:Q8_0
- Lemonade
How to use chenhaodev/patient-edu-qa with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull chenhaodev/patient-edu-qa:Q8_0
Run and chat with the model
lemonade run user.patient-edu-qa-Q8_0
List all available models
lemonade list
- Hermes Agent
How to use chenhaodev/patient-edu-qa with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf chenhaodev/patient-edu-qa:Q8_0
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 chenhaodev/patient-edu-qa:Q8_0
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use chenhaodev/patient-edu-qa with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf chenhaodev/patient-edu-qa:Q8_0
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 "chenhaodev/patient-edu-qa:Q8_0" \ --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"
Download scripts/build_multi_rag.py from chenhaodev/patient-edu-qa: direct link, hf CLI and curl.
- Browser
- Download file 3.18 kB
-
https://huggingface.co/chenhaodev/patient-edu-qa/resolve/main/scripts/build_multi_rag.py
- Command line
-
hf download hf://chenhaodev/patient-edu-qa/scripts/build_multi_rag.py
-
curl -L -o build_multi_rag.py https://huggingface.co/chenhaodev/patient-edu-qa/resolve/main/scripts/build_multi_rag.py
3.18 kB
| #!/usr/bin/env python3 | |
| """Build per-category FAISS indexes (multi-RAG) from UpToDate patient Q&A. | |
| One index per category (30). Each doc = question + answer (English UpToDate). | |
| Query language = Chinese (patients) -> use a multilingual embedding model. | |
| """ | |
| import json | |
| import os | |
| import numpy as np | |
| os.environ.setdefault("HF_ENDPOINT", "https://hf-mirror.com") | |
| ROOT = "/workspace/TASK18" | |
| QA = os.path.join(ROOT, "data/patient_education_qa.jsonl") | |
| OUT = os.path.join(ROOT, "data/rag") | |
| MODEL_NAME = "BAAI/bge-m3" # multilingual (zh query -> en docs) | |
| os.makedirs(OUT, exist_ok=True) | |
| from sentence_transformers import SentenceTransformer | |
| import faiss | |
| model = SentenceTransformer(MODEL_NAME) | |
| model.max_seq_length = 512 | |
| print("model loaded:", MODEL_NAME, "| device:", model.device, flush=True) | |
| rows = [json.loads(l) for l in open(QA, encoding="utf-8")] | |
| # group by category | |
| from collections import defaultdict | |
| bycat = defaultdict(list) | |
| for r in rows: | |
| bycat[r["category"]].append(r) | |
| print("categories:", len(bycat), flush=True) | |
| per_cat_stats = {} | |
| for cat, items in bycat.items(): | |
| # dedup by question within category | |
| seen = set() | |
| uniq = [] | |
| for r in items: | |
| if r["question"] in seen: | |
| continue | |
| seen.add(r["question"]) | |
| uniq.append(r) | |
| docs = [] | |
| meta = [] | |
| for r in uniq: | |
| d = f"{r['question']}\n{r['answer']}" | |
| docs.append(d) | |
| meta.append({"slug": r["slug"], "id": r["id"], "question": r["question"], | |
| "title": r["title"], "level": r["level"], "category": cat}) | |
| emb = model.encode(docs, normalize_embeddings=True, | |
| show_progress_bar=True, batch_size=64) | |
| emb = np.asarray(emb, dtype="float32") | |
| idx = faiss.IndexFlatIP(emb.shape[1]) | |
| idx.add(emb) | |
| sub = os.path.join(OUT, cat) | |
| os.makedirs(sub, exist_ok=True) | |
| faiss.write_index(idx, os.path.join(sub, "index.faiss")) | |
| with open(os.path.join(sub, "docs.json"), "w", encoding="utf-8") as f: | |
| json.dump(docs, f, ensure_ascii=False) | |
| with open(os.path.join(sub, "meta.json"), "w", encoding="utf-8") as f: | |
| json.dump(meta, f, ensure_ascii=False) | |
| per_cat_stats[cat] = len(uniq) | |
| print(f" [{cat}] docs={len(uniq)}", flush=True) | |
| with open(os.path.join(OUT, "index_map.json"), "w", encoding="utf-8") as f: | |
| json.dump(per_cat_stats, f, ensure_ascii=False, indent=1) | |
| # ---- sanity: multilingual cross-lingual query ---- | |
| print("\n=== cross-lingual sanity (Chinese query -> English docs) ===") | |
| q = "我最近2周一直头疼,有什么免吃药的方法缓解" | |
| qe = model.encode([q], normalize_embeddings=True) | |
| for cat in ["brain-and-nerves", "gastrointestinal-system"]: | |
| sub = os.path.join(OUT, cat) | |
| if not os.path.exists(os.path.join(sub, "index.faiss")): | |
| continue | |
| idx = faiss.read_index(os.path.join(sub, "index.faiss")) | |
| meta = json.load(open(os.path.join(sub, "meta.json"), encoding="utf-8")) | |
| docs = json.load(open(os.path.join(sub, "docs.json"), encoding="utf-8")) | |
| D, I = idx.search(qe, 3) | |
| print(f"\n-- category: {cat} --") | |
| for d, i in zip(D[0], I[0]): | |
| print(f" score={d:.3f} | {meta[i]['question'][:70]}") | |