Upload 3 files

README.md

@@ -1,31 +1,2 @@
----
-license: mit
----
-# 🐝 Spelling Bee AI Word Finder (Powered by Python + OpenAI)
-
-This project helps Spelling Bee students efficiently search and navigate large word lists using an AI-powered keyword matching and scoring system.
-
-As a mother of two Spelling Bee kids and a Senior Cloud & Streaming Architect transitioning into AI/ML, I built this project to demonstrate real-world applications of language models and search intelligence.
-
-## 🔍 Use Case
-
-- Helps kids search for related words based on partial input
-- Uses GPT-style prompts and fuzzy match logic for intelligent filtering
-- Ideal for vocabulary prep, educational enrichment, and smart search
-
-## 💡 How It Works
-
-- Takes input from the user (word part or keyword)
-- Uses Python logic + optional OpenAI prompt engineering
-- Scores and ranks matched words from predefined lists
-- Can be enhanced with GPT-4 APIs for intelligent reasoning
-
-## 🛠️ Technologies Used
-
-- Python (Core logic)
-- OpenAI API (for enhanced matching)
-- CLI Interface
-- Hugging Face Hub (Model hosting)
-
-## 📁 File Structure
-
+# ai-spelling-bee-word-finder
+Simple AI-powered Word Search Engine for Spelling Bee Kids using Python and NLP fuzzy matching

spelling_words.csv

@@ -0,0 +1,501 @@
+Word
+agon
+agonic
+agonize
+agony
+agora
+agora
+agoraphobia
+agranulocytosis
+agrarian
+agravic
+agree
+agreeable
+agribusiness
+agriculture
+agriology
+agriotype
+agrogorod
+agronome
+agronomist
+agronomy
+aguaji
+aguish
+ahead
+ahem
+ahimsa
+ahorse
+aiguille
+aiguillette
+aikido
+ailanthus
+aileron
+ailment
+aioli
+airborne
+airbrush
+airbus
+aircraft
+airedale
+airfoil
+airframe
+airport
+airsickness
+airstream
+airtight
+aisle
+aisling
+aitch
+aition
+akaryote
+akimbo
+akin
+akinesia
+akropodion
+aktograph
+alabaster
+alacrity
+alar
+alarmable
+alarmist
+alary
+alas
+alba
+albacore
+albarium
+albatross
+albedo
+albedometer
+albeit
+albino
+album
+alburnum
+alcarraza
+alcazar
+alchemy
+alcogel
+alcohol
+alcoholature
+alcoholism
+alcove
+aldehyde
+alder
+alderman
+aldosterone
+aleatoric
+aleatory
+alee
+alegar
+alembic
+alepidote
+aleuronat
+alewife
+alexandrite
+alexia
+alfalfa
+alfresco
+algae
+algebra
+algebraically
+algerian
+algesia
+algetic
+algid
+algometer
+algorithm
+alias
+alibi
+alien
+alienage
+alienation
+aliferous
+align
+alike
+alimentary
+alimony
+aliphatic
+aliquant
+aliquot
+alison
+aliteracy
+aliunde
+aliveness
+alkalescence
+alkali
+alkalify
+alkaline
+alkane
+alkyd
+allargando
+allay
+allayment
+allegation
+allege
+allege
+allegeable
+allegedly
+allegiance
+allegiant
+allegorist
+allegorize
+allegory
+allegretto
+allegro
+allemande
+allergenic
+allergy
+alleviant
+alleviate
+alleyway
+alliaceous
+alliance
+allied
+alligator
+allision
+alliteration
+allocate
+allocution
+allonym
+allopelagic
+allot
+allotment
+allotropic
+allotropy
+allotted
+allowable
+alloy
+allspice
+alluded
+allure
+allusion
+allusively
+alluvial
+alluviation
+alluvium
+ally
+almanac
+almandite
+almighty
+almond
+almoner
+alms
+almuerzo
+alnico
+aloe
+aloft
+alogia
+alogism
+aloha
+aloisiite
+alongside
+aloof
+alopecia
+alopecoid
+alpaca
+alpenglow
+alpestrine
+alphabetical
+alphabetize
+alphagram
+alphanumerical
+alpine
+altarpiece
+altazimuth
+altercation
+alternate
+alternative
+alternativity
+althorn
+although
+altigraph
+altimeter
+altimetry
+altiplanation
+altiplano
+altitude
+alto
+altocumulus
+altogether
+altostratus
+altricial
+altruism
+altruistic
+alum
+aluminiferous
+aluminotype
+aluminous
+aluminum
+alumnus
+alveolar
+alveolate
+always
+alyssum
+amadelphous
+amah
+amalgam
+amalgamation
+amandine
+amantadine
+amanuensis
+amaranth
+amaranthine
+amaretto
+amaryllis
+amass
+amateur
+amateurish
+amathophobia
+amazon
+amazonite
+ambassador
+amber
+amberjack
+ambidexterity
+ambidextrous
+ambience
+ambient
+ambiguity
+ambiguous
+ambitious
+ambivalently
+amble
+amblyopia
+ambrette
+ambrosia
+ambry
+ambulance
+ambulation
+ambulatory
+ambuscade
+ambush
+ameliorant
+ameliorate
+amen
+amenable
+amend
+amendment
+amenities
+amenity
+amerce
+amercement
+american
+americium
+amertoy
+amethyst
+amiable
+amicable
+amice
+amidol
+amigo
+amine
+amiss
+amity
+ammeter
+ammonia
+ammoniac
+ammoniacal
+ammunition
+amnesia
+amnesty
+amok
+amole
+amontillado
+amorous
+amorphous
+amortization
+amount
+amperage
+ampere
+ampersand
+amphetamine
+amphibian
+amphibious
+amphichrome
+amphicrania
+amphidromic
+amphioxus
+amphitheater
+amphora
+amphorae
+amphoric
+amphoteric
+ampicillin
+ample
+ampliate
+ampliative
+amplifier
+amplify
+amplitude
+amply
+ampullae
+amputee
+amulet
+amuse
+amyelonic
+amygdala
+amygdaline
+amylaceous
+amyotonia
+amyotrophic
+anabasis
+anabibazon
+anablepid
+anabolic
+anachronism
+anachronous
+anaclastic
+anacoluthon
+anaconda
+anacreontic
+anadiplosis
+anadromous
+anaglyph
+anagnorisis
+anagogic
+anagram
+analects
+analemma
+analgesic
+anallobar
+analogous
+analogy
+analysand
+analysis
+analytically
+analyze
+anamnesis
+ananias
+ananym
+anaphora
+anaphoric
+anaphylactic
+anaphylaxis
+anaptyxis
+anaqua
+anarchic
+anarchism
+anarchy
+anastomosis
+anastrophe
+anathema
+anathematize
+anatocism
+anatomy
+anaudia
+anautogenous
+ancestor
+ancestral
+ancestry
+anchor
+anchorage
+anchoritic
+anchovy
+anchusa
+ancient
+ancillary
+ancipital
+andiron
+andradite
+andragogy
+androcracy
+androgynism
+androgynous
+android
+anecdotal
+anecdote
+anechoic
+anemochore
+anemology
+anemometer
+anemometry
+anemone
+anemosis
+anemotropism
+anent
+anenterous
+aneroid
+anesthesia
+anesthetic
+anesthetize
+aneurysm
+anfractuous
+angary
+angel
+angelfish
+anger
+angiitis
+angina
+anglaise
+anglicize
+angling
+anglophilia
+angora
+angstroms
+anguish
+angular
+angularity
+angwantibo
+anhedonia
+anhinga
+anhydride
+anhydrous
+aniconic
+anility
+animadversion
+animal
+animalcule
+animate
+animation
+animism
+animosity
+animus
+anionic
+anise
+anisette
+ankh
+ankle
+anklet
+ankylosaur
+anlace
+annals
+annates
+anneal
+annealed
+annelid
+annex
+annexation
+annihilate
+annihilation
+anniversary
+annotate
+announce
+announcer
+annoyance
+annual
+annuity
+annul
+annularity
+annulling
+annulment
+anodyne
+anoia
+anoint
+anomalous
+anomaly
+anon
+anonymous
+anorak
+anorexia
+anorexic
+anorthopia
+anosmatic
+anosmic
+ansa
+anschluss
+anserous
+answerer
+antacid
+antaean
+antagonist
+antarctic
+ante

