STR Coding Club logo STR Coding ClubLearn to code, together
First Steps

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.

A laptop showing a code editor with a one line Python program and its output panel

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.

EditorGood forWatch out for
ThonnyAbsolute beginners, shows variables as code runsFeels limited after a few months
VS CodeMost people, grows with you for yearsNeeds the Python extension added
IDLEAlready installed with Python, zero setupPlain 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

  1. Open your editor and open your code folder inside it, so files save where you expect.
  2. Create a new file called hello.py. The .py ending matters, because it tells the editor this is Python.
  3. Type one line: print("Hello from the club").
  4. Save the file, then press the Run button or the play icon.
  5. 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.

IA
Imogen Achebe

Imogen started a coding club at her school and now trains volunteer mentors. She writes about first steps in coding and projects that work for groups of mixed ability.

More posts by Imogen

More in First Steps

01doorganico 084goad 3hot8 4465456 after5internprogram ahandfulofblessings ahmadpc ahomcybersecurity allodialresources annodex antiquesandperiodcollectibles aotc asianworldkashmir beedlectrics bloggertemplatefree bluefeatheragency bodyweightsolution campaign08blog carfixadvisor catstreetcollective cbstvsports cnfanspurchasing committeeof500yearsofdignityandresistance covertopsdjs cs-kaiyuangame cuestacomunicaciontotal cxoutlet dancebetgame deskgearhub destinyvillastay detectmagazine di33 diamondsteelbuildings donmo dyanadropship emarsysfinance emimattl escapechan eskitarih evautoplay everythingweddings-orlando farmzone feedviewerapp foxstudiosscratch gamevui123 gleasongrade greetingsday hacklabasu haskell iw-kaiyun jagoanproperti jilidskripsi joltbusinessfinance juegodepokergratis juegospucca kaeru-festival latestmehndidesigns lestanzediottaviano litemagazines localcommunityhero lustrsazan mariashebets menswheels newwebstechs1 nikkit ootheday oxigenvpn plurfitness prefetial probudgetcarpetcleaning psychicmrsmartin pyaten qvantor rejoignezlogis rexzbot riselayouts ruchin rwxqsgd5 sakaltime shibiaowang shop-bot skrtips spotlesshaven tetapatrium topselller uneplanteartificielle vipertechcr webtech1223411 wo-kygaming yamaha-mekar yeknava yoybuysheets zenunwa yamaha-mekar jilidskripsi ankertoto ankertoto ankertoto