Instructions to use JurinAI/JJ-1-0.8B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use JurinAI/JJ-1-0.8B with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="JurinAI/JJ-1-0.8B") 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)# pip install -U transformers accelerate # Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("JurinAI/JJ-1-0.8B") model = AutoModelForMultimodalLM.from_pretrained("JurinAI/JJ-1-0.8B", device_map="auto") 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?"} ] }, ] inputs = processor.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=256) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use JurinAI/JJ-1-0.8B 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 JurinAI/JJ-1-0.8B:Q8_0 # Run inference directly in the terminal: llama cli -hf JurinAI/JJ-1-0.8B:Q8_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf JurinAI/JJ-1-0.8B:Q8_0 # Run inference directly in the terminal: llama cli -hf JurinAI/JJ-1-0.8B: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 JurinAI/JJ-1-0.8B:Q8_0 # Run inference directly in the terminal: ./llama-cli -hf JurinAI/JJ-1-0.8B: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 JurinAI/JJ-1-0.8B:Q8_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf JurinAI/JJ-1-0.8B:Q8_0
Use Docker
docker model run hf.co/JurinAI/JJ-1-0.8B:Q8_0
- LM Studio
- Jan
- vLLM
How to use JurinAI/JJ-1-0.8B with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "JurinAI/JJ-1-0.8B" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "JurinAI/JJ-1-0.8B", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/JurinAI/JJ-1-0.8B:Q8_0
- SGLang
How to use JurinAI/JJ-1-0.8B 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 "JurinAI/JJ-1-0.8B" \ --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": "JurinAI/JJ-1-0.8B", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'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 "JurinAI/JJ-1-0.8B" \ --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": "JurinAI/JJ-1-0.8B", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Ollama
How to use JurinAI/JJ-1-0.8B with Ollama:
ollama run hf.co/JurinAI/JJ-1-0.8B:Q8_0
- Unsloth Desktop
- Pi
How to use JurinAI/JJ-1-0.8B with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf JurinAI/JJ-1-0.8B: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": "JurinAI/JJ-1-0.8B:Q8_0" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use JurinAI/JJ-1-0.8B with Docker Model Runner:
docker model run hf.co/JurinAI/JJ-1-0.8B:Q8_0
- Lemonade
How to use JurinAI/JJ-1-0.8B with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull JurinAI/JJ-1-0.8B:Q8_0
Run and chat with the model
lemonade run user.JJ-1-0.8B-Q8_0
List all available models
lemonade list
- Hermes Agent
How to use JurinAI/JJ-1-0.8B with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf JurinAI/JJ-1-0.8B: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 JurinAI/JJ-1-0.8B:Q8_0
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use JurinAI/JJ-1-0.8B with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf JurinAI/JJ-1-0.8B: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 "JurinAI/JJ-1-0.8B: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"
JJ-1-0.8B
日本語 · ← Back to JJ-1 homepage · JJ-1 article: English / 日本語
Japanese business decisions from text or JSON: choices, yes/no probabilities and scores. Includes BF16, Q8_0 and inference code.
Read the full JJ-1 technical report in English or Japanese for the evaluation setup and detailed results. Register for the JJ-1 inference service.
Evaluation
BF16 results from the JJ-1 report (88,813 questions, 6 packages):
| Evaluation | Hard-label accuracy |
|---|---|
| Overall | 65.49% |
| English | 78.66% |
| Japanese | 57.34% |
| Business workflows · test + held-out | 92.31% |
Business results combine test and held-out cases. Q8_0 has not been independently benchmarked.
Six-area comparison
Comparison of the 17 models with complete results across all six areas in the report. Values are hard-label accuracy (%); Overall is weighted by question count. Soft-label questions are excluded from this table.
| Column | Evaluation area | All questions | Hard-label questions |
|---|---|---|---|
| 01 | Japanese enterprise workflows | 6,249 | 6,033 |
| 02 | News, tools & safety | 10,967 | 10,967 |
| 03 | Japanese knowledge & reasoning | 45,391 | 45,391 |
| 04 | English knowledge & classification | 22,417 | 19,115 |
| 05 | Emotion & scenario classification | 2,200 | 2,200 |
| 06 | Japanese semantic similarity | 1,589 | 447 |
| Model | Overall | 01 | 02 | 03 | 04 | 05 | 06 |
|---|---|---|---|---|---|---|---|
| JJ-1-9B | 79.20% | 97.43% | 92.17% | 72.70% | 81.31% | 80.50% | 79.19% |
| StartLux 9B | 78.02% | 90.10% | 92.36% | 71.29% | 81.73% | 80.86% | 73.60% |
| Jev 1.13 | 76.50% | 91.75% | 89.81% | 71.96% | 76.82% | 60.32% | 70.92% |
| Microsoft Decision-1 | 76.50% | 91.58% | 90.53% | 69.76% | 81.22% | 63.45% | 74.50% |
| JJ-1-4B | 75.18% | 96.17% | 90.89% | 67.29% | 78.72% | 70.41% | 78.97% |
| StartLux 4B | 74.54% | 89.34% | 91.47% | 66.55% | 79.63% | 71.68% | 67.34% |
| JPT 9B | 73.45% | 89.36% | 90.43% | 66.51% | 76.54% | 61.86% | 71.14% |
| Nimble 9B v3 | 72.00% | 89.21% | 84.95% | 65.04% | 77.08% | 60.32% | 69.13% |
| JevK5 9B | 71.77% | 87.58% | 89.09% | 65.16% | 74.15% | 58.27% | 69.35% |
| GPT-6 Luna Decisions | 71.35% | 91.99% | 86.79% | 65.07% | 72.16% | 59.41% | 75.17% |
| Jebadiah 9B v2 | 70.82% | 88.36% | 87.72% | 63.09% | 75.49% | 59.50% | 61.74% |
| JPT 4B | 70.62% | 87.15% | 90.26% | 62.32% | 75.15% | 61.86% | 57.72% |
| Kev 9B | 70.08% | 85.61% | 89.24% | 62.37% | 74.13% | 57.27% | 63.98% |
| JJ-1-2B | 68.54% | 94.63% | 87.35% | 58.19% | 73.42% | 73.00% | 75.39% |
| StartLux 2B | 68.24% | 82.51% | 89.22% | 57.78% | 75.80% | 75.55% | 63.98% |
| StartLux 0.8B | 65.64% | 76.99% | 88.91% | 53.74% | 74.44% | 88.23% | 63.31% |
| JJ-1-0.8B | 65.49% | 92.31% | 87.33% | 52.43% | 72.62% | 88.50% | 75.62% |
Column 06 is the report’s hard-label accuracy, not a semantic-similarity correlation coefficient. These are report results, not an independent Q8_0 benchmark.
Transformers
Python 3.10+:
cd JJ-1-0.8B
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[transformers]"
python example.py
from jj1 import JJ1
model = JJ1(".", images=False, device="cpu", max_length=4096)
state = "洗面所の天井から水が落ち続けています。"
questions = {
"needs_visit": {
"type": "noul",
"instructions": "現地での対応が必要ですか?"
}
}
answers, usage = model.decide(state, questions)
print(answers)
print(usage)
CLI / HTTP
From the model folder:
jj1-check .
jj1-decide --model . --device cpu --pretty examples/request.json
jj1-serve --model . --device cpu --no-images --max-length 4096 --port 8090
HTTP: POST /v1/systemone.
GGUF / llama.cpp
In the activated environment:
python -m pip install -e ".[gguf]"
llama-server -m JJ-1-0.8B-Q8_0.gguf -c 4096 --parallel 1 \
-ngl 0 --host 127.0.0.1 --port 8081 --no-webui
Second activated terminal, same folder:
python example.py --backend gguf
If 8081 is occupied, change --port and use example.py --url http://127.0.0.1:PORT.
GGUF requires llama-server; PyTorch and Transformers are unnecessary.
Build llama-server
Build outside the model folder with Git, CMake and a C++ compiler:
git clone https://github.com/ggml-org/llama.cpp
cd llama.cpp
git checkout b7dafa01e5f375c3010fb24b61a67329f957426a
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DLLAMA_OPENSSL=OFF
cmake --build build --config Release -j 4 --target llama-server
export PATH="$PWD/build/bin:$PATH"
NVIDIA CUDA
Requires CUDA PyTorch and the fast kernels:
python -m pip install -e ".[transformers,cuda]"
python example.py --device cuda
Notes and license
Text/JSON only.
Weights: CC BY-NC 4.0 (LICENSE). Code: Apache-2.0 (LICENSE-CODE). Attribution: NOTICE.
- Downloads last month
- 67