Set Up Your Tools
Before we start building, let's get your tools ready. This page walks you through each step.
You will need: a laptop with internet access. No coding experience is required — we will guide you through every step.
Step-by-Step Setup
Download Wispr Flow (optional)
This step is optional. Wispr Flow lets you speak instead of type — handy if you prefer talking over typing. Skip this step if you'd rather type your prompts.
Sign up using this invite link to get a free month of Pro: https://wisprflow.ai/r?CHAN115
Both you and the tutorial author benefit — you get a free month of Pro, and they get a free month when you dictate 2,000 words!
- Sign up at wisprflow.ai/r?CHAN115
- Download and install the app for your operating system
- Configure settings — enable these options for the best experience:
- Experimental > Command Mode — Enable advanced voice commands
- Press Enter Command — Automatically press enter when you say "press enter"
- Bulk Import — Import snippets and dictionary items
What is Wispr Flow?
Wispr Flow is a voice-to-text tool that lets you dictate instead of type. It works in any application, including your terminal. Instead of typing a long prompt to Gemini CLI, you can just say it out loud. This is especially useful if you find typing slow or tiring.
Install Node.js
Node.js is a free tool that lets you run Gemini CLI on your computer.
- Windows
- macOS
- Go to nodejs.org
- Click the big green LTS button to download the installer
- Open the downloaded
.msifile - Click Next through all the screens — the default settings are fine
- Click Install, then Finish
- Go to nodejs.org
- Click the big green LTS button to download the installer
- Open the downloaded
.pkgfile - Click Continue through all the screens — the default settings are fine
- Click Install, then Close
How do I know it worked?
Open your terminal and type:
node --versionYou should see a version number like
v22.x.x. If you see an error, try closing and reopening your terminal, then run the command again.Learn to open your terminal
The terminal is a program where you type commands. It looks like a dark window with text — this is completely normal. Don't be intimidated!
- Windows
- macOS
- Press the Windows key on your keyboard
- Type PowerShell
- Click Windows PowerShell in the search results
You'll see a dark blue window with a blinking cursor. That's your terminal!
- Press Cmd + Space to open Spotlight
- Type Terminal
- Press Enter
You'll see a window with a blinking cursor. That's your terminal!
The terminal is where you'll type commands to install tools and talk to AI. You'll be using it a lot in this tutorial — keep it open!
How to open a terminal in a specific folder
Later in this tutorial, you'll need to open a terminal inside your project folder. Here's how:
Windows: Open the folder in File Explorer. Click the address bar at the top, type
powershell, and press Enter. A terminal opens right in that folder.macOS: Open Finder and navigate to the folder. Right-click the folder and select "Open Terminal at Folder". If you don't see this option, you can open Terminal normally and type
cd(with a space), then drag the folder into the Terminal window and press Enter.Install and test Gemini CLI
Gemini CLI is Google's free AI assistant. It runs in your terminal and helps you with tasks based on your descriptions.
Open your terminal and type:
npm install -g @google/gemini-cliWait for the installation to finish. Then start it by typing:
geminiThe first time you run it, Gemini CLI will ask you to sign in:
- Choose "Sign in with Google"
- A browser window will open — sign in with your Google account
- Come back to the terminal when it says you're connected
Free tier: 60 requests per minute, 1,000 requests per day — more than enough for this tutorial and everyday use.
'npm' is not recognised
This means Node.js isn't installed correctly. Go back and reinstall Node.js. After reinstalling, close your terminal completely and open a new one before trying again.
Permission denied error
Windows: Close PowerShell and reopen it by right-clicking and choosing "Run as Administrator". Then try the install command again.
macOS: Add
sudobefore the command:sudo npm install -g @google/gemini-cliEnter your computer password when prompted (you won't see characters as you type — that's normal).
Install Typst CLI
Typst is a free, open-source typesetting system that turns simple text files into beautiful PDFs.
- Windows
- macOS
Open PowerShell and run:
winget install --id Typst.TypstWait for the installation to finish. You may need to close and reopen your terminal afterwards.
Open Terminal and run:
brew install typstDon't have Homebrew?
If you see
brew: command not found, install Homebrew first by running:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Follow the on-screen instructions, then run
brew install typstagain.Manual download fallback
If the commands above don't work, you can download Typst directly:
- Go to the Typst releases page
- Download the file for your system:
- Windows:
typst-x86_64-pc-windows-msvc.zip - macOS (Apple Silicon):
typst-aarch64-apple-darwin.tar.xz - macOS (Intel):
typst-x86_64-apple-darwin.tar.xz
- Windows:
- Extract the downloaded file
- Move the
typstexecutable to a folder in your system PATH, or run it directly from the extracted folder
Verify the installation
Open a new terminal window and type:
typst --versionYou should see a version number like
typst 0.13.x. If you see an error, try closing and reopening your terminal first.
Verify Your Setup
Before moving on, check that everything is ready:
Node.js installed
Run node --version in your terminal. You should see a version number.
Terminal works
You can open a terminal window and type commands.
Gemini CLI installed
Run gemini in your terminal. It starts up and shows a prompt where you can type.
Signed in to Google
Gemini CLI is connected to your Google account.
Typst CLI installed
Run typst --version in your terminal. You should see a version number.
Wispr Flow (optional)
If you installed it, you can dictate text in any application — including your terminal.
All set? Head to Build your first PDF to create your first professional document.