Help
Troubleshooting
Fixes for common problems.
Overview
“None of [python3, python, py] was found on your PATH”
The language isn’t installed, or Kiln can’t see it. On Windows, click Install for me when Kiln offers it. Otherwise install it, restart Kiln, then check the Extensions view. On Windows, the “python” that opens the Microsoft Store doesn’t count — install Python from python.org and tick Add python.exe to PATH.
My browser blocked the download
Kiln builds aren’t code-signed yet, so Chrome and Edge may block them. Press Ctrl+J and choose Download suspicious file (Chrome) or Keep → Keep anyway (Edge). Details are in Installation.
Windows says “Windows protected your PC”
Click More info → Run anyway. Kiln builds aren’t code-signed yet.
My program is waiting and nothing happens
It’s probably waiting for input. Click in the terminal and type your answer, then press Enter. To stop it, press Shift+F5.
macOS says Kiln “can’t be opened”
Kiln isn’t notarized yet. Right-click Kiln in Applications → Open, or go to System Settings → Privacy & Security and click Open Anyway.
Sakura doesn’t talk
Check Settings → Sakura → Sakura talks is on and your volume is up. Her own voice is built into Kiln. AI-written answers use your computer’s built-in voices; on Linux, install speech-dispatcher if no voices are available.
git: “Please tell me who you are”
Git needs a name and email for commits. Set them in Settings → Git, or once for your whole computer:
git config --global user.name "Your Name"
git config --global user.email "you@example.com"Push asks for a password or fails
Add a GitHub personal access token in Settings → Git, or set up a git credential helper (for example gh auth login).
The AI panel says no model is configured
Open Settings → AI assistant, choose a provider, enter the model and key, and click Save and test. The error message from the provider is shown if it fails.
A lesson check fails but my page looks right
Read the check’s message and click Show me — the arrow points at what the checker is looking at. Checks run at 1000px wide unless they say otherwise. Fix any problems listed under Problems in your code first; browsers silently repair broken HTML, which can hide the real issue.
A guided-project check says it can’t find my function
Checks call your functions by name, so keep the name from the starting file (spelling and capitals count) and declare it at the top level of the file as function name(…) { … } — not inside another function. Save, then check again.
A guided-project check “took too long”
For programs, it usually means the program is still waiting for input — for example the loop never ends because the right guess isn’t detected. For web projects it usually means an endless loop. The check shows what your program printed; read the last lines.
I closed the Guide panel
Run Guide: Show the guide from the command palette (Ctrl+Shift+P). Your progress is saved in the project’s .kiln folder.
I closed a file without saving
With auto-save on (the default), changes are saved as you type. With auto-save off, Kiln keeps a backup of unsaved edits and restores them the next time you open the project.