AI Concierge SDK

The AI concierge
for hotels

Real-time local recommendations, events, and weather — powered by your guest data. One SDK, any platform.

Get in Touch

Integration

concierge.py 
from nirmi_events_sdk import Client, HotelConfig, GuestContext

client = Client(
    api_key="nk_hyatt_prod_abc123",
    hotel_config=HotelConfig(
        hotel_name="Grand Hyatt Barcelona",
        brand="hyatt"
    )
)

# Ask the concierge anything
response = client.chat(
    message="Where should I eat tonight?",
    latitude=41.3851,
    longitude=2.1734,
    city="Barcelona",
    guest=GuestContext(first_name="Marco", trip_type="couple"),
    metadata={"interests": ["romantic", "wine"]}
)

What you get back

guest asks
"Where should I eat tonight?"

context
guest: Marco, couple trip
location: Barcelona
weather: 22°C, clear
time: evening
nirmi responds
{
  "success": true,
  "response": "Welcome, Marco! For a
    romantic evening, try...",
  "events": [
    {
      "name": "Can Culleretes",
      "type": "restaurant",
      "rating": 4.6,
      "price_tier": "€€"
    }
  ],
  "weather": {
    "condition": "clear",
    "temperature": 22
  }
}
01

Live local data

Powered by Gemini Maps Grounding — 250M+ real places with ratings, reviews, and hours. Plus Ticketmaster, Eventbrite, and OpenWeather.

02

Guest-aware

Pass guest profile, trip type, dietary needs, and your own platform metadata. The AI tailors every response.

03

Hotel-first

Configure your venues, brand, and competitor rules. The concierge promotes your F&B and spa before external options.

Works with your stack

Python SDK on PyPI. REST API for everything else. Plug into your PMS, guest app, or in-room tablet in minutes.

pip install nirmi-events-sdk