Hugging Face's logo Hugging Face
  • Models
  • Datasets
  • Spaces
  • Buckets new
  • Docs
  • Enterprise
  • Pricing

  • Log In
  • Sign Up

thomasjvu
/
alkahest-2b

Image-Text-to-Text
Transformers
ONNX
Transformers.js
qwen3_5
webgpu
quantized
text
image
qwen3.5-vl
conversational
Model card Files Files and versions
xet
Community

Instructions to use thomasjvu/alkahest-2b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

  • Libraries
  • Transformers

    How to use thomasjvu/alkahest-2b with Transformers:

    # Use a pipeline as a high-level helper
    from transformers import pipeline
    
    pipe = pipeline("image-text-to-text", model="thomasjvu/alkahest-2b")
    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, AutoModelForImageTextToText
    
    processor = AutoProcessor.from_pretrained("thomasjvu/alkahest-2b")
    model = AutoModelForImageTextToText.from_pretrained("thomasjvu/alkahest-2b")
    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]:]))
  • Transformers.js

    How to use thomasjvu/alkahest-2b with Transformers.js:

    // npm i @huggingface/transformers
    import { pipeline } from '@huggingface/transformers';
    
    // Allocate pipeline
    const pipe = await pipeline('image-text-to-text', 'thomasjvu/alkahest-2b');
  • Notebooks
  • Google Colab
  • Kaggle
  • Local Apps
  • vLLM

    How to use thomasjvu/alkahest-2b with vLLM:

    Install from pip and serve model
    # Install vLLM from pip:
    pip install vllm
    # Start the vLLM server:
    vllm serve "thomasjvu/alkahest-2b"
    # Call the server using curl (OpenAI-compatible API):
    curl -X POST "http://localhost:8000/v1/chat/completions" \
    	-H "Content-Type: application/json" \
    	--data '{
    		"model": "thomasjvu/alkahest-2b",
    		"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/thomasjvu/alkahest-2b
  • SGLang

    How to use thomasjvu/alkahest-2b 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 "thomasjvu/alkahest-2b" \
        --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": "thomasjvu/alkahest-2b",
    		"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 "thomasjvu/alkahest-2b" \
            --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": "thomasjvu/alkahest-2b",
    		"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 thomasjvu/alkahest-2b with Docker Model Runner:

    docker model run hf.co/thomasjvu/alkahest-2b
alkahest-2b
Ctrl+K
Ctrl+K
  • 1 contributor
History: 5 commits
thomasjvu's picture
thomasjvu
Upload processor_config.json with huggingface_hub
43113ae verified 13 days ago
  • onnx
    Add files using upload-large-folder tool 13 days ago
  • .gitattributes
    1.79 kB
    Add files using upload-large-folder tool 25 days ago
  • README.md
    1.38 kB
    Add files using upload-large-folder tool 13 days ago
  • chat_template.jinja
    7.76 kB
    Add files using upload-large-folder tool 13 days ago
  • config.json
    2.84 kB
    Add files using upload-large-folder tool 13 days ago
  • generation_config.json
    120 Bytes
    Add files using upload-large-folder tool 13 days ago
  • package-report.json
    835 Bytes
    Add files using upload-large-folder tool 13 days ago
  • preprocessor_config.json
    390 Bytes
    Add files using upload-large-folder tool 25 days ago
  • processor_config.json
    390 Bytes
    Upload processor_config.json with huggingface_hub 13 days ago
  • tokenizer.json
    12.8 MB
    xet
    Add files using upload-large-folder tool 13 days ago
  • tokenizer_config.json
    16.7 kB
    Add files using upload-large-folder tool 13 days ago