🚀 Gemini Genkit API

Building Firebase Genkit APIs using TypeScript and Golang with Google's Gemini AI models. This project features a creative Restaurant Menu Generator that creates themed restaurant menus based on your specifications!

🌟 Features

• TypeScript Implementation: Restaurant menu generator using Firebase Genkit
• Go Implementation: Coming soon!
• Google Gemini Integration: Powered by Gemini 2.5 Flash model
• Creative AI Outputs: Generate complete restaurant menus with themed items, descriptions, and pricing
• Interactive UI: Built-in Genkit developer UI for testing

📋 Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v18 or higher)
• pnpm (recommended) or npm
• Go (v1.24.1 or higher)
• Gemini API Key

Guide for Installing Golang

1. Download the latest Go version:

   # Check the latest version at https://golang.org/dl/
   wget https://go.dev/dl/go1.24.1.linux-amd64.tar.gz

2. Remove any previous Go installation and extract:

   sudo rm -rf /usr/local/go
   sudo tar -C /usr/local -xzf go1.24.1.linux-amd64.tar.gz

3. Add Go to your PATH:

   # Add to your ~/.bashrc or ~/.zshrc
   echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.zshrc
   echo 'export GOPATH=$HOME/go' >> ~/.zshrc
   echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.zshrc
   source ~/.zshrc

4. Verify installation:

   go version

Guide for Installing PNPM Package Manager

Option 1: Using NPM (if you have Node.js)

npm install -g pnpm

Option 2: Using Standalone Script (Recommended)

# Install using the official installer script
curl -fsSL https://get.pnpm.io/install.sh | sh -

# Add pnpm to your PATH (add to ~/.bashrc or ~/.zshrc)
echo 'export PNPM_HOME="$HOME/.local/share/pnpm"' >> ~/.zshrc
echo 'case ":$PATH:" in *":$PNPM_HOME:"*) ;; *) export PATH="$PNPM_HOME:$PATH" ;; esac' >> ~/.zshrc
source ~/.zshrc

Option 3: Using Node Version Manager (nvm):

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc

# Install latest LTS Node.js
nvm install --lts
nvm use --lts

# Install pnpm
npm install -g pnpm

🛠️ Setup Instructions

1. Clone the Repository

git clone https://github.com/dinocodesx/gemini-genkit-api.git
cd gemini-genkit-api

2. Environment Configuration

Run the bash command into your terminal to export the Gemini API Key:

export GEMINI_API_KEY="your_gemini_api_key_here"

To get your Gemini API Key:

1. Visit Google AI Studio
2. Create a new API key
3. Set up billng via GCP

3. Demo 1 - Go Setup

Navigate to the Go directory and install dependencies:

cd go
go mod tidy

4. Demo 2 - TypeScript Setup

Navigate to the TypeScript directory and install dependencies:

cd ts
pnpm install  # or npm install

🏃‍♂️ Running the Applications

TypeScript Application

cd ts
pnpm install -g genkit-cli
pnpm genkit:ui

This starts the Genkit developer UI at http://localhost:4000 where you can:

• Test the restaurantMenuGeneratorFlow interactively
• View detailed request/response data
• Experiment with different inputs
• Debug and monitor your flows

Golang Application

cd go
go run main.go

🎯 Usage Examples

Example Input JSON

When using the Genkit UI or calling the flow programmatically, use this JSON structure:

Space Diner Theme

{
  "name": "The Cosmic Cantina",
  "theme": "intergalactic space diner with retro-futuristic vibes",
  "cuisineType": "fusion comfort food",
  "priceRange": "mid-range",
  "atmosphere": "quirky and family-friendly with neon lights and space memorabilia",
  "specialFeature": "all dishes are served on LED-lit plates and the waitstaff wear space suits"
}

Pirate Tavern Theme

{
  "name": "The Rusty Anchor",
  "theme": "pirate tavern with nautical adventures",
  "cuisineType": "seafood and hearty pub food",
  "priceRange": "budget",
  "atmosphere": "rowdy and adventurous with wooden barrels and treasure maps",
  "specialFeature": "meals are served in treasure chests and drinks come in skull mugs"
}

Medieval Castle Theme

{
  "name": "Dragon's Den Feast Hall",
  "theme": "medieval castle dining with knights and dragons",
  "cuisineType": "European medieval fare",
  "priceRange": "upscale",
  "atmosphere": "grand and majestic with stone walls and candlelight",
  "specialFeature": "waiters dress as knights and meals are announced with a horn"
}

Minimalist Zen Theme

{
  "name": "Zen Garden Bistro",
  "theme": "minimalist zen garden",
  "cuisineType": "Japanese fusion",
  "priceRange": "fine-dining",
  "atmosphere": "peaceful and serene"
}

Input Schema

Field	Type	Required	Description
name	string	✅	Name of the restaurant
theme	string	✅	Restaurant theme or concept
cuisineType	string	✅	Type of cuisine
priceRange	enum	✅	"budget", "mid-range", "upscale", or "fine-dining"
atmosphere	string	✅	Atmosphere or vibe description
specialFeature	string	❌	Special feature or gimmick (optional)

Expected Output

The generator creates a complete restaurant menu including:

• Restaurant Details: Name, tagline, ambiance description
• Menu Sections: Appetizers, mains, desserts, beverages
• Menu Items: Creative names, detailed descriptions, themed pricing
• Specialties: Chef's special dishes (optional)
• Fun Elements: Amusing restaurant facts and themed wordplay

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Firebase Genkit for the amazing AI development framework
• Google Gemini for the powerful AI models
• The open-source community for continuous inspiration

---

Happy Coding! 🚀✨