Image-Text-to-Text
Transformers
Safetensors
English
qwen3_5
piko
piko-9b
multimodal
vision-language
hybrid-attention
linear-attention
ocr
document-understanding
conversational
Instructions to use Dexy2/Piko-9b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Dexy2/Piko-9b with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="Dexy2/Piko-9b") 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("Dexy2/Piko-9b") model = AutoModelForMultimodalLM.from_pretrained("Dexy2/Piko-9b", 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=40) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use Dexy2/Piko-9b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Dexy2/Piko-9b" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Dexy2/Piko-9b", "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/Dexy2/Piko-9b
- SGLang
How to use Dexy2/Piko-9b 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 "Dexy2/Piko-9b" \ --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": "Dexy2/Piko-9b", "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 "Dexy2/Piko-9b" \ --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": "Dexy2/Piko-9b", "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" } } ] } ] }' - Docker Model Runner
How to use Dexy2/Piko-9b with Docker Model Runner:
docker model run hf.co/Dexy2/Piko-9b
File size: 4,124 Bytes
0810902 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 | #!/usr/bin/env python3
"""Batched text generation with Piko-9b.
python examples/inference_batch.py --prompts prompts.txt --batch-size 4
python examples/inference_batch.py --prompt "2+2?" --prompt "Capital of Peru?"
Reads one prompt per line from --prompts, and/or repeated --prompt flags.
Results are written as JSONL so they can be diffed between runs.
The tokenizer pads on the left, which is what batched decoder-only generation
needs; this script does not override it.
"""
from __future__ import annotations
import argparse
import json
import sys
import time
from pathlib import Path
import torch
from _common import add_common_arguments, generation_kwargs, load_model, strip_reasoning
def collect_prompts(args: argparse.Namespace) -> list[str]:
prompts: list[str] = list(args.prompt or [])
if args.prompts:
path = Path(args.prompts)
if not path.is_file():
sys.exit(f"Prompt file not found: {path}")
prompts += [line.strip() for line in path.read_text(encoding="utf-8").splitlines()]
prompts = [p for p in prompts if p]
if not prompts:
sys.exit("No prompts given. Use --prompt and/or --prompts.")
return prompts
def main() -> None:
parser = argparse.ArgumentParser(description=__doc__)
add_common_arguments(parser)
parser.add_argument("--prompt", action="append", help="Repeatable.")
parser.add_argument("--prompts", help="File with one prompt per line.")
parser.add_argument("--batch-size", type=int, default=2)
parser.add_argument("--system", default="You are Piko-9, an AI assistant.")
parser.add_argument("--output", type=Path, default=None)
args = parser.parse_args()
if args.batch_size < 1:
sys.exit("--batch-size must be >= 1")
prompts = collect_prompts(args)
model, processor = load_model(args.model, args.quantization, args.dtype, args.revision)
records = []
for start in range(0, len(prompts), args.batch_size):
chunk = prompts[start : start + args.batch_size]
texts = [
processor.apply_chat_template(
(
([{"role": "system", "content": args.system}] if args.system else [])
+ [{"role": "user", "content": [{"type": "text", "text": prompt}]}]
),
add_generation_prompt=True,
tokenize=False,
)
for prompt in chunk
]
inputs = processor(text=texts, return_tensors="pt", padding=True).to(model.device)
began = time.perf_counter()
try:
with torch.inference_mode():
output = model.generate(**inputs, **generation_kwargs(args))
except torch.cuda.OutOfMemoryError:
sys.exit(
f"CUDA OOM at batch size {args.batch_size}. Retry with a smaller "
"--batch-size, or a stronger --quantization."
)
elapsed = time.perf_counter() - began
prompt_length = inputs["input_ids"].shape[1]
generated = output.shape[1] - prompt_length
for index, prompt in enumerate(chunk):
answer = processor.decode(
output[index][prompt_length:], skip_special_tokens=True
).strip()
record = {
"prompt": prompt,
"response": answer if args.show_reasoning else strip_reasoning(answer),
}
records.append(record)
print(f"--- {prompt}\n{record['response']}\n")
print(
f"[batch {start // args.batch_size + 1}] {len(chunk)} prompts, "
f"{generated} new tokens each, {elapsed:.1f}s, "
f"{len(chunk) * generated / elapsed:.1f} tok/s aggregate\n",
file=sys.stderr,
)
if args.output:
args.output.parent.mkdir(parents=True, exist_ok=True)
with args.output.open("w", encoding="utf-8") as handle:
for record in records:
handle.write(json.dumps(record, ensure_ascii=False) + "\n")
print(f"wrote {args.output}", file=sys.stderr)
if __name__ == "__main__":
main()
|