citypulse 0.1.0

Real-time city energy scores for Indian cities

citypulse

Real-time city energy scores for Indian cities.

Install

pip install citypulse

Usage

from citypulse import CityPulse

cp = CityPulse()

# Get pulse score for any city
print(cp.get_pulse("Mumbai"))
# → {"city": "Mumbai", "pulse_score": 83.9, "temperature": 30.4, ...}

# Live leaderboard
cities = cp.get_dashboard()
for c in cities:
    print(f"{c['city']}: {c['pulse_score']}/100")

# Similar cities
similar = cp.get_similar("Bengaluru")
# → [{"city": "Mumbai", "similarity_score": 0.87, ...}]

# Neighbourhood breakdown
areas = cp.get_neighbourhood("Lucknow")
# → [{"neighbourhood": "Hazratganj", "pulse_score": 51.1, ...}]

API

Method	Description
get_pulse(city)	Latest pulse score for any city
get_dashboard()	All tracked cities with scores
get_trend(city, days=7)	Hourly pulse trend
get_forecast(city)	24h Prophet forecast
get_similar(city)	Cities with similar vibe
get_neighbourhood(city)	Area-level scores
compare(days=7)	City ranking