Gen AI Trivia is an interactive trivia application that generates questions and answers using artificial intelligence. It provides an engaging and educational experience for users to test their knowledge across various topics. Gen AI Trivia utilizes advanced natural language processing and machine learning techniques to generate unique and challenging trivia questions. The application consists of a backend API that handles question generation and a user-friendly frontend interface for users to interact with the trivia game.

The project's folder structure is organized as follows:

Before installing and running Gen AI Trivia, ensure that you have the following prerequisites:

• Node.js (version 14 or higher)

• NPM (version 6 or higher)

• Python / Pip (version 3.9 or higher)

• AWS CloudFormation Development Kit (CDK)

• AWS account with necessary permissions

• AWS CLI installed and configured

Note: This solution can only be used in AWS Regions that have access to the Amazon Bedrock Claude 3 Sonnet model.

The Gen AI Trivia solution uses the Amazon Bedrock Claude 3 Sonnet model as the method to generate the topic questions.

1. Navigate to the Amazon Bedrock Service.

   

2. Click on "Get started".

   

3. If this is your first time using Amazon Bedrock, you will receive a welcome message. From there, click on "Manage model access".

   

4. Once on the Model access page, click on "Enable specific models".

   

5. Scroll down to the "Anthropic" section and click on the box next to the "Claude 3 Sonnet" model. Scroll down to the bottom of the page and click "Next".

   

6. Review that you've selected the correct model and click "Submit".

   

7. Once the model access request has been submitted, it should be approved. To verify it was approved, navigate back to the "Model access" page and ensure you see an "Access granted" text next to the requested model.

   

The Gen AI Trivia code will deploy a CI/CD Pipeline that will deploy the Gen AI Trivia application. To install and set up the Gen AI Trivia Pipeline, follow these steps:

1. Clone the repository.

   git clone https://github.com/aws-samples/gen-ai-trivia.git

2. Navigate to the project directory.

   cd gen-ai-trivia

3. Install Python dependencies.

   pip install -r requirements.txt

4. Ensure you have access to an AWS Account.

5. Create initial CDK Bootstrap dependencies, then generate AWS CloudFormation Code and finally deploy the generated code.

   cdk bootstrap
   cdk synth gen-ai-trivia-pipeline
   cdk deploy gen-ai-trivia-pipeline --require-approval never

   After the code has run successfully, the CI/CD pipeline should automatically start. It will use an AWS CodeCommit repository that the solution creates. Once the pipeline completes, continue to the next step. The pipeline will create 3 AWS CloudFormation stacks (gen-ai-trivia-pipeline, gen-ai-trivia-application, and gen-ai-trivia-s3-artifact-deployment).

   

6. Add users to the Amazon Cognito User Pool.

   a. Navigate to the Amazon Cognito service.

   

   b. Ensure you're in the "User pools" section and select the generated user pool.

   

   c. Ensure you're in the "Users" section and click on "Create user".

   

   d. Select "Send an email invitation", enter in the desired "User name", enter an email address you have access to, select "Mark email address as verified", and select "Generate a password". Doing the following will generate an email with a password for the first time you log in.

   

7. Once the deployment is complete, access the application using the provided URL. The URL can be found in the "Outputs" tab of the AWS CloudFormation stack "gen-ai-trivia-application".

   

   Or run the following command to get the URL:

   aws cloudformation describe-stacks --stack-name "gen-ai-trivia-application" --query 'Stacks[*].Outputs[?OutputKey==`oTerraformBucket`].OutputValue' --output text

8. Navigate to and log in to the URL from step 7. Use the email with the generated password from step 5 to log in. Once you are logged in, you will be prompted to change the password.

   

9. Work hard. Have fun. Make history.

   

1. To remove the AWS CloudFormation Stacks along with the AWS Resources they create, run the following commands:

   cdk destroy gen-ai-trivia-s3-artifact-deployment --force
   aws cloudformation delete-stack --stack-name gen-ai-trivia-application
   aws cloudformation wait stack-delete-complete --stack-name gen-ai-trivia-application
   cdk destroy gen-ai-trivia-pipeline --force

We welcome contributions to improve the Gen AI Trivia project. Please refer to the CONTRIBUTING.md file for detailed guidelines on how to contribute.

For common issues and their resolutions, please refer to the FAQ.md file.

This project is licensed under the MIT License.