Skip to main content

​
Overview

Grupo de Anda projects are designed to work with Python 3.11 and Python 3.13. This guide will walk you through installing Python and Visual Studio Code for both Windows and Linux (Ubuntu) systems.
The project has been specifically tested with Python 3.11.14 and Python 3.13. Using other versions may lead to compatibility issues.

​
Supported Python Versions

  • Python 3.11.14 (Recommended)
  • Python 3.13

​
Installation Steps

1

Download Python

Visit the official Python website at https://www.python.org/Download Python 3.11.14 for your operating system.
2

Install Python

​
Windows

Run the installer and make sure to check the following options:
  • “Add Python to PATH”
  • “Install pip”

​
Linux (Ubuntu)

Python usually comes pre-installed on Ubuntu. To check your version:
python3 --version
If you need to install Python 3.11:
sudo apt update
sudo apt install python3.11 python3.11-venv python3-pip
On Ubuntu, the system uses Python internally. Never modify the system Python installation directly as it can break your operating system. Always use virtual environments (see Virtual Environments guide).
3

Verify Installation

Open a terminal or command prompt and verify Python is installed:
python --version
Or on Linux:
python3 --version
You should see the Python version number displayed.
4

Install Visual Studio Code

Download VS Code from https://code.visualstudio.com/downloadFor detailed installation instructions for both Python and VS Code, watch this helpful video tutorial:Python & VS Code Setup Tutorial

​
VS Code Python Setup

After installing VS Code, you’ll need to configure it for Python development:
1

Install Python Extension

  1. Open VS Code
  2. Go to Extensions (Ctrl+Shift+X)
  3. Search for “Python”
  4. Install the official Python extension by Microsoft
2

Select Python Interpreter

  1. Press Ctrl+Shift+P to open the command palette
  2. Type “Python: Select Interpreter”
  3. Choose your installed Python version (3.11 or 3.13)

​
Running Python Code

Once everything is set up, you can run Python code in VS Code:
  • Press F5 to run in debug mode
  • Right-click and select “Run Python File in Terminal”
  • Use the Run button in the top-right corner
Depending on the program, it may run in the terminal or open a graphical user interface (GUI).

​
Platform Considerations

​
Ubuntu-Specific Notes

This codebase was designed with Ubuntu in mind. Ubuntu’s system integration with Python means you must use virtual environments to avoid breaking system functionality.
Key Ubuntu considerations:
  • System uses Python internally for core functionality
  • Installing or updating libraries system-wide can break Ubuntu
  • Always use virtual environments (see next guide)
  • The python3-venv package is required for virtual environments

​
Windows Notes

  • Ensure Python is added to PATH during installation
  • You may need to use python instead of python3 in commands
  • Virtual environments are recommended but not critical for system stability

​
Next Steps

After installing Python, proceed to:
  1. Set up a virtual environment (Critical for Ubuntu users)
  2. Install project dependencies
  3. Set up Arduino hardware (if working with hardware projects)

​
Troubleshooting

Windows: Python wasn’t added to PATH during installation. Reinstall Python and check “Add Python to PATH”.Linux: Use python3 instead of python.
Don’t use sudo with pip. Instead, use a virtual environment or install with the --user flag:
pip3 install --user package-name
You can specify the version explicitly:
python3.11 --version
python3.13 --version
Set your preferred version in VS Code using “Python: Select Interpreter”.

Build docs developers (and LLMs) love

Get started for freeTalk to us