Wordcraft is an educational puzzle game where you fuse words together to craft new words.
It's powered by the Google Gemini AI API, which allows for near limitless gameplay that's always fresh and engaging.
For example:

Because each word can be combined with nearly every other word to craft a new word combination, the number of possible combinations rises exponentially with each new word added. The task of writing a new word combination for every unique pair of words would take an extremely long time for a human.
To solve this problem, I developed Python scripts that automates this process using the Google Gemini AI API.

Using the Gemini API Python SDK, the scripts perform the following actions:
1: The Python script reads a list of provided words, then cycles through every possible pair of words.
Eg: (Air, Fire), (Air, Earth), (Air, Air), (Air, Water), (Earth, Earth), (Earth, Fire), (Earth, Water), (Fire, Fire), (Fire, Water), etc...
2: For each unique word pair, Gemini AI is asked to generate a related word. If this word is new, it's added to the word list.
Eg: (Air + Fire = Smoke), (Air + Earth = Dust), (Air + Air = Tornado), (Air + Water = Wave), etc...
3: Gemini AI is asked to provide an emoji for the new word.
Eg: (Smoke = πΆβπ«οΈ), (Dust = π¨), (Tornado = πͺοΈ), (Wave = π), etc...
4: The Python script can then be run again to generate new pairs and word combinations for the new words generated.
Eg: Generates new words for (Smoke + Dust), (Smoke + Tornado), (Tornado + Wave), etc...
π‘This method allows for common combinations to be stored locally, reuducing unnecessary API calls. In Wordcraft alpha v2, if a combination isn't found locally, the game will ask the Gemini API to generate a new word combination.
Each day, everyone gets the same challenge to craft a specific word - but who can get the best score?
Wordcraft is designed to be an engaging social game and there are many paths to solving the daily challenge.
When you beat the challenge, your stats are copied to your clipboard for sharing.

Here are some hints for testing and beating the current Wordcraft challenges:

Wordcraft allows for near limitless gameplay thatβs always fresh and really brings out your creativity, but itβs also secretly an educational tool as well!
In Wordcraft alpha v2, you can ask Gemini to explain definitions and see why a specific combination was chosen, giving you insights into language and associations.
By integrating educational content into an engaging social game, I hope it can promote literacy and comprehension among players and result in a positive community impact.
Examples for (Eruption + Flood = Tsunami) and (Earth + Water = Plant):

Wordcraft alpha v1 is available now on:
π‘Note for judges: There are two GitHub repos: GoogleGeminiHackathon_PublicFiles and GoogleGeminiHackathon (private). Testing@Devpost.com has been added as a collaborator for the private repo so that source code can be viewed. Please get in contact if you have any issues.
Due to time constraints with this hackathon, alpha v1 of Wordcraft is stable, but hasn't been tested on a wide range of devices. Some AI features (like definitions and asking the Gemini API for additional combinations) aren't yet available on the web version of the game.
After the conclusion of this hackthon, I plan to further develop Wordcraft to refine unstable features currently present in alpha v2. I also plan on adding new features, new challenges, far more local word combinations, and better AI integration. This will include publishing a mobile web version, as well as an Android app on the Google Play Store.


Log in or sign up for Devpost to join the conversation.