mirror of
https://github.com/aljazceru/goose.git
synced 2025-12-17 14:14:26 +01:00
240 lines
8.9 KiB
Markdown
240 lines
8.9 KiB
Markdown
---
|
||
sidebar_position: 1
|
||
title: Quickstart
|
||
---
|
||
import Tabs from '@theme/Tabs';
|
||
import TabItem from '@theme/TabItem';
|
||
import Link from "@docusaurus/Link";
|
||
import { IconDownload } from "@site/src/components/icons/download";
|
||
import SupportedEnvironments from '@site/src/components/SupportedEnvironments';
|
||
import RateLimits from '@site/src/components/RateLimits';
|
||
import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
|
||
import DesktopInstallButtons from '@site/src/components/DesktopInstallButtons';
|
||
|
||
|
||
# Goose in 5 minutes
|
||
|
||
<SupportedEnvironments />
|
||
|
||
|
||
Goose is an open source AI agent that supercharges your software development by automating coding tasks. This quick tutorial will guide you through getting started with Goose!
|
||
|
||
|
||
## Install Goose
|
||
|
||
<Tabs>
|
||
<TabItem value="mac" label="macOS" default>
|
||
Choose to install Goose on CLI and/or Desktop:
|
||
|
||
<Tabs groupId="interface">
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
<DesktopInstallButtons/>
|
||
<div style={{ marginTop: '1rem' }}>
|
||
1. Unzip the downloaded zip file.
|
||
2. Run the executable file to launch the Goose Desktop application.
|
||
</div>
|
||
</TabItem>
|
||
<TabItem value="cli" label="Goose CLI">
|
||
Run the following command to install Goose:
|
||
|
||
```sh
|
||
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
|
||
```
|
||
</TabItem>
|
||
</Tabs>
|
||
</TabItem>
|
||
|
||
<TabItem value="linux" label="Linux">
|
||
<Tabs groupId="interface">
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
Desktop version is currently unavailable for Linux.
|
||
</TabItem>
|
||
<TabItem value="cli" label="Goose CLI">
|
||
Run the following command to install the Goose CLI on Linux:
|
||
|
||
```sh
|
||
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
|
||
```
|
||
</TabItem>
|
||
</Tabs>
|
||
</TabItem>
|
||
|
||
<TabItem value="windows" label="Windows">
|
||
<Tabs groupId="interface">
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
Desktop version is currently unavailable for Windows.
|
||
</TabItem>
|
||
<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).
|
||
|
||
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:
|
||
|
||
```bash
|
||
wsl --install
|
||
```
|
||
|
||
2. Restart your computer if prompted.
|
||
|
||
3. Run the Goose installation script:
|
||
```bash
|
||
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
|
||
```
|
||
:::tip
|
||
If you encounter any issues on download, you might need to install `bzip2` to extract the downloaded file:
|
||
|
||
```bash
|
||
sudo apt update && sudo apt install bzip2 -y
|
||
```
|
||
:::
|
||
</TabItem>
|
||
</Tabs>
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
## Configure Provider
|
||
|
||
Goose works with [supported LLM providers][providers]. When you install Goose, you'll be prompted to choose your preferred LLM and supply an API key.
|
||
|
||
<Tabs groupId="interface">
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
|
||
</TabItem>
|
||
<TabItem value="cli" label="Goose CLI">
|
||
Use the up and down arrow keys to navigate the CLI menu, and press Enter once you've selected a choice.
|
||
|
||
```
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Configure Providers
|
||
│
|
||
◇ Which model provider should we use?
|
||
│ Google Gemini
|
||
│
|
||
◇ Provider Google Gemini requires GOOGLE_API_KEY, please enter a value
|
||
│▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
|
||
│
|
||
◇ Enter a model from that provider:
|
||
│ gemini-2.0-flash-exp
|
||
│
|
||
◇ Hello! You're all set and ready to go, feel free to ask me anything!
|
||
│
|
||
└ Configuration saved successfully
|
||
```
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
<RateLimits />
|
||
|
||
:::tip Model Selection
|
||
Goose relies heavily on tool calling capabilities and currently works best with Anthropic's Claude 3.5 Sonnet and OpenAI's GPT-4o (2024-11-20) model.
|
||
:::
|
||
|
||
## Start Session
|
||
Sessions are single, continuous conversations between you and Goose. Let's start one.
|
||
|
||
<Tabs groupId="interface">
|
||
<TabItem value="cli" label="Goose CLI">
|
||
1. Make an empty directory (e.g. `goose-demo`) and navigate to that directory from the terminal.
|
||
2. To start a new session, run:
|
||
```sh
|
||
goose session
|
||
```
|
||
</TabItem>
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
After choosing an LLM provider, you’ll see the session interface ready for use.
|
||
|
||
Type your questions, tasks, or instructions directly into the input field, and Goose will immediately get to work.
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
## Write Prompt
|
||
|
||
From the prompt, you can interact with Goose by typing your instructions exactly as you would speak to a developer.
|
||
|
||
Let's ask Goose to make a tic-tac-toe game!
|
||
|
||
```
|
||
create an interactive browser-based tic-tac-toe game in javascript where a player competes against a bot
|
||
```
|
||
|
||
Goose will create a plan and then get right to work on implementing it. Once done, your directory should contain a JavaScript file as well as an HTML page for playing.
|
||
|
||
|
||
## Install an Extension
|
||
|
||
While you're able to manually navigate to your working directory and open the HTML file in a browser, wouldn't it be better if Goose did that for you? Let's give Goose the ability to open a web browser by enabling the `Computer Controller` extension.
|
||
|
||
<Tabs groupId="interface">
|
||
<TabItem value="cli" label="Goose CLI">
|
||
1. End the current session by entering `Ctrl+C` so that you can return to the terminal's command prompt.
|
||
2. Run the configuration command
|
||
```sh
|
||
goose configure
|
||
```
|
||
3. Choose `Add extension` > `Built-in Extension` > `Computer Controller`, and set timeout to 300s. This [extension](https://block.github.io/goose/v1/extensions/detail/nondeveloper) enables webscraping, file caching, and automations.
|
||
```
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Add Extension
|
||
│
|
||
◇ What type of extension would you like to add?
|
||
│ Built-in Extension
|
||
│
|
||
◇ Which built-in extension would you like to enable?
|
||
│ ○ Developer Tools
|
||
│ ● Computer Controller (controls for webscraping, file caching, and automations)
|
||
│ ○ Google Drive
|
||
│ ○ Memory
|
||
│ ○ JetBrains
|
||
│
|
||
◇ Please set the timeout for this tool (in secs):
|
||
│ 300
|
||
│
|
||
└ Enabled Computer Controller extension
|
||
```
|
||
4. Now that Goose has browser capabilities, let's resume your last session:
|
||
```sh
|
||
goose session -r
|
||
```
|
||
5. Ask Goose to launch your game in a browser:
|
||
</TabItem>
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
1. Locate the menu (`...`) in the top right corner of the Goose Desktop.
|
||
2. Select `Advanced settings` from the menu.
|
||
3. Under the `Extensions` section, toggle the `Computer Controller` extension to enable it. This [extension](https://block.github.io/goose/v1/extensions/detail/nondeveloper) enables webscraping, file caching, and automations.
|
||
4. Scroll back to the top and click `<- Back` in the upper left corner to return to your session.
|
||
5. Now that Goose has browser capabilities, let's ask it to launch your game in a browser:
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
```
|
||
open index.html in a browser
|
||
```
|
||
|
||
Go ahead and play your game, I know you want to 😂 ... good luck!
|
||
|
||
|
||
## Next Steps
|
||
Congrats, you've successfully used Goose to develop a web app! 🎉
|
||
|
||
Here are some ideas for next steps:
|
||
* Continue your session with Goose and it improve your game (styling, functionality, etc).
|
||
* Browse other available [extensions][extensions-guide] and install more to enhance Goose's functionality even further.
|
||
* Provide Goose with a [set of hints](/docs/guides/using-goosehints) to use within your sessions.
|
||
|
||
|
||
|
||
|
||
[handling-rate-limits]: /docs/guides/handling-llm-rate-limits-with-goose
|
||
[openai-key]: https://platform.openai.com/api-keys
|
||
[getting-started]: /docs/category/getting-started
|
||
[providers]: /docs/getting-started/providers
|
||
[managing-sessions]: /docs/guides/managing-goose-sessions
|
||
[contributing]: https://github.com/block/goose/blob/main/CONTRIBUTING.md
|
||
[quick-tips]: /docs/guides/tips
|
||
[extensions-guide]: /docs/getting-started/using-extensions
|
||
[cli]: /docs/guides/goose-cli-commands
|
||
[MCP]: https://www.anthropic.com/news/model-context-protocol
|