DEV Community

Cover image for How to Set Up Goose on Windows 🦢
Lymah
Lymah

Posted on

How to Set Up Goose on Windows 🦢

Goose 🦢 AI is a powerful, AI-driven tool designed to assist developers with programming and operational tasks. Setting it up on Windows is can might not be a straightforward process. In this blog, I will walk you through a step-by-step process to get your Goose AI running on your Window machines in VIsual Studio Code (VS code). This basically involves installing pipx, configuring your environment, and running the Goose AI agent.

pipx is a tool to help you install and run end-user applications written in Python. It's roughly similar to macOS's brew, JavaScript's npx, and Linux's apt.
Learn more...

Step 1: Install Python

Goose AI requires Python to run. If Python isn’t already installed on your system:

  1. Download the latest Python version from the official Python website and follow the installation steps on the website.
  2. During installation:
    • Check the box for "Add Python to PATH"
    • Click Install Now
  3. Confirm Python is installed by opening PowerShell and running:

python --version

You should see the Python version printed on the screen.

Option One

Step 2: On Windows install via:

  • install via Scoop
  • scoop install pipx
  • pipx ensurepath

Install via Scoop

To install pipx on Windows using Scoop and set up your environment, follow these steps.

Install Scoop

If you don't have Scoop installed already, do this first:

  • Open PowerShell as an administrator.

Run the following command to install Scoop:

 iwr -useb get.scoop.sh | iex

Enter fullscreen mode Exit fullscreen mode

This command downloads and installs Scoop, a package manager for Windows.

Close and reopen PowerShell to refresh the environment.

Install pipx Using Scoop

Now that Scoop is installed, you can install pipx.

  • In PowerShell, run:
  scoop install pipx
Enter fullscreen mode Exit fullscreen mode
  • Wait for the installation to complete. Scoop will handle downloading and installing pipx

Ensure pipx is in Your PATH

After installation, you need to ensure pipx is in your system PATH so you can use it from any directory:

  • Run the following command to add pipx to your PATH:
pipx ensurepath
Enter fullscreen mode Exit fullscreen mode
  • Close and reopen PowerShell to apply the changes.

Verify the Installation

  • To confirm that pipx is set up correctly, run:
pipx --version
Enter fullscreen mode Exit fullscreen mode

If you see the version number, pipx is successfully installed and ready to use.

If the aforementioned steps don't work for you, still stay with me. Because it didn't work on my end as well. Let's try another way around it. I hope you are still following me. Relax, don't be frustrated. I got you on this, I mean it! 😃

Option Two

Step 2: Manually Download and Run the Scoop Script

If PowerShell 7 isn't resolving the issue, you can try manually downloading the installation script outside of PowerShell:

  • Open a web browser and go to this URL
  • Download and save this file as install.ps1 in a directory of your choice, like C:\Users\user\scoop.
  • Open PowerShell as an administrator and navigate to the directory where you saved the file. For example:
cd C:\Users\user\scoop
Enter fullscreen mode Exit fullscreen mode
  • Run the script directly with:
.\install.ps1
Enter fullscreen mode Exit fullscreen mode

Guess what, this option didn't work on my end. No, don't give up. Let us look for another way that can work for us if you are still stuck at this point like I did.

Option Three

install via pip (requires pip 19.0 or later)

# If you installed python using Microsoft Store, replace `py` with `python3` in the next line.
py -m pip install --user pipx
Enter fullscreen mode Exit fullscreen mode

Screeshot of goose pipx installation on window

This particular option works on my Dell window PC

Screeshot

PowerShell is giving a warning that the installation directory (C:\Users\user\AppData\Roaming\Python\Python312\Scripts) is not in my system PATH. Adding this directory to my PATH will allow me to run pipx from any command prompt.

Here's how to add it to your PATH:

Open Environment Variables

  • Press Win + R, type sysdm.cpl, and press Enter to open the System Properties window.
  • Go to the Advanced tab and click on Environment Variables. Edit the PATH Variable
  • In the User variables section, look for a variable named Path and select it. Then click Edit.
  • Click New and add the following path:
C:\Users\user\AppData\Roaming\Python\Python312\Scripts
Enter fullscreen mode Exit fullscreen mode

Click OK to close all dialogs and apply the changes.

Verify the PATH Update
Close and reopen PowerShell or Command Prompt, and then verify the installation by running:

pipx --version
Enter fullscreen mode Exit fullscreen mode

If the version appears, pipx is now ready for use. You can also run:

pipx ensurepath
Enter fullscreen mode Exit fullscreen mode

This command ensures that pipx and any tools it installs are available in your PATH.

Screenshot

Now that we have pipx installed, we can now install goose-ai by running the following command in your PowerShell terminal:

pipx install goose-ai
Enter fullscreen mode Exit fullscreen mode

screenshot

It seems pipx installed goose-ai successfully, but it’s still warning that C:\Users\user\.local\bin is not in my PATH. The best thing to do at this juncture is to restart my Powershell or PC so the installation can take effect. After that, we can now verify to be sure:

To verify that C:\Users\user\.local\bin is now in my PATH

$env:PATH -split ";"
Enter fullscreen mode Exit fullscreen mode

Screenshot

It seems the installation is now in my PATH!

The next thing is to test goose-ai

Test goose-ai

After verifying your PATH, try running goose --help

goose --help
Enter fullscreen mode Exit fullscreen mode

goose-ai
Goose is now successfully installed!
If you followed me to this point, it good to say;
goose-ai is installed and accessible from your command line. You can now use goose to manage providers, run sessions, and use its AI-powered functionalities.

Last Step

Install goose ai in VS code

Go to the extension in VS Code and type goose-ai in the search bar and get it install

goose ai

Well done!

goose-ai

You can now start working with goose!

goose-ai

Thanks for reading!

If you want to get started with goose-ai, check this out!

Join the goose-ai community today for any questions!

Checkout my post on how to use goose-ai as a GitHub action

Top comments (1)

Collapse
 
blackgirlbytes profile image
Rizèl Scarlett

so helpful!