unsloth/.github/ISSUE_TEMPLATE/bug---issue.md
2026-08-13 04:13:23 -07:00

3.1 KiB

name about title labels assignees
Bug / Issue Bug / Issue [Bug] Please fill in your issue title here. bug, feature request

name: Unsloth Studio Bug about: Report a problem with the Unsloth Studio desktop app or web UI title: "[Studio Bug] " labels: bug assignees: ""

Environment

Where are you using Unsloth?

  • Studio desktop application
  • Studio web UI (unsloth studio)
  • Unsloth CLI
  • Python package or notebook
  • Colab or Kaggle

Operating system and version:

GPU model(s) and accelerator backend:

Versions:

What happened?

Steps to reproduce:

Expected behavior:

Actual behavior:

Model and operation involved:

Diagnostics and logs

Desktop application

Click Copy Diagnostics on the error, startup, or update screen and paste the result below:

PASTE COPY DIAGNOSTICS HERE

If Copy Diagnostics is unavailable, attach the newest relevant files from:

  • Windows: %USERPROFILE%\.unsloth\studio\
  • Linux/macOS: ~/.unsloth/studio/

Useful files include:

  • tauri.log and, if relevant, tauri.log.1
  • logs/install-*.log, logs/update-*.log, logs/repair-*.log, or logs/backend-*.log
  • The newest logs/server/server-*.log

Studio web UI

Attach the newest relevant items:

  • Linux/macOS/Windows: ~/.unsloth/studio/logs/server/server-*.log (use %USERPROFILE%\.unsloth\studio\logs\server\ on Windows)
  • Linux/macOS shortcut launches only: ~/.local/share/unsloth/studio.log
  • Terminal output if Studio was launched from a terminal
  • Browser Console errors for browser-only problems

If you configured UNSLOTH_STUDIO_HOME or STUDIO_HOME, look under <CUSTOM_STUDIO_HOME>/logs/ instead.

Model-specific logs, if applicable

  • GGUF/llama.cpp: newest ~/.unsloth/studio/logs/llama-server/*.log
  • Diffusion GGUF: newest ~/.unsloth/studio/logs/diffusion-server/*.log
  • Training resume/checkpoint bug: relevant trainer_state.json

Python package or notebook, if applicable

Paste the complete traceback and minimal reproduction:

# Remove all tokens and private data.

Also include Python, Unsloth, unsloth_zoo, PyTorch, Transformers, and TRL versions, plus nvidia-smi output when applicable.

Additional context