<h1 align="center">
<a href="https://prompts.chat">
This guide helps you resolve common issues encountered while using or contributing to the [AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners) repository. Each problem includes background, symptoms, explanations, and step-by-step solutions.
Sign in to like and favorite skills
This guide helps you resolve common issues encountered while using or contributing to the AI-For-Beginners repository. Each problem includes background, symptoms, explanations, and step-by-step solutions.
Background: Cloning allows you to copy the repository to your machine.
Symptoms:
fatal: repository not foundPermission denied (publickey)Possible Causes:
Solutions:
git clone https://github.com/microsoft/AI-For-Beginners.git
Permission denied (publickey), use the HTTPS link above instead of SSH.Background: The repository relies on Python and various libraries.
Symptoms:
ModuleNotFoundError: No module named '<package>'Possible Causes:
Solutions:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python --version
Background: Notebooks are a core learning resource.
Symptoms:
jupyter: command not foundPossible Causes:
Solutions:
or, if using Anaconda:pip install notebook
conda install notebook
jupyter notebook
Background: Projects can break if package versions are mismatched.
Symptoms:
Possible Causes:
Solutions:
If this fails, manually install missing packages as described in README.pip install -r requirements.txt
Background: Some modules may require keys, tokens, or config settings.
Symptoms:
KeyError or warnings about missing configurationPossible Causes:
Solutions:
.env.example or similar files..env file and fill in required values.Background: Jupyter notebooks need proper setup.
Symptoms:
Possible Causes:
Solutions:
http://localhost:8888/?token=...) and paste it into your browser.Background: Notebook kernels can crash due to resource limits or code errors.
Symptoms:
Possible Causes:
Solutions:
Background: Some AI tasks require significant memory and CPU.
Symptoms:
Possible Causes:
Solutions:
Background: The online textbook displays lessons and chapters.
Symptoms:
Known Issue:
READMEtransformers.md instead of README.md).Solutions:
README.md.Background: Contributions must pass tests and follow guidelines.
Symptoms:
Possible Causes:
Solutions:
Last Updated: 2025-09-20