# Installation

{% hint style="info" %}
Mac users please read this first: [#mac-users](https://promptgeek.gitbook.io/promptgeek-documentation/troubleshooting#mac-users "mention")
{% endhint %}

1.

```
<figure><img src="https://public-files.gumroad.com/9tyolftys6gs0rtdwgcxjhw4pnof" alt=""><figcaption></figcaption></figure>
```

2. There are two ways to use it, one is just to create your prompts to use in other apps and the other is to connect an API to generate images directly in the app
3. To connect an API: <https://youtube.com/shorts/NtHyJOE81Js?feature=share>&#x20;

{% embed url="<https://youtube.com/shorts/NtHyJOE81Js?feature=share>" %}

1. You need to create an account with Google AI Studio, set up billing (google normally gives users free credits to start with) and in API keys select **Create API key, name it and add it to a project and save**

   <figure><img src="https://public-files.gumroad.com/b7xck7ae0zrqi4wg0i2k2835kpb8" alt=""><figcaption></figcaption></figure>
2. You will then need to name your key, create a project and then click create key on the box

   <figure><img src="https://public-files.gumroad.com/2krkef6ryhvavjpt3hrvm93slyw1" alt=""><figcaption></figcaption></figure>
3. This is your new key but it is not ready yet as it is set on the free tier. You have to set up billing then it will turn from "Free tier" to "Tier 1" this is now ready to copy.

   <figure><img src="https://public-files.gumroad.com/jirkqbfc17ieed0fjwx3d17o7wyk" alt=""><figcaption></figcaption></figure>

   <br>
4. Then click here and select copy API key. Do not share your API key publicly keep it private and secure

   <figure><img src="https://public-files.gumroad.com/c5ctivnste2bf5kqt4rsu01qfxet" alt=""><figcaption></figcaption></figure>
5. Back in the app select **Connect API Key**

   <figure><img src="https://public-files.gumroad.com/cu2ggpr1szgbq9okdzg8035ntedl" alt=""><figcaption></figcaption></figure>

   <br>
6. Paste your API key in here and save it

   <figure><img src="https://public-files.gumroad.com/b8l0eqopii3v2u7x8mrocb5v2yo0" alt=""><figcaption></figcaption></figure>

   <br>
7. Now you are ready to generate images directly in the prompt builder app
8. Type in a description of the subject, action and in the environment tab the description of the setting

   <figure><img src="https://public-files.gumroad.com/5re0yh343ttdc335pbfd786nwkzm" alt=""><figcaption></figcaption></figure>
9. Select your Shot angle, lighting source, camera body, visual styles or effects (using too many will weaken the overall influence of them so be selective and use just a few at a time)

   <figure><img src="https://public-files.gumroad.com/yjdgmy6jxyc14w2a51rhwocq4s6s" alt=""><figcaption></figcaption></figure>
10. You're now ready to generate, if using the API you can select 1k, 2k or 4k output (beware these are charged per generation to your studio account.) If you want to use a different app to generate like Gemini you can click the prompt to copy it to the clipboard. You can then also use the copy scene json afterwards to copy a json of the multiple angles and use that in Gemini chat as well. Otherwise hit generate to create the image directly in the app.

    <figure><img src="https://public-files.gumroad.com/5o8fj82qexbbxv6ydnvk41nrxrba" alt=""><figcaption></figcaption></figure>
11. You then have your result and can click Generate Scene to get 4 alternative angles

    <figure><img src="https://public-files.gumroad.com/0a2ql4mp0x8rthlyf13bct3bx244" alt=""><figcaption></figcaption></figure>
12. This is the result when you use the json prompt inside Gemini app:

    <figure><img src="https://public-files.gumroad.com/acc6tjyi0c31fnrfh52nwm3m4vxe" alt=""><figcaption></figcaption></figure>

TROUBLESHOOTING -

### MAC USERS

The MacBook version is a beta right now. I am not on the Apple Developer Program yet so gatekeeper is flagging the app as damaged.

If you want to use it there are some steps to get around this.

**1. Open the App Using Control-Click (Recommended)**

* Open **Finder**, go to **Applications**, locate the app.
* **Press Control** while clicking the app icon.
* Select **Open** from the shortcut menu.
* Click **Open** again in the confirmation dialog.
* The app will now be trusted and can be opened normally.

**2. Use the “Open Anyway” Button in System Settings**

* After the error appears, close the dialog.
* Go to **System Settings > Privacy & Security**.
* Under **Security**, you’ll see a message like: *“\[App] was blocked from use because it is not from an identified developer.”*
* Click **Open Anyway**.
* Confirm with **Open** when prompted.

For Mac users who didn't get the option to 'Open anyway' in security System Settings, try this in terminal. Open the Terminal app, paste in 'xattr -cr ' (note the space after cr) then drag 'Nano Banana Pro Prompt Builder' app to the Terminal at the end, then hit enter. You should now be able to open the app from Applications.

<br>

### WHITE SCREEN -

Some people have had a white screen after installation.

The issue is caused by corrupted temporary files within the application's data directory. Clearing the local cache resolves the UI rendering error.

How to Clear the Application Cache

If the "White Screen" error occurs again, follow these steps to reset the interface data:

1. Close the application completely (check the Task Manager to ensure no background processes are running).
2. Press Win + R on your keyboard to open the "Run" dialog.
3. Type %AppData% and press Enter. This will open your user's "Roaming" folder.
4. Locate and open the folder named after your application.
5. Find and delete the following sub-folders: Cache
6. Restart the application.