>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3559216. --> Reported by: [steven snedker](https://www.drupal.org/user/3608094) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>On <a href="https://www.drupal.org/project/ai_provider_amazeeio">the Project page</a> the <em>Installation</em> paragraph goes like this:</p> <blockquote><p>1. Using Composer:<br> composer require drupal/ai_provider_amazeeio:^1.1<br> [old version, hardcoded]</p> <p>2. Enable the Module:<br> drush en ai_provider_amazeeio<br> [Less interesting, the interesting bits are the bits specific to this module]</p> <p>3. Configure the Provider:<br> Navigate to /admin/config/ai/settings.<br> Select "amazee.io" as your AI provider.<br> Enter your amazee.io API credentials.</p></blockquote> <p>[Not accurate in any way, shape or form]</p> <p>We should not make the lives of our users unnecessarily hard.</p> <p>The successful installation is a better three step process:</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>A better three step process:</p> <p>1. Install and enable the module.</p> <p>2. Get an Amazee account.<br> Go to <em>/admin/config/ai/providers/amazeeio</em> on your site, and type in your e-mail address.<br> You should soon receive a low level cryptic e-mail with a verification code and no further instructions.<br> Copy and paste that code into the text box on <em>/admin/config/ai/providers/amazeeio</em> on your site, and choose where you wish to have your Amazee vectorDBs and services hosted. The page should now read "Setup amazee.ai AI Authentication" and sport a big, red "Disconnect" button.</p> <p>3. Configure Amazee.ai AI as a provider:<br> Navigate to <em>/admin/config/ai/settings</em> and have Amazee.ai AI provide some of the services for your site.<br> Amazee mostly does chat and embeddings. It will not do Text to Image, Text to Speech, Speech to Text, Moderation etc.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <p>Write and publish correct and useful installation instructions.</p> <p>While we're at it:</p> <p>The installation instructions at <a href="https://amazee.ai/drupal-ai-provider">https://amazee.ai/drupal-ai-provider</a> are also incorrect. They'll only net the user a "Failed to initialize amazee.ai client".</p> <p><img src="https://www.drupal.org/files/issues/2025-11-21/amazee_faulty_recipe_1.png" alt="Bold and incorrect"><br> <img src="https://www.drupal.org/files/issues/2025-11-21/amazee_faulty_recipe_2.png" alt="Ending in tears of frustration"></p> <p>I also had trouble making the recipe work, but that could be a <em>me</em> problem.</p> <p><img src="https://www.drupal.org/files/issues/2025-11-21/amazee_recipe_not_working.png" alt="Recipe rejected"></p>