Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jcomte23/Python_vanilla/llms.txt

Use this file to discover all available pages before exploring further.

​
Installation and Setup

This guide will walk you through installing Python and setting up the Python Vanilla repository on your local machine so you can start learning immediately.

​
Prerequisites

Before installing Python Vanilla, you’ll need to have Python installed on your system. Let’s verify your installation or install it if needed.

​
Check Existing Python Installation

First, check if Python is already installed on your system by running this command in your terminal: 
python --version
Or on some systems: 
python3 --version
You should see output like Python 3.11.0 or similar. Python 3.6 or higher is recommended for this course.

​
Installing Python

If Python is not installed or you need to update to a newer version, follow these steps:
1

Download Python

Visit the official Python website at python.org and download the latest stable version for your operating system.

Windows

Download the Windows installer (.exe) and run it. Make sure to check “Add Python to PATH” during installation.

macOS

Download the macOS installer (.pkg) or use Homebrew: brew install python3

Linux

Use your package manager: sudo apt install python3 (Ubuntu/Debian) or sudo yum install python3 (CentOS/RHEL)
2

Verify Installation

After installation, open a new terminal window and verify Python is installed correctly:
python --version
You should see the version number of your Python installation.
3

Verify pip

Pip is Python’s package installer and comes bundled with Python. Verify it’s installed:
pip --version
Or:
pip3 --version

​
Setting Up Python Vanilla

Now that Python is installed, let’s set up the Python Vanilla repository to access all the learning materials and examples.
1

Clone the Repository

You can clone the repository using either HTTPS or SSH. SSH is recommended if you have SSH keys set up with GitHub.
git clone [email protected]:jcomte23/Python_vanilla.git
If you’re new to Git, HTTPS is simpler to get started. For SSH setup, refer to GitHub’s SSH documentation.
2

Navigate to the Directory

Once cloned, navigate into the Python Vanilla directory:
cd Python_vanilla
3

Explore the Structure

The repository is organized into numbered chapters. List the contents to see what’s available:
ls
You should see folders like:
  • 01_Introduccion_a_python - Introduction to Python
  • 02_Tipos_de_variables_en_python - Variable types
  • 03_Strings - Working with strings
  • 04_Numbers - Numbers and numeric operations
  • And more…
4

Run Your First Example

Navigate to the first chapter and run the example:
cd 01_Introduccion_a_python
python main.py
You should see output in your terminal demonstrating Python concepts from the first chapter.

​
Repository Structure

Understanding the repository structure will help you navigate the learning materials effectively:

​
Chapter Organization

The repository is structured as a step-by-step learning guide:

Chapters 01-07

Basic Concepts
  • Variables and data types
  • Strings and string manipulation
  • Numbers and numeric operations
  • Operators
  • Conditionals and control flow

Chapters 09-12

Data Structures & Loops
  • Lists and list operations
  • Tuples
  • Dictionaries
  • Sets
  • Loops and iteration

​
Practical Exercises

The EjerciciosPracticos folder contains applied exercises that integrate concepts from multiple chapters:
  • BMI Calculator: Calculate and interpret Body Mass Index
  • Shopping Cart: Manage items and calculate totals
  • Text Analyzer: Process and analyze text input
  • And more!

​
Running Examples

Each chapter contains a main.py file with executable examples. To run any chapter:
1

Navigate to the Chapter

Use cd to move into the chapter directory:
cd "02_Tipos_de_variables_en_python"
Use quotes around folder names with spaces to ensure the command works correctly.
2

Execute the Script

Run the main Python file:
python main.py
The results will be displayed in your terminal.
3

Experiment and Learn

Open main.py in your favorite text editor, read through the code, and modify it to experiment with the concepts. Run the file again to see how your changes affect the output.
While you can use any text editor to work with Python, these tools can enhance your learning experience:

​
Text Editors and IDEs

  • VS Code: Free, powerful editor with excellent Python support
  • PyCharm: Full-featured IDE designed specifically for Python
  • Sublime Text: Lightweight and fast text editor
  • Jupyter Notebook: Interactive environment great for learning and experimentation

​
Terminal Enhancement

  • iTerm2 (macOS): Enhanced terminal with better features
  • Windows Terminal (Windows): Modern terminal application
  • Terminator (Linux): Terminal emulator with split screens

​
Troubleshooting

Try using python3 instead of python. On some systems, especially Linux and macOS, Python 3 is accessed via python3.If that doesn’t work, Python may not be in your PATH. Reinstall Python and ensure you check the “Add to PATH” option during installation.
On Linux or macOS, you may need to make the script executable:
chmod +x main.py
Or run with explicit python command:
python3 main.py
If you get authentication errors with SSH, switch to HTTPS method:
git clone https://github.com/jcomte23/Python_vanilla.git
If Git is not installed, install it from git-scm.com.
If you have multiple Python versions installed, you can specify which one to use:
python3.11 main.py
Replace 3.11 with your desired version number.

​
Next Steps

Congratulations! You now have Python and the Python Vanilla repository set up and ready to go. You’re ready to start your learning journey:
  1. Begin with Chapter 01 - Introduction to Python
  2. Work through each chapter sequentially
  3. Experiment with the code examples
  4. Complete the practical exercises to reinforce your learning
Remember: Learning to code is a journey. Take your time with each concept, experiment freely, and don’t be afraid to make mistakes—that’s how you learn!

Build docs developers (and LLMs) love

Get started for freeTalk to us