Skip to main content

Welcome to SkyCast IA Documentation

Build intelligent weather applications with AI-powered forecasts, real-time data, and personalized climate recommendations

Get StartedExplore API Reference

Get Started in Minutes

Follow these steps to integrate SkyCast IA into your application

1

Install Dependencies

Install the required packages for your Next.js application:
npm
npm install next react react-dom leaflet react-leaflet recharts
yarn
yarn add next react react-dom leaflet react-leaflet recharts
2

Configure API Keys

Create a .env.local file in your project root and add your API credentials:
NEXT_PUBLIC_OPENWEATHER_API_KEY=your_openweather_key
GROQ_API_KEY=your_groq_key
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=your_recaptcha_site_key
RECAPTCHA_SECRET_KEY=your_recaptcha_secret
Get your OpenWeatherMap API key from openweathermap.org/api and Groq API key from console.groq.com
3

Fetch Weather Data

Use the weather API functions to get real-time data:
import { getCurrentWeather, getWeatherForecast } from '@/lib/api/weather';

// Get current weather by coordinates
const weather = await getCurrentWeather(40.7128, -74.0060);

// Get hourly forecast
const forecast = await getWeatherForecast(40.7128, -74.0060);
4

Add AI-Powered Analysis

Integrate intelligent weather recommendations:
import { getAiWeatherAnalysis } from '@/lib/api/mistral';

// Get AI analysis based on weather data
const analysis = await getAiWeatherAnalysis(weather);
// Returns: "Perfect day for outdoor activities! 🌞"

Explore Core Features

Discover what makes SkyCast IA powerful

Real-Time Weather Display

Dynamic weather cards with live temperature, humidity, wind speed, and atmospheric pressure

AI Chat Assistant

Intelligent chat interface powered by Groq/Llama for personalized weather advice

Smart Geolocation

Automatic location detection with fallback to manual city search

Interactive Weather Map

Leaflet-powered maps with real-time weather overlays and city markers

Hourly Forecasts

Visual forecast charts with 8-hour predictions and precipitation probability

Dynamic Themes

UI themes that adapt based on weather conditions (snow, rain, clear, hot)

API Reference

Complete documentation for all APIs and hooks

Weather API

Functions for fetching current weather and forecasts

Chat API

AI-powered chat endpoint for weather conversations

News API

Fetch weather-related news by location

useLocation Hook

React hook for geolocation management

Ready to Build?

Start building intelligent weather applications with SkyCast IA’s powerful APIs and AI capabilities

View Quickstart Guide

Build docs developers (and LLMs) love

Get started for freeTalk to us