Install Python and a Code Editor in Your First Hour
At our club's first session each term, roughly a third of the newcomers spend the whole hour fighting their computer instead of writing code. The Python installer finished, but typing python in a terminal opens an app store.

At our club's first session each term, roughly a third of the newcomers spend the whole hour fighting their computer instead of writing code. The Python installer finished, but typing python in a terminal opens an app store. The editor is installed, but the Run button does nothing. By the end they have written zero lines and feel like coding is not for them.
It does not need to go that way. If you want to install Python and a code editor on your own laptop, one hour is plenty, as long as you do the steps in the right order and check each one before moving on. This guide is the checklist I hand out at that first session, with the mistakes I see most often.
What You Need Before You Install Python
Less than you think. Any laptop from the last ten years runs Python comfortably. You do not need a gaming machine, a Mac or a Linux setup. What you do need:
- About 1 GB of free disk space for Python and an editor.
- Permission to install software. School and work laptops often block this, so check before the session, not during it.
- A stable internet connection for the downloads, which total around 150 MB.
- A folder you will remember, such as one called code in your Documents, where every practice file will live.
Chromebooks and tablets are the exception. They can run Python through a browser based editor, which is fine for your first weeks while you decide whether to keep going.
Step One, Install Python the Right Way
Download the installer from the official Python website and pick the latest stable version. Do not hunt for an older version because a tutorial from years ago used it. Beginner code works the same on any recent release.
On Windows
On the very first installer screen there is a small checkbox that says "Add python.exe to PATH". Tick it. This single box causes more first day trouble than everything else combined. Without it, your terminal will not find Python and Windows may send you to its app store instead.
On a Mac
Run the installer package as normal. Afterwards, use the command python3 rather than python in the terminal, because older Macs may point the plain name somewhere else.
Check it worked
Open a terminal (Command Prompt or PowerShell on Windows, Terminal on Mac) and type python -V, or python3 -V on a Mac. You should see a version number like Python 3.13. If you see an error instead, close the terminal and open a fresh one first. Terminals opened before the install do not know Python exists yet.
Step Two, Choose a Beginner Code Editor
A code editor is where you write and save your programs. You could use Notepad, but a proper editor colours your code, catches typos and runs programs with one click.
| Editor | Good for | Watch out for |
|---|---|---|
| Thonny | Absolute beginners, shows variables as code runs | Feels limited after a few months |
| VS Code | Most people, grows with you for years | Needs the Python extension added |
| IDLE | Already installed with Python, zero setup | Plain and easy to outgrow |
In our club, people who will only try coding for a month do best with Thonny. People who already know they want to continue usually go straight to VS Code. Both are free.
If you pick VS Code, open the Extensions panel on the left, search for Python and install the one published by Microsoft. That single extension adds the Run button, error underlines and interpreter picker. Skip the dozens of other suggested extensions until you know what problem each one solves.
The Advice to Skip the Fancy Setup at First
New coders often read that "real developers" use a full IDE with virtual environments, a package manager and a dark theme tuned for hours. Some tutorials even tell you to install a large data science bundle on day one. I would ignore all of it for now.
Every extra tool is another thing that can be misconfigured, and when something fails you cannot tell whether the problem is your code or your setup. In one club term, members who started with a bare editor and plain Python wrote their first working program in an average of 25 minutes. Those who followed a heavy setup guide took more than twice as long, and two never got past installation.
Virtual environments and package managers are worth learning in month two or three, once you install your first outside library. Not before.
Step Three, Run Your First File
- Open your editor and open your code folder inside it, so files save where you expect.
- Create a new file called hello.py. The .py ending matters, because it tells the editor this is Python.
- Type one line: print("Hello from the club").
- Save the file, then press the Run button or the play icon.
- Read the output panel. If you see your sentence, your setup works.
In VS Code, the first time you run a Python file it may ask you to pick an interpreter. Choose the Python version you installed in step one. If the list is empty, Python was not added to PATH, so go back to the Windows checkbox.
Fixing the Four Problems Everyone Hits
- "python is not recognized". PATH was not set. Rerun the installer, choose Modify, and tick the PATH option.
- The file runs but nothing appears. You saved under a different name than the file you are running, or forgot to save. Most editors show a dot on the tab when changes are unsaved.
- SyntaxError on the first line. Usually curly quotes pasted from a website or a document. Retype the quotes by hand in the editor.
- The editor uses the wrong Python. Pick the interpreter again from the status bar at the bottom of the window.
When the message is not on this list, read it slowly from the bottom line upward. Our guide to reading a Python error message when you are new walks through exactly how.
FAQ
Can I learn Python without installing anything?
Yes, browser based editors work well for the first few weeks. Install Python locally once you want to save projects, work offline or use files on your own computer.
Which Python version should a beginner install?
The newest stable release from the official site. Differences between recent versions do not affect anything you will write in your first year.
Do I need to uninstall an old Python first?
Usually not. Several versions can live side by side. Just make sure your editor points to the new one when you pick an interpreter.
The Practical Takeaway
Give yourself one quiet hour: install Python with PATH ticked, check the version in a fresh terminal, add one beginner editor and run a one line hello.py. Once that prints, stop configuring and start writing code. If you are still unsure what to learn next, start with what to learn first when you know nothing about coding, and find more beginner guides in our first steps section.
More in First Steps
First Steps
How to Escape Tutorial Hell and Build Something Real
One of our club members turned up last autumn having watched roughly sixty hours of Python video across four months.
First Steps
How to Debug With Print Statements as a Beginner
A student I coach spent most of a Tuesday evening convinced that Python was adding numbers wrong.
First Steps
How to Ask a Coding Question That Gets a Real Answer
A student in my Thursday group spent eleven days stuck on the same program.