Skip to content

TAP-GGC/Pi-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

201 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Template Logo

Pi&AI

A project for students to enrich their understanding in technology by team Pi Sharp

πŸ“’ About

The objective of the workshop is to introduce the concept prompt engineering to students and show them how we used it to make learning technology more interactive and fun.

This workshop showcases to students on how prompt engineering is used to interact with LLMS (Large Language Models). In this workshop students will be guided through on how to make their own AI API keys, how to integrate models in their coding projects, and prompt engineer them to their needs.

πŸ’‘ Project Information

  • Difficulty Level: Beginner/Intermediate
  • Target Audience: Elementary - College
  • Duration of Workshop: 30 - 35 min
  • Needed Materials: Keyboard, mouse, computer
  • Learning Outcomes: The primary goal of this project is to teach participants how genertive chat bots are created and how to train data.
  • Your Main Technology Frontend (HTML, CSS, JavaScript) and Backend (Python and Google Gemini)
  • Technology Ambassador Program (TAP) is a project-based class that provides a collaborative environment for students to work with their fellow classmates on a semester-long project using technologies of their choice. TAP strives to increase participation in IT through numerous outreach activities and workshops that are designed to showcase the creative and fun side of technology.
Commercial_TMNT.mp4

✏️ Team: Pi&AI

PI&AI Team

(From left to right: Keyvaun, Kyla, Lorena.)

  • Keyvaun Herring
  • Kyla Thorpe
  • Lorena Salazar

πŸŽ“ Advisors

  • Dr. Wei Jin
  • Dr. Xin Xu

πŸ“ƒ Project Description

PI - AI is an study assistant Web-Based chatbot powered by the AI model Gemini. This application was specifically designed to provide users with a more interactive and engaging way to learn technological subjects through AI-generated study plans and flashcards. In addition, we used a technique called prompt engineering to ensure that Gemini explains these concepts in the most easy and friendly way possible to ensure the user understands the concept they are trying to learn. When the user opens the application, they are greeted with a welcome prompt from PI-AI , and then asked to give PI-AI a question about any technological subject. After the user gives PI-AI a question, the user will then be given a brief description on that particular subject, followed by the option to either generate a study plan or flashcards for them. If the user chooses the study plan option, PI-AI will generate 8 tasks for them to complete. Each task will consist of a passage and two questions about that passage that the user answers. We as a team wanted to introduce prompt engineering to students to broaden their understanding of AI, so they could leverage it to their specific needs.

  1. Keyvaun Hering, Lorena Salazar, Kyla Thorpe, Wei Jin, Xin Xu. "A Real Fake Workshop", Fake Event, April 1, 2024, Georgia Gwinnett College.

πŸ‘ Outreach

  1. TAP Expo March 5, 2026, Georgia Gwinnett College: to promote the IT field and encourage college students to sign up for TAP.
  2. Atlanta Science Festival (ASF) March 7, 2026 Georgia Gwinnett College: A local event displaying STEM topics to allow young children in the community to learn about the sciences.
  3. ASF @ Atlanta March 21, 2026 Atlanta: On a much larger scale than the GGC event, ASF features universities and brands from around Atlanta to encourage the community to get involved with local clubs, find interest in their future school, and learn about different facets of science such as Information Technology.
  4. Super Saturday April 4, 2026 - Georgia Gwinnett College: An engaging day of demonstrating STEM projects and hands on learning to middle school students.
  5. STaRS April 24, 2026 - Georgia Gwinnett College: A showcase of research projects and innovation throughout the student body, where we hosted live demonstrations of our project to the fellow attendees.
  6. CREATE Conference May 1, 2026 - Georgia Gwinnett College: CREATE hosts different styles of presentations and, similarly to STaRS, showcases research throughout the student body. We specifically hosted a short workshop detailing our data findings from pre and post survey data from our outreach workshops throughout the semester.

πŸ”Ž Similar Projects

If you're interested projects that utilize AI, check out AIDiva(https://github.com/TAP-GGC/AiDiva)!

