---
title: "Build a Stargazing Forecast for the Hours You’re Free"
titleOverride: "Build a Stargazing Forecast with Open-Meteo"
pubDate: 2026-11-18
description: "Build a stargazing forecast with Open-Meteo and Quickchat AI. Compare hourly cloud cover, wind and humidity for two evenings and pick a time for your telescope."
author:
  name: Piotr Grudzień
  image: /blog-assets/authors/piotr_grudzien.jpg
image:
  url: /blog-assets/posts/stargazing-weather-window-assistant_bg.webp
  alt: "A backyard telescope beside the Warsaw forecast for Friday at 21:00, with 2% cloud cover."
tags: [tutorials, engineering]
articleCta:
  title: "Compare your next two evenings"
  subtitle: "Give the assistant your town, the hours you can get outside and the weather limits that matter to you."
  button: "Build a stargazing assistant"
  href: https://app.quickchat.ai/register
faq:
  - question: "What cloud cover is good for stargazing?"
    answer: "For this backyard session we asked for total cloud below 30%. Lower total cloud leaves more sky potentially open, but a percentage cannot tell you whether a cloud will cover the object you want to see. Choose a limit that suits your session and check the sky again before setting up."
  - question: "Does clear sky mean good astronomical seeing?"
    answer: "Seeing describes how much atmospheric turbulence blurs or distorts an image. An hourly cloud forecast can help you find a gap in the clouds. Measuring seeing or predicting the sharpness of a planetary view takes different information."
  - question: "How long after sunset is it dark enough to observe?"
    answer: "The interval changes with latitude and date. Evening astronomical twilight ends when the Sun’s center reaches 18 degrees below the horizon, where that occurs. This recipe retrieves sunset and sunrise. Use a twilight calculator for the end of astronomical twilight at your site."
  - question: "Can this forecast tell me whether the Moon or Saturn will be visible?"
    answer: "For a particular object you need its altitude and direction for your location and time. For a faint target, moonlight, light pollution and obstructions also matter. Use a sky chart or ephemeris alongside the weather comparison."
  - question: "Do I need an Open-Meteo API key?"
    answer: "Open-Meteo offers keyless hosted access for eligible non-commercial use. Commercial use of its hosted service requires the appropriate subscription, customer endpoints and API key. You can also operate your own instance with the open data."
  - question: "Which timezone does the stargazing forecast use?"
    answer: "The forecast request sets timezone to auto for the selected coordinates. Clear Slot uses the timezone returned with the hourly data. Enter the hours you can observe in that location’s local time."
  - question: "Will the assistant alert me when the clouds clear?"
    answer: "Clear Slot checks when you ask. To get a fresh comparison, send another message before you take the telescope outside. Automatic notifications would require a scheduler and a delivery channel."
---

Friday at 21:00 was the hour to get the telescope out. In the **stargazing forecast** for Warsaw, Thursday stayed at 100% cloud through both of our free hours. On Friday the forecast went from 57% cloud at 20:00 to **2% at 21:00**, with wind at **9.3 km/h**. If you had checked only at dinner, you might have left the telescope in its case.

You’ll build **Clear Slot**, a Quickchat AI assistant that asks where and when you can observe, looks up the hourly forecast in Open-Meteo and shows its work. Here’s its answer for two evenings in November 2026. Your own result will change with the forecast.

<div class="tutorial-screen tutorial-panel">

![Clear Slot’s answer for Friday at 21:00 beside the Warsaw forecast readings that support it.](../../assets/blog/posts/clearSlot/answer.webp)
*The conversation ran in Quickchat AI with a saved forecast. The selected hour met both of the observer’s limits. [Weather data by Open-Meteo][meteo].*

</div>

