Overview
This project demonstrates how to build an AI-enhanced weather service using Genkit, TypeScript, OpenWeatherAPI, and GitHub models. The application showcases modern Node.js patterns and AI integration techniques.
Prerequisites
Before you begin, ensure you have the following:
- Node.js installed on your machine
- GitHub account and access token for GitHub APIs
- An OpenWeatherAPI key for fetching weather data
- Genkit CLI installed on your machine
Technical Deep Dive
AI Configuration
The core AI setup is initialized with Genkit and GitHub plugin integration. In this case, we are going to use the OpenAI GPT-3 model:
const ai = genkit({
plugins: [
github({ githubToken: process.env.GITHUB_TOKEN }),
],
model: openAIO3Mini,
});
Weather Tool Implementation
The application defines a custom weather tool using Zod schema validation:
const getWeather = ai.defineTool(
{
name: 'getWeather',
description: 'Gets the current weather in a given location',
inputSchema: weatherToolInputSchema,
outputSchema: z.string(),
},
async (input) => {
const weather = new OpenWeatherAPI({
key: process.env.OPENWEATHER_API_KEY,
units: "metric"
})
const data = await weather.getCurrent({locationName: input.location});
return `The current weather in ${input.location} is: ${data.weather.temp.cur} Degrees in Celsius`;
}
);
AI Flow Definition
The service exposes an AI flow that processes weather requests:
const helloFlow = ai.defineFlow(
{
name: 'helloFlow',
inputSchema: z.object({ location: z.string() }),
outputSchema: z.string(),
},
async (input) => {
const response = await ai.generate({
tools: [getWeather],
prompt: `What's the weather in ${input.location}?`
});
return response.text;
}
);
Express Server Configuration
The application uses the Genkit Express plugin to create an API server:
const app = express({
flows: [helloFlow],
});
Full Code
The full code for the weather service is as follows:
/* eslint-disable @typescript-eslint/no-explicit-any */
import { genkit, z } from 'genkit';
import { startFlowServer } from '@genkit-ai/express';
import { openAIO3Mini, github } from 'genkitx-github';
import {OpenWeatherAPI } from 'openweather-api-node';
import dotenv from 'dotenv';
dotenv.config();
const ai = genkit({
plugins: [
github({ githubToken: process.env.GITHUB_TOKEN }),
],
model: openAIO3Mini,
});
const weatherToolInputSchema = z.object({
location: z.string().describe('The location to get the current weather for')
});
const getWeather = ai.defineTool(
{
name: 'getWeather',
description: 'Gets the current weather in a given location',
inputSchema: weatherToolInputSchema,
outputSchema: z.string(),
},
async (input) => {
const weather = new OpenWeatherAPI({
key: process.env.OPENWEATHER_API_KEY,
units: "metric"
})
const data = await weather.getCurrent({locationName: input.location});
return `The current weather in ${input.location} is: ${data.weather.temp.cur} Degrees in Celsius`;
}
);
const helloFlow = ai.defineFlow(
{
name: 'helloFlow',
inputSchema: z.object({ location: z.string() }),
outputSchema: z.string(),
},
async (input) => {
const response = await ai.generate({
tools: [getWeather],
prompt: `What's the weather in ${input.location}?`
});
return response.text;
}
);
startFlowServer({
flows: [helloFlow]
});
Setup and Development
1. Install dependencies:
npm install
2. Configure environment variables:
GITHUB_TOKEN=your_token
OPENWEATHER_API_KEY=your_key
3. Start the development server:
npm run genkit:start
4. To run the project in debug mode and set breakpoints, you can run:
npm run genkit:start:debug
Then, launch the debugger in your IDE. See the .vscode/launch.json file for the configuration.
5. If you want to build the project, you can run:
npm run build
6. Run the project in production mode:
npm run start:production
Dependencies
Core Dependencies
genkit: ^1.0.5@genkit-ai/express: ^1.0.5openweather-api-node: ^3.1.5genkitx-github: ^1.13.1dotenv: ^16.4.7
Development Dependencies
tsx: ^4.19.2typescript: ^5.7.2
Project Configuration
- Uses ES Modules (
"type": "module") - TypeScript with
NodeNextmodule resolution - Output directory: lib
- Full TypeScript support with type definitions
License
Apache 2.0
Resources
Conclusion
This project demonstrates how to build a weather service using Genkit in Node.js with AI integration. The application showcases modern Node.js patterns and AI integration techniques.
You can find the full code of this example in the GitHub repository.
Happy coding!
Source:
https://dzone.com/articles/building-weather-service-genkit-ai