Instructions to use gawadx1/katyusha-3.5-2B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use gawadx1/katyusha-3.5-2B with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="gawadx1/katyusha-3.5-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("gawadx1/katyusha-3.5-2B") model = AutoModelForImageTextToText.from_pretrained("gawadx1/katyusha-3.5-2B") - llama-cpp-python
How to use gawadx1/katyusha-3.5-2B with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="gawadx1/katyusha-3.5-2B", filename="Qwen3.5-2B.F16-mmproj.gguf", )
llm.create_chat_completion( 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" } } ] } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use gawadx1/katyusha-3.5-2B with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf gawadx1/katyusha-3.5-2B:F16 # Run inference directly in the terminal: llama-cli -hf gawadx1/katyusha-3.5-2B:F16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf gawadx1/katyusha-3.5-2B:F16 # Run inference directly in the terminal: llama-cli -hf gawadx1/katyusha-3.5-2B:F16
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 gawadx1/katyusha-3.5-2B:F16 # Run inference directly in the terminal: ./llama-cli -hf gawadx1/katyusha-3.5-2B:F16
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 gawadx1/katyusha-3.5-2B:F16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf gawadx1/katyusha-3.5-2B:F16
Use Docker
docker model run hf.co/gawadx1/katyusha-3.5-2B:F16
- LM Studio
- Jan
- vLLM
How to use gawadx1/katyusha-3.5-2B with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "gawadx1/katyusha-3.5-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": "gawadx1/katyusha-3.5-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/gawadx1/katyusha-3.5-2B:F16
- SGLang
How to use gawadx1/katyusha-3.5-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 "gawadx1/katyusha-3.5-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": "gawadx1/katyusha-3.5-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 "gawadx1/katyusha-3.5-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": "gawadx1/katyusha-3.5-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" } } ] } ] }' - Ollama
How to use gawadx1/katyusha-3.5-2B with Ollama:
ollama run hf.co/gawadx1/katyusha-3.5-2B:F16
- Unsloth Studio new
How to use gawadx1/katyusha-3.5-2B 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 gawadx1/katyusha-3.5-2B 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 gawadx1/katyusha-3.5-2B to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for gawadx1/katyusha-3.5-2B to start chatting
- Pi new
How to use gawadx1/katyusha-3.5-2B with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf gawadx1/katyusha-3.5-2B:F16
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": "gawadx1/katyusha-3.5-2B:F16" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use gawadx1/katyusha-3.5-2B with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf gawadx1/katyusha-3.5-2B:F16
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 gawadx1/katyusha-3.5-2B:F16
Run Hermes
hermes
- Docker Model Runner
How to use gawadx1/katyusha-3.5-2B with Docker Model Runner:
docker model run hf.co/gawadx1/katyusha-3.5-2B:F16
- Lemonade
How to use gawadx1/katyusha-3.5-2B with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull gawadx1/katyusha-3.5-2B:F16
Run and chat with the model
lemonade run user.katyusha-3.5-2B-F16
List all available models
lemonade list
🩺 Radiology Assistant (Qwen3.5-2B Fine-Tuned with QLoRA)
📌 Model Overview
This model is a fine-tuned version of Qwen3.5-2B using QLoRA (4-bit) for efficient training. It is specialized for radiology-related tasks, trained on the unsloth/Radiology_mini dataset.
The goal of this model is to assist with:
- Radiology report understanding
- Medical question answering (radiology domain)
- Clinical text interpretation
⚙️ Model Details
- Base Model:
unsloth/Qwen3.5-2B - Fine-Tuning Method: QLoRA (4-bit)
- Framework: Likely Unsloth + Hugging Face Transformers
- Task Type: Instruction Fine-Tuning / Text Generation
📊 Training Configuration
Dataset
- Name:
unsloth/Radiology_mini - Split Used:
train - Subset:
default - Evaluation Split: None
Hyperparameters
- Epochs: 30
- Max Sequence Length: 2048
- Learning Rate: 2e-4
- Training Method: Parameter-Efficient Fine-Tuning (LoRA)
🚀 Intended Use
✅ Suitable for:
- Radiology Q&A systems
- Medical NLP research (radiology domain)
- Clinical report summarization
- Educational tools for radiology
❌ Not suitable for:
- Real-world medical diagnosis
- Clinical decision-making
- Use without human medical supervision
⚠️ Limitations
- Trained on a small dataset → may lack generalization
- May produce hallucinated medical facts
- Not validated for clinical accuracy
- Bias may exist depending on dataset content
🧪 Example Usage
from transformers import AutoTokenizer, AutoModelForCausalLM
model_name = "gawadx1/katyusha-3.5-2B"
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForCausalLM.from_pretrained(model_name)
prompt = "Explain what a chest X-ray showing opacity might indicate."
inputs = tokenizer(prompt, return_tensors="pt")
outputs = model.generate(**inputs, max_new_tokens=150)
print(tokenizer.decode(outputs[0], skip_special_tokens=True))
🏗️ Training Procedure
This model was trained using:
- QLoRA (4-bit quantization) for memory efficiency
- Fine-tuning only LoRA adapters instead of full model weights
- Optimized for low-resource hardware
📈 Evaluation
⚠️ No formal evaluation metrics were used.
Suggested future evaluation:
- BLEU / ROUGE for report generation
- Medical QA benchmarks
- Human expert evaluation
🤝 Acknowledgments
- Dataset:
unsloth/Radiology_mini - Base Model: Qwen team
- Training Framework: Unsloth
📜 License
Check the license of:
- Base model (Qwen3.5-2B)
- Dataset (Radiology_mini)
👨💻 Author
- Gawadx1
🔥 Future Improvements
- Add evaluation dataset
- Train on larger medical datasets
- Add safety alignment (RLHF / DPO)
- Improve hallucination control
- Downloads last month
- 104
4-bit