======================================================
TutorClaw - Start Here
======================================================

KEY POLICY AND SETUP
====================
TutorClaw needs user-owned keys to work safely. This software runs entirely on your own machine. We do not provide API keys because using your own ensures your data stays under your control and your usage costs are linked only to your own account.

A. Gemini / Google AI key
- What it is: A text code that allows TutorClaw to use Google's Gemini AI brain.
- Why TutorClaw needs it: TutorClaw uses Gemini to think, chat, and help you learn. Without it, TutorClaw has no brain.
- Where to get it: You can get one for free at Google AI Studio (aistudio.google.com).
- Important: Once you get your key, you should copy it into the TutorClaw setup helper or your local .env file.
- Safety warning: NEVER post your Gemini key publicly!

B. Telegram BotFather token (Optional)
- Only needed for phone chat: If you want to text TutorClaw from your phone using Telegram, you need this. It is completely optional.
- Where to get it: Inside the Telegram app, search for "BotFather" and follow its instructions to create a new bot. It will give you a token.
- Important: Paste this token ONLY into the TutorClaw setup helper or your local .env file.

SAFETY WARNINGS
---------------
* Do not share your API keys publicly.
* Do not post keys in screenshots.
* Do not email keys unless you understand the risk.
* TutorClaw should never ship with real keys.
* This package includes a .env.example file to show you how keys should be structured.
* This package does NOT include a real .env file.
* Keys belong on the user's own computer and should never be uploaded anywhere else.

START HERE:
===========
1. Unzip the ZIP file.
2. Open the unzipped folder.
3. Open README.txt first.
4. Read the Key Policy and Setup section above.
5. Then run START_HERE_WINDOWS.bat.

=====================================================
If TutorClaw says WSL/Ubuntu or Python is missing
=====================================================
TutorClaw uses WSL 2 and Ubuntu in the background.

* If TutorClaw says your Ubuntu/WSL environment is missing or too old, run:
  INSTALL_TUTORCLAW_WSL_UBUNTU_24.bat

* If TutorClaw says Python tools are missing inside Ubuntu, run:
  INSTALL_TUTORCLAW_WSL_PYTHON.bat

* If you are running the optional Phone Chat feature and Windows Python is missing, run:
  INSTALL_TUTORCLAW_WINDOWS_PYTHON.bat

After running any of these installer helper scripts, run START_HERE_WINDOWS.bat again to start TutorClaw.

If Windows says Ubuntu-24.04 is not a valid distribution name, run wsl --list --online or install Ubuntu 24.04 LTS from the Microsoft Store.

Troubleshooting search terms:
- There is no distribution with the supplied name
- WSL_E_DISTRO_NOT_FOUND
- WSL_E_DEFAULT_DISTRO_NOT_FOUND
- python3: command not found
- No module named venv
