# Weather

Looks up the current weather for a location via the Open-Meteo API.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).



<DocsBaseSwitcher base="eve" agent="weather" />

<AgentPreview
  agent="weather"
  framework="eve"
  inputFields="[
  {
    name: &#x22;location&#x22;,
    label: &#x22;Location&#x22;,
    placeholder: &#x22;Pune&#x22;,
    type: &#x22;text&#x22;,
  },
]"
/>

## Summary [#summary]

The **Weather Agent** is the classic starter: ask about a place and it reports the
current conditions. It geocodes the location and fetches live weather from the
free Open-Meteo API — no key required. Reach for it as a minimal, end-to-end
example of an agent with a single tool.

## Install [#install]

```bash
npx shadcn@latest add https://agentcn.vercel.app/r/eve/weather.json
```

## Composition [#composition]

```text
agent/
├── agent.ts             # Agent definition (model + config)
├── instructions.md      # Weather assistant instructions
└── tools/
    └── get_weather.ts   # Geocode + current forecast (Open-Meteo)
```

## Customization [#customization]

* **Add a forecast.** Extend `get_weather` to request daily/hourly data.
* **Add units.** Pass a `units` parameter (metric/imperial) to the API.
* **Add more tools.** This is a good base to graduate into a travel or planning
  agent.
* **Swap the model.** Edit `agent/agent.ts`.