πŸ’» Technology

  • Python is a high level programming language designed to be easily readable and debuggable, and is one of the most widely used programming languages to build website, software, automate tasks, and analyse data.
  • Python was used to system prompt our AI model and similarly acts in the workshop to demonstrate how students can train data to create their own.
  • Gemini is a Large Language Model developed by Google
  • HTML, CSS, JavaScript

Project Setup/Installation

Follow the steps below to get Pi&AI running on your computer. No coding experience needed!


Step 1 β€” Get a Gemini API Key

Pi&AI is powered by Google's Gemini AI. You will need a free API key to use it.

  1. Go to Google AI Studio
  2. Sign in with a Google account
  3. Click "Create API key" and copy the key somewhere safe

Disclaimer: Google has recently updated their terms and services related to age verification. This may mean you are unable to access Google AI Studio due to lacking proper verification on your email. Because of the nature of API keys, we cannot share our own with you. We recommend trying different accounts if possible, but this step may make using the website chat impossible.


Step 2 β€” Download the Project

  1. At the top of this GitHub page, click the green "Code" button
  2. Select "Download ZIP"
  3. Once downloaded, extract/unzip the folder to your Desktop or anywhere you like

Step 3 β€” Install Visual Studio Code (VS Code)

VS Code is a free code editor that makes it easy to view and edit project files.

  1. Go to code.visualstudio.com
  2. Click the Download button for your operating system (Windows, Mac, or Linux)
  3. Run the installer and follow the on-screen instructions
  4. Once installed, open VS Code
  5. Then open the extracted folder into the editor

Recommended Extension:

  • Open VS Code, click the Extensions icon on the left sidebar (or press Ctrl+Shift+X)
  • Search for "Python" and install the extension by Microsoft β€” this gives you syntax highlighting and makes working with the project much easier

Step 4 β€” Install Python

If you do not already have Python installed:

  1. Go to python.org/downloads
  2. Download and install Python 3.8 or higher
  3. During install, check the box that says "Add Python to PATH"

To verify it installed correctly, open the terminal in VS Code (Terminal β†’ New Terminal or press Ctrl+ `) and run:

python --version

Step 5 β€” Create a Virtual Environment

A virtual environment keeps the project's packages separate from the rest of your computer. This is required before installing dependencies.

  1. In VS Code, open the terminal (Terminal β†’ New Terminal or press Ctrl+ `)

  2. The terminal should already be in your project folder. If not, use File β†’ Open Folder to open the extracted project folder first

  3. Create the virtual environment:

    python -m venv .venv
    
  4. Activate it:

    • Windows:
      .venv\Scripts\activate
      
    • Mac/Linux:
      source .venv/bin/activate
      

    You will know it is active when you see (.venv) at the start of your terminal line.


Step 6 β€” Install Dependencies

With your virtual environment active, run this in the VS Code terminal:

pip install -r Pi-AI-main/backend/requirements.txt

Step 7 β€” Add Your API Key

  1. In VS Code's file explorer (left sidebar), open the backend folder
  2. Right-click inside the backend folder and select "New File", name it .env
  3. Add this line to the file:
    GEMINI_API_KEY=paste_your_api_key_here
    
  4. Replace paste_your_api_key_here with the key you copied in Step 1, then save the file

Step 8 β€” Run the App

  1. In the VS Code terminal, run:
    python Pi-AI-main/backend/app.py
    
  2. You should see output that includes a line like:
    Running on http://127.0.0.1:5000
    
  3. Open your browser and go to http://127.0.0.1:5000

Pi&AI should now be running! Start chatting with Pi to explore tech topics, generate flashcards, and build study plans.


Troubleshooting

Problem Fix
python not found Try python3 instead of python
pip not found Try pip3 instead of pip
API key error Double-check your .env file has no extra spaces around the = sign
Port already in use Close other terminals and try again
.env file corrupted Double check instructions and use VSCode AI if stuck

Short Demo Instructions

Demo Video on how our website functions (this is a placeholder)

Workshop Instructions

Click here to view workshop walkthrough pdf file

Click here for the Google Collab file

Our Game Workshop Video (this is a placeholder)

About

Spring 2026

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Generated from TAP-GGC/project-template