From c3e70ad5c93033894f4d8964facccc31a80e1945 Mon Sep 17 00:00:00 2001
From: Adewale Abati <acekyd01@gmail.com>
Date: Tue, 17 Dec 2024 13:18:37 +0300
Subject: [PATCH] docs: Add using goose free guide (#482)

---
 docs/guidance/using-goose-free.md | 42 +++++++++++++++++++++++++++++++
 mkdocs.yml                        |  1 +
 2 files changed, 43 insertions(+)
 create mode 100644 docs/guidance/using-goose-free.md

diff --git a/docs/guidance/using-goose-free.md b/docs/guidance/using-goose-free.md
new file mode 100644
index 00000000..bceb9346
--- /dev/null
+++ b/docs/guidance/using-goose-free.md
@@ -0,0 +1,42 @@
+# Using Goose for Free
+
+Goose is a free and open-source developer agent that you can start using right away, but not all supported [LLM Providers][providers] provide a free tier. 
+
+Below, we outline a couple of free options and how to get started with them.
+
+
+## Google Gemini
+Google Gemini provides free access to its AI capabilities with some limitations. To start using the Gemini API with Goose, you need an API Key from [Google AI studio](https://aistudio.google.com/app/apikey).
+
+Update your `~/.config/goose/profiles.yaml` file with the following configuration:
+
+```yaml title="profiles.yaml"
+default:
+  provider: google
+  processor: gemini-1.5-flash
+  accelerator: gemini-1.5-flash
+  moderator: passive
+  toolkits:
+  - name: developer
+    requires: {}
+```
+
+When you run `goose session start`, you will be prompted to enter your Google API Key.
+
+> [!NOTE] 
+> At the moment, the `synopsis` toolkit isn't supported by Google Gemini, so we use the `developer` toolkit to interact with the API. 
+
+
+
+
+
+## Limitations
+
+These free options are a great way to get started with Goose and explore its capabilities. However, if you need more advanced features or higher usage limits, you can always upgrade to a paid plan.
+
+---
+
+This guide will continue to be updated with more free options as they become available. If you have any questions or need help with a specific provider, feel free to reach out to us on [Discord](https://discord.gg/block-opensource) or on the [Goose repo](https://github.com/block/goose).
+
+
+[providers]: https://block.github.io/goose/plugins/providers.html
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 45fd26e0..55091f44 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -119,6 +119,7 @@ nav:
   - "Contributing": contributing.md
   - Guides:
       - "Getting Started": guidance/getting-started.md
+      - "Using Goose for Free": guidance/using-goose-free.md
       - "Managing Goose Sessions": guidance/managing-goose-sessions.md
       - "Quick Tips": guidance/tips.md
       - "Using Goosehints": guidance/using-goosehints.md