Control panel for Panasonic MirAIe air conditioners, ported from the Home Assistant integration.
- 🔐 Authentication with MirAIe cloud (email/mobile + password)
- 📡 Device discovery via REST API
- 🌡️ Real-time device control via MQTT
- 🎛️ Full AC control: power, mode, temperature, fan speed, swing, and special modes
- 💻 Responsive web UI with React + Tailwind CSS
miraie/
├── api/ # Elysia.js REST API
│ └── src/
│ ├── index.ts # API server with endpoints
│ ├── constants.ts # API URLs, MQTT config
│ ├── types.ts # TypeScript definitions
│ └── services/
│ ├── auth.ts # Authentication service
│ ├── devices.ts # Device management
│ └── mqtt.ts # MQTT handler
└── web/ # React + Vite + Tailwind UI
└── src/
└── App.tsx # Main UI component
- Bun runtime (v1.0+)
- MirAIe account (same credentials as the mobile app)
# Install all dependencies
bun install
cd api && bun install
cd ../web && bun install
cd ..
# Run both API and Web UI
bun run devThis starts:
- API Server: http://localhost:3000
- Web UI: http://localhost:5173
# API only
bun run dev:api
# Web UI only (with API proxy)
bun run dev:web| Method | Endpoint | Description |
|---|---|---|
| POST | /auth/login |
Login with email/mobile + password |
| POST | /auth/logout |
Logout |
| GET | /auth/status |
Check auth status |
| Method | Endpoint | Description |
|---|---|---|
| POST | /devices/discover |
Discover AC devices |
| GET | /devices |
List all devices |
| GET | /devices/:id/status |
Get device status |
| POST | /devices/:id/control |
Send control command |
| Method | Endpoint | Description |
|---|---|---|
| POST | /mqtt/connect |
Connect to MQTT broker |
| POST | /mqtt/disconnect |
Disconnect from MQTT |
| GET | /mqtt/status |
MQTT connection status |
| Property | Values |
|---|---|
power |
"on", "off" |
mode |
"auto", "cool", "heat", "dry", "fan" |
temperature |
16 - 30 (°C) |
fanSpeed |
"auto", "low", "medium", "high", "quiet" |
verticalSwing |
"off", "vertical", "horizontal", "both" |
nanoe |
true, false |
powerful |
true, false |
economy |
true, false |
- Login with your MirAIe credentials
- Discover devices to find your AC units
- Connect MQTT to enable real-time control
- Control devices via the web UI or API
Ported from hass-panasonic-miraie by chrissmartin.
MIT