[Download the Clear Slot starter kit](https://quickchat.ai/blog-assets/downloads/clear-slot-stargazing-kit.zip) to follow the example with the same forecast and place results. You can also [skip to the four hourly readings](#compare-hours). Screenshots use the English interface.

<a id="set-up"></a>
## 1. What should a stargazing forecast compare?

Give the assistant a town, two dates and a start and end time. We picked **Warsaw, Poland, from 20:00 to 22:00 on 19 and 20 November**. Our preferences were total cloud **below 30%** and sustained wind **below 15 km/h**. These are choices you can change for your own observing session.

1. [Create a Quickchat AI account](https://app.quickchat.ai/register) or sign in. Use your empty Agent or select **Add new AI Agent → Set up manually**. Name it **Clear Slot**. You’ll need credits to run AI replies and tests.
2. Open **Identity → Main Prompt** and paste the Main Prompt from the kit. It asks the assistant to confirm the place, compare only your free hours, keep the forecast’s timezone and show the measurements behind its choice.
3. Use **AI Preview** for the conversation. Two **API Actions** supply the place and the weather. You can build both with the fields below. Each sends a GET request with the `Accept` header set to `application/json` and an empty body.

<div class="tutorial-screen tutorial-panel">

![Clear Slot’s Main Prompt in Quickchat AI and the two Actions used to answer a forecast question.](../../assets/blog/posts/clearSlot/identity.webp)
*Identity sets the observing rules. The two named Actions give the assistant a town lookup and a forecast it can read.*

</div>

The public URLs below are for eligible personal, non-commercial use. For commercial hosted use, have your server add the `apikey` to requests to your plan’s customer endpoints. Keep the key out of the Agent prompt and visible request details. For the published example we ran the open-source services against their open data. [Open-Meteo usage terms](https://open-meteo.com/en/terms) · [Hosted plans](https://open-meteo.com/en/pricing) · [Self-hosting guide](https://github.com/open-meteo/open-meteo/blob/main/docs/getting-started.md)

<a id="find-place"></a>
## 2. Which Warsaw did the forecast look up?

A forecast needs coordinates. A search for `Warsaw` returns matches in Poland and several US states. Ask the reader for a town and country, then pass only the chosen result’s coordinates to the weather lookup.

1. Open **Actions & MCPs → Add Action → API Action → Create manually**. Name the Action `Resolve observing location`. Set **When to run** to **AI decides**.
2. Under **What to ask the user first**, add a required **Text** parameter named `place`. Its value is the town name alone. The region or country helps the assistant select a result after the search.
3. Set the method to **GET** and the URL to `https://geocoding-api.open-meteo.com/v1/search`. Under **Query Params**, add `name` and insert the `place` parameter with **Add AI Data**. Set `count` to `5`, `language` to `en` and `format` to `json`.
4. Paste the kit’s location Action description, save and enable the Action. Try **“Which Warsaw is in Poland and which is in Indiana?”** in AI Preview. Look for the country, region and timezone in the result. [Open-Meteo geocoding reference](https://open-meteo.com/en/docs/geocoding-api)

<div class="tutorial-screen tutorial-panel">

![Warsaw in Mazovia and Warsaw in Indiana with their different coordinates and timezones.](../../assets/blog/posts/clearSlot/places.webp)
*The Polish city returned 52.22977, 21.01178 and Europe/Warsaw. Indiana returned a negative longitude and an American timezone. Place data from [GeoNames](https://www.geonames.org/) via [Open-Meteo][meteo].*

</div>

<a id="read-forecast"></a>
## 3. How do you get hourly clouds, humidity and wind?

Create a second API Action called `Read observing weather`. Give it two required **Decimal Number** parameters, `latitude` and `longitude`, from the selected place. Use **GET** at `https://api.open-meteo.com/v1/forecast` and leave **When to run** on **AI decides**.

| Query parameter | What to enter |
| --- | --- |
| `latitude`, `longitude` | Two separate rows. Insert the matching parameter in each with **Add AI Data**. |
| `forecast_days` | `3` |
| `timezone` | `auto` |
| `wind_speed_unit` | `kmh` |
| `daily` | `sunset,sunrise` |
| `hourly` | Paste the comma-separated value below as one field. |

```text
cloud_cover,cloud_cover_low,cloud_cover_mid,cloud_cover_high,relative_humidity_2m,wind_speed_10m,wind_gusts_10m
```

<div class="tutorial-screen tutorial-panel">

![The forecast Action in Quickchat AI with coordinate parameters and fixed forecast settings.](../../assets/blog/posts/clearSlot/action.webp)
*The town changes between requests. The three-day horizon, local timezone and units stay fixed in the Action.*

</div>

Paste the kit’s forecast Action description, save and switch it on. Reopen it with **Edit Action**, select **Test Response**, enter the two Warsaw coordinates and run a test. Find `timezone`, `hourly_units`, `hourly.time` and `hourly.cloud_cover` in the response. A timestamp and its cloud value occupy the same position in their respective lists. Keep that index for all the hourly fields. [Forecast API reference](https://open-meteo.com/en/docs)

If you use the Quickchat AI account connection in [ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6a4656c688748191be4c5247fb0d5dfc) or [Claude](https://claude.ai/directory/connectors/app-quickchat-ai), you can give it the kit and ask it to create the two Actions on Clear Slot using those exact settings. Review the saved URLs, parameters and units before running a test. The [API Action builder guide](https://quickchat.ai/post/connect-ai-agent-to-any-api) shows the editor in more detail.

<a id="compare-hours"></a>
## 4. Which of the two evenings has the clearest hour?

In **AI Preview**, send the question below with dates inside your current three-day forecast. For the November example we replayed the saved forecast through the same two Actions. Open the conversation in **Inbox** and inspect the called Action to compare the answer with its source.

> Compare Thursday and Friday in Warsaw, Poland. I’m free from 20:00 to 22:00 both nights. I want total cloud below 30% and wind below 15 km/h. When should I take the telescope out?

| Local start | Total cloud | Wind | Humidity |
| --- | ---: | ---: | ---: |
| Thu 19, 20:00 | 100% | 8.6 km/h | 93% |
| Thu 19, 21:00 | 100% | 9.4 km/h | 92% |
| Fri 20, 20:00 | 57% | 10.7 km/h | 82% |
| **Fri 20, 21:00** | **2%** | **9.3 km/h** | **84%** |

Warsaw local time (`Europe/Warsaw`, UTC+1). This [Open-Meteo forecast][meteo] was retrieved on **18 November 2026 at 13:10 UTC**. The four rows use the hourly readings at the start of each available block. A 22:00 start falls outside a session that ends at 22:00.

<div class="tutorial-screen tutorial-panel">

![Cloud-cover readings for Thursday and Friday across the two evenings, with the original closing time marked.](../../assets/blog/posts/clearSlot/hours.webp)
*Friday drops below the observer’s 30% cloud limit at 21:00. The 22:00 reading can change the answer only if you can stay later. [Weather data by Open-Meteo][meteo].*

</div>

**Thursday at 20:00 had zero low cloud and 100% total cloud.** The high layer alone covered the sky, and the middle layer was 62%. On Friday at 21:00, the forecast gave 2% low cloud and zero in the middle and high layers. Layers can overlap. Use the provider’s total when applying a total-cloud limit.

<div class="tutorial-screen tutorial-panel">

![Low, middle and high cloud cover at 20:00 Thursday and 21:00 Friday in Warsaw.](../../assets/blog/posts/clearSlot/layers.webp)
*Looking only at low cloud would make Thursday look clearer than Friday. The high cloud explains why that reading is misleading. [Weather data by Open-Meteo][meteo].*

</div>

Check the tripod conditions separately. At **21:00 on Friday**, wind was **9.3 km/h**. For the maximum gust over **21:00 to 22:00**, read the gust at the **ending timestamp**, 22:00, which was **16.2 km/h**. Open-Meteo’s gust field describes the preceding hour. Relative humidity reached 84% at 21:00. That reading alone cannot tell you if dew will form on the lens. [Wind and gust definitions](https://open-meteo.com/en/docs/dwd-api#hourly_parameter_definition)

In our first test, Clear Slot picked the 21:00 gust of 19.4 km/h when we asked for the maximum between 21:00 and 22:00. We added the ending-timestamp rule to the Main Prompt and repeated the same question. This time it returned 16.2 km/h and named the 22:00 sample. The kit includes that correction.

<div class="tutorial-screen tutorial-panel">

![A timeline connecting the 21:00 wind sample to the gust reported at 22:00 for the preceding hour.](../../assets/blog/posts/clearSlot/gust.webp)
*One hour on the tripod draws on two timestamps in the forecast. [Weather data by Open-Meteo][meteo].*

</div>

<a id="stay-later"></a>
## 5. What changes if you can stay out one hour later?

In the same conversation, say **“I can stay until 23:00 on Friday. What changes?”** One new start time enters the comparison. At **22:00** Friday’s forecast had **0% cloud, 7.5 km/h wind and 86% humidity**. You gain a second promising hour, with slightly higher relative humidity.

<div class="tutorial-screen tutorial-panel">

![Clear Slot’s follow-up after the observer extends Friday’s session to 23:00.](../../assets/blog/posts/clearSlot/extra-hour.webp)
*The added hour starts at 22:00. Its zero cloud value is an explicit reading in the forecast. [Weather data by Open-Meteo][meteo].*

</div>

Try one last change. Keep the extended hours and set a wind limit **below 8 km/h**. Only Friday at 22:00 passes both limits. Tighten it to **below 7 km/h** and all five samples fall outside your preferences. The useful answer now is that no hour qualifies, with 7.5 km/h as the closest wind reading.

<div class="tutorial-screen tutorial-panel">

![A tighter wind limit removes the last qualifying hour from the extended Friday window.](../../assets/blog/posts/clearSlot/limit.webp)
*Change just one limit and ask for the measured wind at the closest hour. A blank forecast value must stay unknown. [Weather data by Open-Meteo][meteo].*

</div>

Sunset in the sample was 15:38 Thursday and 15:37 Friday. For a faint galaxy, you’ll also want the end of astronomical twilight, the Moon’s position and a clear view in the right direction. Before packing, run the forecast again for your own place and hours. If a date is beyond the three-day response or a request fails, ask again when fresh readings are available. [US Naval Observatory definitions of sunset and twilight](https://aa.usno.navy.mil/faq/RST_defs)

The figures select and plot values from Open-Meteo’s forecast, distributed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). The opening sky illustration depicts a backyard setup. The numbers beside it come from the saved forecast.

[meteo]: https://open-meteo.com/

## Frequently asked questions

### What cloud cover is good for stargazing?

For this backyard session we asked for total cloud below 30%. Lower total cloud leaves more sky potentially open, but a percentage cannot tell you whether a cloud will cover the object you want to see. Choose a limit that suits your session and check the sky again before setting up.

### Does clear sky mean good astronomical seeing?

Seeing describes how much atmospheric turbulence blurs or distorts an image. An hourly cloud forecast can help you find a gap in the clouds. Measuring seeing or predicting the sharpness of a planetary view takes different information.

### How long after sunset is it dark enough to observe?

The interval changes with latitude and date. Evening astronomical twilight ends when the Sun’s center reaches 18 degrees below the horizon, where that occurs. This recipe retrieves sunset and sunrise. Use a twilight calculator for the end of astronomical twilight at your site.

### Can this forecast tell me whether the Moon or Saturn will be visible?

For a particular object you need its altitude and direction for your location and time. For a faint target, moonlight, light pollution and obstructions also matter. Use a sky chart or ephemeris alongside the weather comparison.

### Do I need an Open-Meteo API key?

Open-Meteo offers keyless hosted access for eligible non-commercial use. Commercial use of its hosted service requires the appropriate subscription, customer endpoints and API key. You can also operate your own instance with the open data.

### Which timezone does the stargazing forecast use?

The forecast request sets timezone to auto for the selected coordinates. Clear Slot uses the timezone returned with the hourly data. Enter the hours you can observe in that location’s local time.

### Will the assistant alert me when the clouds clear?

Clear Slot checks when you ask. To get a fresh comparison, send another message before you take the telescope outside. Automatic notifications would require a scheduler and a delivery channel.

---

Not answered on this page? Ask Quickchat AI directly: https://app.quickchat.ai/v1/api_core/public-question/quickchat/ask/?q=your+question&placement=www-markdown-footer-ask-v1&format=html
