How to run our Python tools

Every Python tool on The Freelancer Kit runs locally on your own computer, in plain Python. Your files stay private and nothing is uploaded. There are two kinds of Python tool here, and they are started in different ways — this guide covers both, plus Chrome extensions at the end.

First, work out which kind you have. The tool's product page and its README say which kind it is. A GUI tool opens a window with buttons. A terminal tool is run from a terminal (command line) and prints its results as text.

GUI tools — double-click to open the window.

1. Download the tool and unzip the folder.
2. If the folder contains a requirements.txt file, install what it lists once: open a terminal inside the unzipped folder and run pip install -r requirements.txt. Tools without that file need nothing extra.
3. Double-click the .py file to open its friendly window. No coding required — pick your files, click the tool's button, and check the result it shows.
4. If double-clicking opens the file in a text editor instead of running it, right-click the .py file and choose to open it with Python, or run it from a terminal with python3 followed by the file name.

Terminal tools — run from a terminal (command line).

1. Download the tool and unzip the folder.
2. Open a terminal (on Windows, Command Prompt or PowerShell) inside the unzipped folder.
3. Run the exact command from the tool's README. To see a tool's options first, run python3 followed by the tool's file name and --help.
4. Read the text the tool prints: it confirms what it did, and it says if anything needs fixing before you run it again.

Chrome extensions. Extensions are not Python tools and are not run this way. They are loaded unpacked in Chrome — see the step-by-step Chrome extension install guide.

Safety note. These tools run locally, your files stay private, and they are plain Python — you can open the .py file in any text editor and read exactly what it does before you run it.

Try a Python tool free →

About the author

Tariq Shahzad runs The Freelancer Kit from Pakistan. The site offers free tools and templates for freelancers — every product is free in full, and support is by email at [email protected]. If a product does not work as described, email within 7 days and it will be fixed or replaced.