home-server

A smart home assistant server with the following features:

• IoT device management
  • Switch device on/off
  • Monitor device status
  • Monitor/get/set temperatures
  • Automatic temperature management
• Home assistant Telegram bot
• Food stock tracking using OpenAI API
• ?

Setup

• Use Node.js 24 (.nvmrc) and npm.
• Install dependencies with npm ci.
• Copy env.sample to .env and set MQTT_SERVER, REDIS_URL, TELEGRAM_BOT_TOKEN, and TELEGRAM_NOTIFICATIONS_TARGET.
• Run a local Redis server if needed:

docker run --restart=always --name redis -d -p 6379:6379 redis redis-server --save 60 1 --loglevel warning

Development

• npm run dev starts src/index.ts with tsx watch and pino-pretty logs.
• npm start runs the same entrypoint without pretty logging.
• npm run build compiles TypeScript and rewrites TS path aliases in build/.
• npm run typecheck, npm run lint, and npm test run focused checks.

Bot commands

• help
• temperature
• system
• abort

Note: /food is still registered in the bot entrypoint, but there is no food handler in src/lib/telegram/handlers/index.ts yet.

Bot notifications

The bot sends different notifications based on the reported values/events from connected devices.

Examples:

• Abnormal voltage changes
• Water pump flow
• High temperature/humidity