0xNixxy Tech Tips

Python Quickstart Guide

Python is one of the easiest scripting languages to learn, but also one of the easiest to overcomplicate when it comes to setup. This quickstart is designed for both first-time learners and experienced developers who just need a fuss-free way to get Python set up to start coding.

This opinionated guide focuses on a mainstream Python workflow on Linux, which includes tools, commands, and conventions widely recommended in 2026, while briefly covering older approaches you can safely skip over.

Useful Background Knowledge

Use Python 3 for your new projects. Python 2 is obsolete and deprecated since 2020. The latest Python versions can be found on the official Python website.
Linux is technically easier to setup Python as Python often comes pre-installed with Linux. For Ubuntu 24.04, use the following commands to setup Python3
```
sudo apt update
sudo apt install python3 python-is-python3
```
ℹ️ Note

Download the installer from the official Python website to install Python on Windows.
Use uv tool to install and manage specific versions of Python.
Use ruff tool for linting and formatting of Python source code. Linters help you catch mistakes early in your source code and help build good coding habits automatically in developers.

Set up specific Python versions with `uv`

[Optional prerequisites] Ensure that your system has the following tools installed to proceed with the subsequent steps.
```
sudo apt install curl
```
Install latest version of uv using the official standalone installer.
```
curl -LsSf --tlsv1.3 https://astral.sh/uv/install.sh | sh
```
💡 Tip

To upgrade uv, use the uv self update command.

To uninstall uv, use the following commands
```
uv cache clean
rm -r "$(uv python dir)"
rm -r "$(uv tool dir)"
```
Restart your shell to activate uv environment settings.
Use the following command to validate that uv has been properly installed. You should see the version number printed to terminal.
```
uv self version
```
Install a specific version of Python.
```
uv python install 3.11
```
💡 Tip

To upgrade a specific Python version to the latest patch release, use uv python upgrade 3.11.
Check that Python was installed properly.
```
uv python list
```
Set a project to use a specific version of Python.
```
mkdir hello-world
cd hello-world
uv python pin 3.11
```
💡 Tip

To set a global default version of Python in your user account, use uv python pin --global 3.11.
Check the version of Python executed by uv in the project.
```
uv run python --version
```

Run Python scripts with `uv`

Once you have set up the target Python version with uv above, you can run Python scripts in the following ways

Run script without 3rd-party dependencies.
```
uv run hello-world.py
```
ℹ️ Note

Usage of modules from the Python standard libraries is supported in this mode of running Python scripts.
Run script with 3rd-party dependencies (ideally within a project).
1. Create a new Python project with uv.
```
mkdir hello-world
cd hello-world
uv init
```
2. Run the Python project.
```
uv run main.py
```

💡 Tip

For more information on working on projects with uv, read the official documentation.

Lint your Python project with `ruff`

To use a linter to check your Python source code in a project, follow the steps below

(One-time setup) Install latest version of ruff globally.
```
uv tool install ruff@latest
```
Format code style for all Python source files in current directory.
```
ruff format
```
Lint (check) all Python source files in current directory.
```
ruff check
```

Gradual deprecation of older Python tools

Python developers are rapidly consolidating around a new generation of tools, such as uv and ruff, which are designed to replace the older fragmented toolchain. However, many active Python projects have yet to migrate to the new toolchains and will likely take a few years for the entire Python ecosystem to complete migration.

New and experienced developers will need to recognise these older tools when there is a need to integrate the new toolchain with older Python projects. The following table summarises the list of old tools and the superseding new tools.

Old Tool	Purpose	Equivalent New Tool
`pyenv`	Version manager for Python	`uv python install`
`pip`	Install packages	`uv add`
`python -m venv`	Create virtual environments	`uv`
`pipenv`	Package + env management	`uv`
`poetry`	Dependency management	`uv`
`requirements.txt`	List dependencies used by `pip`	`uv` uses `pyproject.toml`
`flake8` / `pylint`	Linting	`ruff check`
`black`	Formatting	`ruff format`
`virtualenv`	Older `venv` tool	Obsolete since Python 3.3
`conda`	Python + non-Python packages	Only needed for scientific stacks

← Back to Main Page

This site is open source. Improve this page.