The climate API for your product

Run climate simulations from your own code. Wind, heat, sun and daylight for one site or a whole city.

Docs Playground Get your API key
The API playground: wind speed inputs next to a 3D wind result on a demo site
Wind speed on a demo site, from the API playground.
Thousandsof simulations per second
44 s400 km² of Berlin, end to end400 km²: perceived heat (UTCI), one summer day at 1 m, four 100 km² runs at once, 23 Oct 2026.
12 modelsWind, heat, sun, daylight, energy
3.20M+simulations computed, as of 29 Oct 2026Simulations computed include our own studies and stress tests.

Start building

Native SDKs for Python and TypeScript. 900 free tokens, no credit card.

Python
pip install infrared-sdk
TypeScript
npm install @infrared-city/infrared-sdk

Full guide and reference in the docs

# pip install infrared-sdk   (set INFRARED_API_KEY)
# Buildings outside our served cities: pip install "infrared-sdk[geodata]"
from infrared_sdk import InfraredClient, SvfModelRequest
from infrared_sdk.analyses.types import AnalysesName

area = {"type": "Polygon", "coordinates": [[          # a block in Vienna
    [16.369, 48.207], [16.373, 48.207], [16.373, 48.209],
    [16.369, 48.209], [16.369, 48.207]]]}

with InfraredClient() as client:
    buildings = client.buildings.get_area(area)
    result = client.run_area_and_wait(
        SvfModelRequest(analysis_type=AnalysesName.sky_view_factors),
        area, buildings=buildings)
grid = result.physical_grid()   # sky view factor, 0 to 100 %
// npm install @infrared-city/infrared-sdk   (set INFRARED_API_KEY)
import { InfraredClient, initializeCore, areaGridValuesF32, type AreaResult } from "@infrared-city/infrared-sdk";

await initializeCore();
const area = { type: "Polygon", coordinates: [[   // a block in Vienna
  [16.369, 48.207], [16.373, 48.207], [16.373, 48.209],
  [16.369, 48.209], [16.369, 48.207]]] };

const client = new InfraredClient({ apiKey: process.env.INFRARED_API_KEY });
const buildings = await client.buildings.getBuildingsInArea(area);
const result = await client.runAreaAndWait(
  { analysisType: "sky-view-factors" }, area, { buildings });
const grid = areaGridValuesF32(result as AreaResult);   // 0 to 100 %
The SDK

Very large areas, one function call

The SDK cuts your area into 512 m tiles, runs each tile as its own job and merges the results into one seamless result.

  • Any size. A block, a district or a whole city.
  • In parallel. 100 km² takes 37 s, not 100 times as long as 1 km².
  • Reliable. A failed tile is sent again. No holes, no double bill.

Standard outputs

  • JSON grids
  • PNG maps
  • Facade values
  • OBJ and dotbim
  • GeoTIFF
  • 3D Tiles

For enterprise and platforms

Built for teams that run it inside their product.

One of the largest AEC software platforms runs our engine, since 2026. More than 2,500 accounts use it.

The live climate layer over Hong Kong
Example: Hong Kong. Buildings, trees and terrain © Lands Department, HKSAR.
  • Reliable at scaleFailed jobs rerun automatically.
  • EU hosting and GDPRFrankfurt, data deleted after 24 h.
  • Your termsDPA, OEM licence, SLA.
  • On-prem possibleCapacity raised with you.

How does this compare with ENVI-met, SOLWEIG or PALM-4U? See when to use which tool.

The agent skill

Let your AI agent write the code

The skill teaches your coding agent the SDK and its recipes: web apps, 3D facade viewers, Grasshopper, notebooks and secure backends. Your agent runs real simulations with your key and does not invent numbers.

In Claude Code or Cursor

/plugin marketplace add Infrared-city/infrared-skills
/plugin install infrared@infrared-skills

Codex, Copilot, Windsurf: read AGENTS.md .

Plugin marketplace on GitHub

You ask

Build me a small web app: I draw an area, press Run, and see thermal comfort on a map.

Build an app in less than an hour

Pick a recipe. Each one is a working example in our public repository; your agent reads it and adapts it to your site, your data and your stack.

Built with infrared.city

Our own apps first, then our demos, then what teams built in five days at the infrared.city Buildathon in May 2026. Point at or tap a card for more.

  • The infrared.city platform: screenshot Our app The infrared.city platform by infrared.city
  • Hong Kong climate twin: screenshot Our app Hong Kong climate twin by infrared.city
  • Design & compare: screenshot Our demo Design & compare by infrared.city
  • Construction heat planning: screenshot Our demo Construction heat planning by infrared.city
  • Streets & public spaces: screenshot Our demo Streets & public spaces by infrared.city
  • Marathon & event routes: screenshot Our demo Marathon & event routes by infrared.city
  • Portfolio performance: screenshot Our demo Portfolio performance by infrared.city
  • Treeat: screenshot Buildathon 2026 Treeat by Mari
  • CoolSpend: screenshot Buildathon 2026 CoolSpend by Rafik El Khoury
  • Renovation Map Toolkit: screenshot Buildathon 2026 Renovation Map Toolkit by Medinaura
  • Detour: screenshot Buildathon 2026 Detour by xBuild
  • HeatGuard: screenshot Buildathon 2026 HeatGuard by HeatGuard
  • WindSite: screenshot Buildathon 2026 WindSite by Team Turbine
  • Cairo PEDCOMF: screenshot Buildathon 2026 Cairo PEDCOMF by Antony Hozeen
  • simSPACE and Tree SimCity: screenshot Buildathon 2026 simSPACE and Tree SimCity by CCAE / Cork Centre for Architectural Education
  • CoolTure: screenshot Buildathon 2026 CoolTure by CoolTure
  • CIRCE: screenshot Buildathon 2026 CIRCE by Team NS
  • CoolRun AI: screenshot Buildathon 2026 CoolRun AI by Yusuf
  • UrbanShade: screenshot Buildathon 2026 UrbanShade by Rashi Desadla