# Beginner-Friendly AI Examples

Welcome! This directory contains simple, standalone examples to help you get started with AI and machine learning. Each example is designed to be beginner-friendly with detailed comments and step-by-step explanations.

## 📚 Examples Overview

| Example | Description | Difficulty | Prerequisites |
|---------|-------------|------------|---------------|
| [Hello AI World](https://github.com/microsoft/AI-For-Beginners/blob/main/examples/01-hello-ai-world.py) | Your first AI program - simple pattern recognition | ⭐ Beginner | Python basics |
| [Simple Neural Network](https://github.com/microsoft/AI-For-Beginners/blob/main/examples/02-simple-neural-network.py) | Build a neural network from scratch | ⭐⭐ Beginner+ | Python, basic math |
| [Image Classifier](https://github.com/microsoft/AI-For-Beginners/blob/main/examples/03-image-classifier.ipynb) | Classify images with a pre-trained model | ⭐⭐ Beginner+ | Python, numpy |
| [Text Sentiment](https://github.com/microsoft/AI-For-Beginners/blob/main/examples/04-text-sentiment.py) | Analyze text sentiment (positive/negative) | ⭐⭐ Beginner+ | Python |

## 🚀 Getting Started

### Prerequisites

Make sure you have Python installed (3.8 or higher recommended). Install required packages:

```bash
# For Python scripts
pip install numpy

# For Jupyter notebooks (image classifier)
pip install jupyter numpy pillow tensorflow
```

Or use the conda environment from the main curriculum:

```bash
conda env create --name ai4beg --file ../environment.yml
conda activate ai4beg
```

### Running the Examples

**For Python scripts (.py files):**
```bash
python 01-hello-ai-world.py
```

**For Jupyter notebooks (.ipynb files):**
```bash
jupyter notebook 03-image-classifier.ipynb
```

## 📖 Learning Path

We recommend following the examples in order:

1. **Start with "Hello AI World"** - Learn the basics of pattern recognition
2. **Build a Simple Neural Network** - Understand how neural networks work
3. **Try the Image Classifier** - See AI in action with real images
4. **Analyze Text Sentiment** - Explore natural language processing

## 💡 Tips for Beginners

- **Read the code comments carefully** - They explain what each line does
- **Experiment!** - Try changing values and see what happens
- **Don't worry about understanding everything** - Learning takes time
- **Ask questions** - Use the [Discussion board](https://github.com/microsoft/AI-For-Beginners/discussions)

## 🔗 Next Steps

After completing these examples, explore the full curriculum:
- [Introduction to AI](../lessons/1-Intro/README.md)
- [Neural Networks](../lessons/3-NeuralNetworks/README.md)
- [Computer Vision](../lessons/4-ComputerVision/README.md)
- [Natural Language Processing](../lessons/5-NLP/README.md)

## 🤝 Contributing

Found these examples helpful? Help us improve them:
- Report issues or suggest improvements
- Add more examples for beginners
- Improve documentation and comments

---

*Remember: Every expert was once a beginner. Happy learning! 🎓*