Skip to content

Troubleshooting

Sudhanshu edited this page Nov 11, 2026 · 1 revision

Troubleshooting

Symptom Resolution
JSONDecodeError on Alien data Use normalized data/alien_romulus_qa.jsonl, not the pretty-printed original in data.zip.
No such file: requirements.txt Use the packaged root, which contains normalized requirements.txt. The uploaded file had a space before .txt.
ModuleNotFoundError: trl / ORPOTrainer imports Use legacy virtual environment, pinned trl==0.8.6; do not mix with Transformers 5.x.
CUDA unavailable / CPU wheel Check python -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available())"; choose supported CUDA wheel.
CUDA out of memory Lower Qwen max length; reduce batch size; use a larger accelerator; use CPU only for a small demonstration.
ipykernel_launcher.py unexpected arguments Use notebook cells and main([...]); do not pass kernel args to CLI parser.
Cannot execute publish-wiki.ps1 Use scripts\publish-wiki.cmd, which starts a single process with a local execution-policy override.
Git clone of .wiki.git fails Enable Wiki and create first Home page on GitHub; check URL and write permissions.
PowerShell $HOME is read-only Provided script uses $homePagePath and does not assign $HOME or $home.

For artifact paths and requirements, see Repository Structure and Installation.

Clone this wiki locally