Text Generation
Transformers
Safetensors
PyTorch
English
mistral3
image-text-to-text
reasoning
coding
math
science
instruction-tuned
mistral
conversational
Instructions to use Surpem/Supertron2-24B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Surpem/Supertron2-24B with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="Surpem/Supertron2-24B") 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("Surpem/Supertron2-24B") model = AutoModelForImageTextToText.from_pretrained("Surpem/Supertron2-24B") 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]:])) - Inference
- Notebooks
- Google Colab
- Kaggle
- Local Apps
- vLLM
How to use Surpem/Supertron2-24B with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Surpem/Supertron2-24B" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Surpem/Supertron2-24B", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Surpem/Supertron2-24B
- SGLang
How to use Surpem/Supertron2-24B 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 "Surpem/Supertron2-24B" \ --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": "Surpem/Supertron2-24B", "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 "Surpem/Supertron2-24B" \ --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": "Surpem/Supertron2-24B", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use Surpem/Supertron2-24B with Docker Model Runner:
docker model run hf.co/Surpem/Supertron2-24B
| {#- Default system message if no system prompt is passed. #} | |
| {%- set default_system_message = '' %} | |
| {#- Begin of sequence token. #} | |
| {{- bos_token }} | |
| {#- Handle system prompt if it exists. #} | |
| {#- System prompt supports text content or text chunks. #} | |
| {%- if messages[0]['role'] == 'system' %} | |
| {{- '[SYSTEM_PROMPT]' -}} | |
| {%- if messages[0]['content'] is string %} | |
| {{- messages[0]['content'] -}} | |
| {%- else %} | |
| {%- for block in messages[0]['content'] %} | |
| {%- if block['type'] == 'text' %} | |
| {{- block['text'] }} | |
| {%- else %} | |
| {{- raise_exception('Only text chunks are supported in system message contents.') }} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- endif %} | |
| {{- '[/SYSTEM_PROMPT]' -}} | |
| {%- set loop_messages = messages[1:] %} | |
| {%- else %} | |
| {%- set loop_messages = messages %} | |
| {%- if default_system_message != '' %} | |
| {{- '[SYSTEM_PROMPT]' + default_system_message + '[/SYSTEM_PROMPT]' }} | |
| {%- endif %} | |
| {%- endif %} | |
| {#- Tools definition #} | |
| {%- set tools_definition = '' %} | |
| {%- set has_tools = false %} | |
| {%- if tools is defined and tools is not none and tools|length > 0 %} | |
| {%- set has_tools = true %} | |
| {%- set tools_definition = '[AVAILABLE_TOOLS]' + (tools| tojson) + '[/AVAILABLE_TOOLS]' %} | |
| {{- tools_definition }} | |
| {%- endif %} | |
| {#- Checks for alternating user/assistant messages. #} | |
| {%- set ns = namespace(index=0) %} | |
| {%- for message in loop_messages %} | |
| {%- if message.role == 'user' or (message.role == 'assistant' and (message.tool_calls is not defined or message.tool_calls is none or message.tool_calls | length == 0)) %} | |
| {%- if (message['role'] == 'user') != (ns.index % 2 == 0) %} | |
| {{- raise_exception('After the optional system message, conversation roles must alternate user and assistant roles except for tool calls and results.') }} | |
| {%- endif %} | |
| {%- set ns.index = ns.index + 1 %} | |
| {%- endif %} | |
| {%- endfor %} | |
| {#- Handle conversation messages. #} | |
| {%- for message in loop_messages %} | |
| {#- User messages supports text content or text and image chunks. #} | |
| {%- if message['role'] == 'user' %} | |
| {%- if message['content'] is string %} | |
| {{- '[INST]' + message['content'] + '[/INST]' }} | |
| {%- elif message['content'] | length > 0 %} | |
| {{- '[INST]' }} | |
| {%- if message['content'] | length == 2 %} | |
| {%- set blocks = message['content'] | sort(attribute='type') %} | |
| {%- else %} | |
| {%- set blocks = message['content'] %} | |
| {%- endif %} | |
| {%- for block in blocks %} | |
| {%- if block['type'] == 'text' %} | |
| {{- block['text'] }} | |
| {%- elif block['type'] in ['image', 'image_url'] %} | |
| {{- '[IMG]' }} | |
| {%- else %} | |
| {{- raise_exception('Only text, image and image_url chunks are supported in user message content.') }} | |
| {%- endif %} | |
| {%- endfor %} | |
| {{- '[/INST]' }} | |
| {%- else %} | |
| {{- raise_exception('User message must have a string or a list of chunks in content') }} | |
| {%- endif %} | |
| {#- Assistant messages supports text content or text and image chunks. #} | |
| {%- elif message['role'] == 'assistant' %} | |
| {%- if (message['content'] is none or message['content'] == '' or message['content']|length == 0) and (message['tool_calls'] is not defined or message['tool_calls'] is none or message['tool_calls']|length == 0) %} | |
| {{- raise_exception('Assistant message must have a string or a list of chunks in content or a list of tool calls.') }} | |
| {%- endif %} | |
| {%- if message['content'] is string %} | |
| {{- message['content'] }} | |
| {%- elif message['content'] | length > 0 %} | |
| {%- for block in message['content'] %} | |
| {%- if block['type'] == 'text' %} | |
| {{- block['text'] }} | |
| {%- else %} | |
| {{- raise_exception('Only text chunks are supported in assistant message contents.') }} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- endif %} | |
| {%- if message['tool_calls'] is defined and message['tool_calls'] is not none and message['tool_calls']|length > 0 %} | |
| {%- for tool in message['tool_calls'] %} | |
| {%- set arguments = tool['function']['arguments'] %} | |
| {%- if arguments is not string %} | |
| {%- set arguments = arguments|tojson|safe %} | |
| {%- elif arguments == '' %} | |
| {%- set arguments = '{}' %} | |
| {%- endif %} | |
| {{- '[TOOL_CALLS]' + tool['function']['name'] + '[ARGS]' + arguments }} | |
| {%- endfor %} | |
| {%- endif %} | |
| {#- End of sequence token for each assistant messages. #} | |
| {{- eos_token }} | |
| {#- Tool messages only supports text content. #} | |
| {%- elif message['role'] == 'tool' %} | |
| {{- '[TOOL_RESULTS]' + message['content']|string + '[/TOOL_RESULTS]' }} | |
| {#- Raise exception for unsupported roles. #} | |
| {%- else %} | |
| {{- raise_exception('Only user, assistant and tool roles are supported, got ' + message['role'] + '.') }} | |
| {%- endif %} | |
| {%- endfor %} |