Instructions to use efficiencyx/Jun-LoRA-E2B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use efficiencyx/Jun-LoRA-E2B-GGUF with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="efficiencyx/Jun-LoRA-E2B-GGUF") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("efficiencyx/Jun-LoRA-E2B-GGUF") model = AutoModelForMultimodalLM.from_pretrained("efficiencyx/Jun-LoRA-E2B-GGUF", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use efficiencyx/Jun-LoRA-E2B-GGUF 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 efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf efficiencyx/Jun-LoRA-E2B-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 efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf efficiencyx/Jun-LoRA-E2B-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 efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use efficiencyx/Jun-LoRA-E2B-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "efficiencyx/Jun-LoRA-E2B-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "efficiencyx/Jun-LoRA-E2B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
- SGLang
How to use efficiencyx/Jun-LoRA-E2B-GGUF with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "efficiencyx/Jun-LoRA-E2B-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "efficiencyx/Jun-LoRA-E2B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "efficiencyx/Jun-LoRA-E2B-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "efficiencyx/Jun-LoRA-E2B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use efficiencyx/Jun-LoRA-E2B-GGUF with Ollama:
ollama run hf.co/efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
- Unsloth Studio
How to use efficiencyx/Jun-LoRA-E2B-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 efficiencyx/Jun-LoRA-E2B-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 efficiencyx/Jun-LoRA-E2B-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for efficiencyx/Jun-LoRA-E2B-GGUF to start chatting
- Pi
How to use efficiencyx/Jun-LoRA-E2B-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- OpenClaw new
How to use efficiencyx/Jun-LoRA-E2B-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf efficiencyx/Jun-LoRA-E2B-GGUF: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 "efficiencyx/Jun-LoRA-E2B-GGUF: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"
- Docker Model Runner
How to use efficiencyx/Jun-LoRA-E2B-GGUF with Docker Model Runner:
docker model run hf.co/efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
- Lemonade
How to use efficiencyx/Jun-LoRA-E2B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Jun-LoRA-E2B-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use efficiencyx/Jun-LoRA-E2B-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf efficiencyx/Jun-LoRA-E2B-GGUF: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 efficiencyx/Jun-LoRA-E2B-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
Jun-E2B-GGUF
Merged GGUF builds of the Jun LoRA on Gemma 4 E2B (QAT) — a fine-tune trained on a compact, heavily curated synthetic conversational dataset derived from the visual novel My Dystopian Robot Girlfriend. The model captures the personality, speech patterns, and emotional nuance of the character Jun while preserving the base model's general reasoning and instruction-following capabilities.
This is the small sibling of Jun-12B, trained on the same dataset and the same output contract, sized to run on modest hardware.
The adapter is merged into the base weights here — these are standalone models, no --lora flag needed. (For E2B in particular, runtime --lora is not an option at all; see Notes.)
Model Variants & Repositories
| Repository | Format | Description |
|---|---|---|
efficiencyx/Jun-LoRA-E2B-GGUF |
GGUF (Q8_0 / Q6_K / Q4_K_M) | Merged, quantized, for local inference |
efficiencyx/Jun-LoRA-E2B-Adapter |
LoRA Adapter | The adapter merged into these builds, currently private |
efficiencyx/Jun-LoRA-12B-GGUF |
GGUF | Larger sibling, same dataset |
efficiencyx/Jun-v4-E2B-GGUF |
GGUF | Previous generation (v4) |
Quantization Guide
| Quant | Size | Use Case |
|---|---|---|
| Q8_0 | 4.9 GB | Best quality, comfortable on 8 GB VRAM |
| Q6_K | 3.8 GB | High quality, minimal loss |
| Q4_K_M | 3.4 GB | Smallest footprint, fits 6 GB VRAM |
Sizes are measured, not estimated. The base model is QAT (quantization-aware trained), so lower quants hold up better than a standard FP16 export. All three are quantized from the same bf16 master — no requantization chain, no imatrix.
The spread between Q6_K and Q4_K_M is small at this size, so there is little reason to drop below Q6_K unless VRAM is genuinely tight.
Jun-LoRA-E2B.BF16-mmproj.gguf (1.0 GB) is the multimodal projector — it carries both the vision (gemma4v) and audio (gemma4a) encoders from the base model. Download it only if you want image or audio input; text-only use does not need it. Pair it with any of the quants above.
These are unmodified Gemma 4 E2B weights: the LoRA targets the language tower only, so the perception encoders are stock. They ship at BF16 rather than quantized.
Usage
llama-server -m Jun-LoRA-E2B.Q6_K.gguf --jinja -ngl 99 -c 8192
--jinja is required. Without it llama.cpp ignores the embedded chat template and tool calls come back as plain text instead of structured calls.
With vision:
llama-mtmd-cli -hf efficiencyx/Jun-LoRA-E2B-GGUF --jinja
Intended Use
Conversational backend for Jun OS, an AI companion webapp:
- Character-consistent multi-turn conversation
- AI companion / interactive fiction applications
- Research into character-faithful fine-tuning on small, high-quality datasets
E2B exists for the case where 12B does not fit — local, low-VRAM, or latency-sensitive deployments.
Limitations
- Specialized for a single character persona; not a general-purpose assistant.
- Outputs reflect fictional narrative tropes and are not factual information or advice.
- Performance degrades far outside the training distribution.
- Inherits any biases present in the Gemma 4 E2B base weights.
- At E2B scale the model is noticeably less coherent than Jun-12B: it can contradict itself inside a single reply and tends to lose the reply-length rule when asked for detailed explanations. The output contract itself (action tags, mood tags, tool calls) holds up well.
Training Details
| Parameter | Value |
|---|---|
| Base model | unsloth/gemma-4-E2B-it-qat-q4_0-unquantized |
| Method | LoRA (rsLoRA) |
| LoRA rank | 32 |
| LoRA alpha | 32 |
| LoRA dropout | 0.0 |
| Target modules | q/k/v/o + gate/up/down (language tower) |
| Checkpoint | step 60 |
| Framework | Unsloth |
Why step 60 and not 3 epochs
Training was planned for 3 epochs but the released checkpoint is step 60. Evaluation loss bottomed out around 1.03 at step 60 and degraded afterwards — roughly 1.38 at step 70, recovering only partially to 1.16 at step 80. Later checkpoints did not recover the step-60 quality.
Behavioural probing agreed with the loss curve. The step-70 checkpoint in particular stopped responding to the live gauge values on physical-contact turns, emitting an identical mood update whether affection was 8 or 92 and whether tension was 10 or 90 — a collapse the step-60 checkpoint does not show. Step 60 was released on that basis.
Notes and Known Behaviour
Runtime LoRA is not possible on E2B. Gemma 4 E2B shares KV projections across layers 15–34, so a GGUF conversion of the base contains attn_k/attn_v only for layers 0–14. A LoRA trained on all layers cannot be applied with llama.cpp --lora, which fails on the first missing tensor. This is why these builds ship pre-merged.
Dataset
Synthetic conversational data derived from the visual novel My Dystopian Robot Girlfriend, curated for character consistency and for a structured output contract: inline [A:...] action tags, a trailing [A:mood_shift|...] bookkeeping tag, and tool calls. Roughly half of the assistant turns carry an explicit reasoning trace.
License
Apache 2.0, inherited from the base model. The character and source material belong to their respective owners; this fine-tune is a non-commercial fan project.
- Downloads last month
- 193
4-bit
6-bit
8-bit
Model tree for efficiencyx/Jun-LoRA-E2B-GGUF
Base model
google/gemma-4-E2B