Assessment Generator is a sample application generating assessment questions for a provided reference material and lecture note(s).
Key features (Teacher)
- Course addition: Teacher can add a new course
- Assessment template creation: Teacher can define an assessment set with the number of questions for each level (easy, medium, hard)
- Manage knowledge base: Teacher can upload reference material for a pre-defined course
- Generate assessments: Teacher can generate assessments by using a predefined assessment template and course.
Short clip depicting the teacher journey
Teacher-Journey.mp4
Key features (Student)
- Assessments: Start and reviews assessment
Short clip depicting the student journey
Student-Journey.mp4
The architecture can be split into 3 key blocks:
- Front-end architecture
- Document ingestion architecture
- Assessment generator architecture
Architecture diagrams depicting key components in those blocks are provided below:
Ensure you have the following installed:
- Node and npm
- Docker
- CDK
Request model access on Amazon Bedrock for the following:
- Amazon Titan Embeddings G1 - Text
- Anthropic Claude 3.5 Sonnet
To deploy this project in your own AWS account, ensure your AWS region is set to the same region where you have Bedrock Model access. Then, run the following commands:
git clone [email protected]:aws-samples/assessment-generator.git
cd assessment-generator
npm ci
npx cdk bootstrap --qualifier gen-assess
npm run cdk deployAfter successfully deploying, you will be able to access the Frontend UI with the CloudFront URL in the CDK outputs. Next:
- Create an account for student using the frontend with "Create Account" tab and Role as "students"
- Create an account for teacher using the frontend with "Create Account" tab and Role as "teachers"
- For teacher journey: Login with the created teacher account
- For student journey: Login with the created student account
See CONTRIBUTING for more information.
This library is licensed under the MIT-0 License. See the LICENSE file.