Docs: Goose on Windows Installation (#2990)

no code changes
This commit is contained in:
Rizel Scarlett
2025-06-18 14:34:03 -04:00
committed by GitHub
parent f122c905dc
commit 59ee39f191
6 changed files with 131 additions and 66 deletions

View File

@@ -5,8 +5,8 @@ import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem'; import TabItem from '@theme/TabItem';
import SupportedEnvironments from '@site/src/components/SupportedEnvironments'; import SupportedEnvironments from '@site/src/components/SupportedEnvironments';
import RateLimits from '@site/src/components/RateLimits'; import RateLimits from '@site/src/components/RateLimits';
import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons'; import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons';
import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons';
# Install Goose # Install Goose
@@ -22,11 +22,11 @@ import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons';
Install Goose directly from the browser or with [Homebrew](https://brew.sh/). Install Goose directly from the browser or with [Homebrew](https://brew.sh/).
<h3 style={{ marginTop: '1rem' }}>Option 1: Install via Download</h3> <h3 style={{ marginTop: '1rem' }}>Option 1: Install via Download</h3>
<DesktopInstallButtons/> <MacDesktopInstallButtons/>
<div style={{ marginTop: '1rem' }}> <div style={{ marginTop: '1rem' }}>
1. Unzip the downloaded zip file. 1. Unzip the downloaded zip file.
2. Run the executable file to launch the Goose desktop application. 2. Run the executable file to launch the Goose Desktop application.
:::tip Updating Goose :::tip Updating Goose
It's best to keep Goose updated by periodically running the installation steps again. It's best to keep Goose updated by periodically running the installation steps again.
@@ -40,7 +40,7 @@ import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons';
--- ---
<div style={{ marginTop: '1rem' }}> <div style={{ marginTop: '1rem' }}>
:::note Permissions :::note Permissions
If you're on an Apple Mac M3 and the Goose desktop app shows no window on launch, check and update the following: If you're on an Apple Mac M3 and the Goose Desktop app shows no window on launch, check and update the following:
Ensure the `~/.config` directory has read and write access. Ensure the `~/.config` directory has read and write access.
@@ -97,7 +97,26 @@ import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons';
</TabItem> </TabItem>
<TabItem value="windows" label="Windows"> <TabItem value="windows" label="Windows">
There isn't native installation support for Windows, however you can run Goose using WSL (Windows Subsystem for Linux). Choose to install Goose on CLI and/or Desktop:
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
Install Goose Desktop directly from the browser.
<h3 style={{ marginTop: '1rem' }}>Install via Download</h3>
<WindowsDesktopInstallButtons/>
<div style={{ marginTop: '1rem' }}>
1. Unzip the downloaded zip file.
2. Run the executable file to launch the Goose Desktop application.
:::tip Updating Goose
It's best to keep Goose updated by periodically running the installation steps again.
:::
</div>
</TabItem>
<TabItem value="cli" label="Goose CLI">
There isn't native installation support for Windows CLI, however you can run Goose using WSL (Windows Subsystem for Linux).
1. Open [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows) as Administrator and install WSL and the default Ubuntu distribution: 1. Open [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows) as Administrator and install WSL and the default Ubuntu distribution:
@@ -129,6 +148,8 @@ import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons';
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
``` ```
</TabItem> </TabItem>
</Tabs>
</TabItem>
</Tabs> </Tabs>
## Set LLM Provider ## Set LLM Provider

View File

@@ -6,17 +6,20 @@ sidebar_label: Updating Goose
import Tabs from '@theme/Tabs'; import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem'; import TabItem from '@theme/TabItem';
import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons'; import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons';
import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons';
The Goose CLI and desktop apps are under active and continuous development. To get the newest features and fixes, you should periodically update your Goose client using the following instructions. The Goose CLI and desktop apps are under active and continuous development. To get the newest features and fixes, you should periodically update your Goose client using the following instructions.
<Tabs groupId="interface"> <Tabs>
<TabItem value="mac" label="macOS" default>
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
:::info :::info
To update Goose to the latest stable version, reinstall using the instructions below To update Goose to the latest stable version, reinstall using the instructions below
::: :::
<div style={{ marginTop: '1rem' }}> <div style={{ marginTop: '1rem' }}>
1. <DesktopInstallButtons/> 1. <MacDesktopInstallButtons/>
2. Unzip the downloaded zip file. 2. Unzip the downloaded zip file.
3. Run the executable file to launch the Goose Desktop application. 3. Run the executable file to launch the Goose Desktop application.
4. Overwrite the existing Goose application with the new version. 4. Overwrite the existing Goose application with the new version.
@@ -51,6 +54,24 @@ The Goose CLI and desktop apps are under active and continuous development. To g
```sh ```sh
goose --version goose --version
``` ```
</TabItem>
</Tabs>
</TabItem>
<TabItem value="windows" label="Windows">
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
:::info
To update Goose to the latest stable version, reinstall using the instructions below
:::
<div style={{ marginTop: '1rem' }}>
1. <WindowsDesktopInstallButtons/>
2. Unzip the downloaded zip file.
3. Run the executable file to launch the Goose Desktop application.
4. Overwrite the existing Goose application with the new version.
5. Run the executable file to launch the Goose Desktop application.
</div>
</TabItem>
</Tabs>
</TabItem> </TabItem>
</Tabs> </Tabs>

View File

@@ -9,8 +9,8 @@ import { IconDownload } from "@site/src/components/icons/download";
import SupportedEnvironments from '@site/src/components/SupportedEnvironments'; import SupportedEnvironments from '@site/src/components/SupportedEnvironments';
import RateLimits from '@site/src/components/RateLimits'; import RateLimits from '@site/src/components/RateLimits';
import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed'; import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons'; import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons';
import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons';
# Goose in 5 minutes # Goose in 5 minutes
@@ -28,7 +28,7 @@ Goose is an open source AI agent that supercharges your software development by
<Tabs groupId="interface"> <Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
<DesktopInstallButtons/> <MacDesktopInstallButtons/>
<div style={{ marginTop: '1rem' }}> <div style={{ marginTop: '1rem' }}>
1. Unzip the downloaded zip file. 1. Unzip the downloaded zip file.
2. Run the executable file to launch the Goose Desktop application. 2. Run the executable file to launch the Goose Desktop application.
@@ -62,7 +62,11 @@ Goose is an open source AI agent that supercharges your software development by
<TabItem value="windows" label="Windows"> <TabItem value="windows" label="Windows">
<Tabs groupId="interface"> <Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
Desktop version is currently unavailable for Windows. <WindowsDesktopInstallButtons/>
<div style={{ marginTop: '1rem' }}>
1. Unzip the downloaded zip file.
2. Run the executable file to launch the Goose Desktop application.
</div>
</TabItem> </TabItem>
<TabItem value="cli" label="Goose CLI"> <TabItem value="cli" label="Goose CLI">
There isn't native installation support for Windows, however you can run Goose using WSL (Windows Subsystem for Linux). There isn't native installation support for Windows, however you can run Goose using WSL (Windows Subsystem for Linux).

View File

@@ -5,8 +5,7 @@ const SupportedEnvironments = () => {
return ( return (
<Admonition type="info" title="Supported Environments"> <Admonition type="info" title="Supported Environments">
The Goose CLI currently works on <strong>macOS</strong> and <strong>Linux</strong> systems and supports both <strong>ARM</strong> and <strong>x86</strong> architectures. The Goose CLI currently works on <strong>macOS</strong> and <strong>Linux</strong> systems and supports both <strong>ARM</strong> and <strong>x86</strong> architectures.
On <strong>Windows</strong>, Goose CLI can run via WSL, and Goose Desktop is natively supported. If you'd like to request support for additional operating systems, please{" "}
On <strong>Windows</strong>, Goose CLI can run via WSL. If you'd like to request support for additional operating systems, please{" "}
<a <a
href="https://github.com/block/goose/discussions/867" href="https://github.com/block/goose/discussions/867"
target="_blank" target="_blank"

View File

@@ -0,0 +1,20 @@
import Link from "@docusaurus/Link";
import { IconDownload } from "@site/src/components/icons/download";
const WindowsDesktopInstallButtons = () => {
return (
<div>
<p>To download Goose Desktop for Windows, click the button below:</p>
<div className="pill-button">
<Link
className="button button--primary button--lg"
to="https://github.com/block/goose/releases/download/v1.0.29/Goose-win32-x64.zip"
>
<IconDownload /> Windows
</Link>
</div>
</div>
);
};
export default WindowsDesktopInstallButtons;