word_finder.py

@@ -0,0 +1,54 @@
+import os
+import pandas as pd
+from fuzzywuzzy import process
+from openai import OpenAI
+from dotenv import load_dotenv
+
+# Load environment variables (OpenAI key)
+load_dotenv()
+openai_api_key = os.getenv("OPENAI_API_KEY")
+
+# Initialize OpenAI client
+client = OpenAI(api_key=openai_api_key)
+
+# Load word list
+word_df = pd.read_csv('spelling_words.csv', header=None)
+word_list = word_df[0].tolist()
+
+# Fuzzy search function
+def search_word(user_input, word_list, top_n=5):
+    matches = process.extract(user_input, word_list, limit=top_n)
+    return matches
+
+# Function for AI-powered responses (definitions, origins, etc.)
+def get_ai_response(query):
+    response = client.chat.completions.create(
+        model="gpt-4-turbo",
+        messages=[
+            {"role": "system", "content": "You are an expert spelling bee coach. Provide clear definitions, word origins, usage examples, and helpful memory tips for kids."},
+            {"role": "user", "content": query}
+        ],
+        temperature=0.3,
+        max_tokens=200
+    )
+    return response.choices[0].message.content.strip()
+
+# Main interaction loop
+if __name__ == "__main__":
+    print("🎉 Welcome to Spelling Bee Word Finder with AI! 🎉")
+    while True:
+        query = input("\nEnter a word or ask a question ('define ubiquitous', 'origin onomatopoeia') or type 'exit' to quit: ").strip()
+        if query.lower() == "exit":
+            print("Goodbye! Keep practicing 😊")
+            break
+        
+        # Check if the query is asking for a definition or origin
+        if query.lower().startswith(("define", "meaning", "origin", "use", "sentence", "explain")):
+            print("\n🧠 AI Response:")
+            print(get_ai_response(query))
+        else:
+            # Default fuzzy search for spelling matches
+            results = search_word(query, word_list)
+            print("\n📌 Top Matches (Fuzzy Search):")
+            for match, score in results:
+                print(f"{match} (Confidence: {score}%)")