Skip to content

PatrickNoFilter/Anggira-IOT-Home-System

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
.zhanlu
.zhanlu
 
 
firmware
firmware
 
 
server/stb
server/stb
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 

Repository files navigation

🏠 Anggira — IOT Home System with Xiaozhi AI Music, News & Calendar

🌐 English · 🇮🇩 Bahasa Indonesia

License: MIT ESP32 Python

🇮🇩 Versi Bahasa Indonesia

Sistem smart home berbasis ESP32 yang dikendalikan oleh asisten AI Anggira via suara (Xiaozhi), Telegram, dan web dashboard.

🗂️ Repository Structure

anggira-iot/
├── firmware/
│   ├── esp32-s3-xiaozhi/        # ESP32-S3 — Xiaozhi AI Voice Assistant (modified)
│   └── esp32-c3-sensor/         # ESP32-C3 Mini — Home Sensor + Lamp Servo Control
└── server/
    └── stb/                     # Server on Android STB (Termux)
        ├── anggira.py           # Core: MCP server + Telegram bot + all tools
        ├── bot.py               # Telegram bot for wake/control ESP32 Xiaozhi
        ├── stream_server.py     # Music streaming server (YouTube → MP3)
        ├── dashboard.py         # Web dashboard log monitor (port 8088)
        ├── google_auth.py       # OAuth2 Google Calendar setup (run once)
        └── launcher.sh          # Auto-launcher for all services with auto-restart

🔧 Hardware Components

Device Chip Function
ESP32-S3 ESP32-S3 Xiaozhi AI voice assistant (wake word, TTS, music)
ESP32-C3 Mini ESP32-C3 Home temperature/humidity/pressure sensor + lamp servo control
Android STB — Main server (Termux): AI, Telegram bot, music streaming

✨ Key Features

  • 🎵 Music Streaming — request songs via voice/Telegram, stream from YouTube to ESP32 or STB speakers
  • 📰 News — latest Indonesian news headlines
  • 🌤️ Weather — real-time weather for Salatiga city (OpenWeatherMap)
  • 📅 Google Calendar — view & add schedule via voice
  • 💡 Lamp Control — ON/OFF + automatic schedule via servo motor
  • 🌡️ Home Sensors — temperature, humidity, air pressure (AHT20 + BMP280)
  • 📱 Telegram Bot — control all features from phone
  • 🖥️ Web Dashboard — monitor logs from all services
  • 💬 Hourly Quotes — motivational Indonesian quotes every hour +1 minute
  • 🕐 Hourly Chime — automatic hourly announcement with custom text
  • 🎵 Playlist Management — manage music playlists via dashboard

🚀 Quick Start

1. STB Server (Termux)

# Install dependencies
pip install python-telegram-bot websockets flask yt-dlp requests

# Set environment variables in ~/.bashrc
export TELEGRAM_BOT_TOKEN="your_xiaozhi_bot_token"
export TELEGRAM_STB_TOKEN="your_anggira_bot_token"
export OPENROUTER_API_KEY="your_key"
export OPENWEATHER_API_KEY="your_key"
export GOOGLE_CLIENT_ID="client_id"
export GOOGLE_CLIENT_SECRET="client_secret"
export ESP32_SENSOR_IP="192.168.1.222"
export TELEGRAM_ALLOWED_USER_ID="your_user_id"
export MCP_ENDPOINT="ws://localhost:port/mcp"

source ~/.bashrc

# (First time) Setup Google Calendar
python ~/anggira/google_auth.py

# Run all services
bash ~/anggira/launcher.sh

2. ESP32-C3 Sensor Firmware

See firmware/esp32-c3-sensor/README.md

3. ESP32-S3 Xiaozhi Firmware

See firmware/esp32-s3-xiaozhi/README.md

🌐 STB Server Endpoints

Service Port URL
Music Server 8080 http://STB_IP:8080
Web Dashboard 8088 http://STB_IP:8088

🖥️ Web Dashboard Features

Web dashboard available at http://STB_IP:8088 with features:

📋 Logs

  • Monitor live logs from all services (anggira.py, stream_server.py, bot.py)
  • Auto-refresh every 2 seconds
  • Clear logs per service

🕐 Chime

  • Enable/disable hourly chime
  • Set command text spoken every hour
  • Select active hours (06:00-21:00 default)

💬 Quotes

  • Manage Indonesian motivational quotes list
  • Add/delete custom quotes
  • Set active hours for quotes
  • Reset to default list (25 quotes)
  • Quotes appear every hour +1 minute

🔑 Tokens

  • Manage API keys and tokens (Telegram, OpenRouter, OpenWeather, Google)
  • Save directly to ~/.bashrc

🎵 Playlist

  • Manage music playlists
  • Add/edit/delete playlists
  • Test play directly from dashboard

📡 ESP32 Control

  • Send direct commands to Xiaozhi
  • Quick actions (Test Chime, Lamp ON/OFF, Sensor, Weather)
  • Check ESP32 real-time status

📡 ESP32-C3 Endpoints

Endpoint Function
/ ESP32 web dashboard
/data JSON sensor data
/sensor_rumah Sensor data for Anggira
/on /off Lamp control
/jadwal View lamp schedule
/set?on=HH:MM&off=HH:MM Set lamp schedule

🔗 References

📄 License

MIT License — free to use and modify.

🗂️ Struktur Repository

anggira-iot/
├── firmware/
│   ├── esp32-s3-xiaozhi/        # ESP32-S3 — Xiaozhi AI Voice Assistant (modifikasi)
│   └── esp32-c3-sensor/         # ESP32-C3 Mini — Sensor Rumah + Kontrol Lampu Servo
└── server/
    └── stb/                     # Server di STB Android (Termux)
        ├── anggira.py           # Core: MCP server + Telegram bot + semua tools
        ├── bot.py               # Telegram bot untuk wake/kontrol ESP32 Xiaozhi
        ├── stream_server.py     # Music streaming server (YouTube → MP3)
        ├── dashboard.py         # Web dashboard log monitor (port 8088)
        ├── google_auth.py       # Setup OAuth2 Google Calendar (jalankan sekali)
        └── launcher.sh          # Auto-launcher semua service dengan restart otomatis

🔧 Komponen Hardware

Perangkat Chip Fungsi
ESP32-S3 ESP32-S3 Xiaozhi AI voice assistant (wake word, TTS, musik)
ESP32-C3 Mini ESP32-C3 Sensor suhu/kelembaban/tekanan + kontrol lampu servo
STB Android — Server utama (Termux): AI, Telegram bot, music streaming

✨ Fitur Utama

  • 🎵 Music Streaming — minta lagu via suara/Telegram, stream dari YouTube ke speaker ESP32 atau STB
  • 📰 Berita — headline berita Indonesia terkini
  • 🌤️ Cuaca — cuaca real-time kota Salatiga (OpenWeatherMap)
  • 📅 Google Calendar — lihat & tambah jadwal via suara
  • 💡 Kontrol Lampu — ON/OFF + jadwal otomatis via servo motor
  • 🌡️ Sensor Rumah — suhu, kelembaban, tekanan udara (AHT20 + BMP280)
  • 📱 Telegram Bot — kontrol semua fitur dari HP
  • 🖥️ Web Dashboard — monitor log semua service
  • 💬 Quotes Per Jam — quotes motivasi Bahasa Indonesia yang muncul setiap jam +1 menit
  • 🕐 Chime Per Jam — pengumuman otomatis setiap jam dengan teks kustom
  • 🎵 Playlist Management — kelola playlist musik via dashboard

🚀 Quick Start

1. STB Server (Termux)

# Install dependencies
pip install python-telegram-bot websockets flask yt-dlp requests

# Set environment variables di ~/.bashrc
export TELEGRAM_BOT_TOKEN="token_xiaozhi_bot"
export TELEGRAM_STB_TOKEN="token_anggira_bot"
export OPENROUTER_API_KEY="key_kamu"
export OPENWEATHER_API_KEY="key_kamu"
export GOOGLE_CLIENT_ID="client_id"
export GOOGLE_CLIENT_SECRET="client_secret"
export ESP32_SENSOR_IP="192.168.1.222"
export TELEGRAM_ALLOWED_USER_ID="user_id_kamu"
export MCP_ENDPOINT="ws://localhost:port/mcp"

source ~/.bashrc

# (Pertama kali) Setup Google Calendar
python ~/anggira/google_auth.py

# Jalankan semua service
bash ~/anggira/launcher.sh

2. Firmware ESP32-C3 Sensor

Lihat firmware/esp32-c3-sensor/README.md

3. Firmware ESP32-S3 Xiaozhi

Lihat firmware/esp32-s3-xiaozhi/README.md

🌐 Endpoints STB Server

Service Port URL
Music Server 8080 http://STB_IP:8080
Web Dashboard 8088 http://STB_IP:8088

🖥️ Web Dashboard Features

Dashboard web tersedia di http://STB_IP:8088 dengan fitur:

📋 Logs

  • Monitor live logs dari semua service (anggira.py, stream_server.py, bot.py)
  • Auto-refresh setiap 2 detik
  • Clear logs per service

🕐 Chime

  • Aktifkan/nonaktifkan chime per jam
  • Set teks perintah yang diucapkan setiap jam
  • Pilih jam aktif (06:00-21:00 default)

💬 Quotes

  • Kelola daftar quotes motivasi Bahasa Indonesia
  • Tambah/hapus quotes custom
  • Set jam aktif untuk quotes
  • Reset ke daftar default (25 quotes)
  • Quotes muncul setiap jam +1 menit

🔑 Tokens

  • Kelola API keys dan tokens (Telegram, OpenRouter, OpenWeather, Google)
  • Simpan langsung ke ~/.bashrc

🎵 Playlist

  • Kelola playlist musik
  • Tambah/edit/hapus playlist
  • Test play langsung dari dashboard

📡 ESP32 Control

  • Kirim perintah langsung ke Xiaozhi
  • Aksi cepat (Test Chime, Lampu ON/OFF, Sensor, Cuaca)
  • Cek status ESP32 real-time

📡 Endpoints ESP32-C3

Endpoint Fungsi
/ Web dashboard ESP32
/data JSON sensor data
/sensor_rumah Data sensor untuk Anggira
/on /off Kontrol lampu
/jadwal Lihat jadwal lampu
/set?on=HH:MM&off=HH:MM Set jadwal lampu

🔗 Referensi

📄 Lisensi

MIT License — bebas digunakan dan dimodifikasi.

🌐 English Version

Anggira is an ESP32-based smart home system controlled by AI assistant Anggira via voice (Xiaozhi), Telegram, and web dashboard.

🗂️ Repository Structure

anggira-iot/
├── firmware/
│   ├── esp32-s3-xiaozhi/        # ESP32-S3 — Xiaozhi AI Voice Assistant (modified)
│   └── esp32-c3-sensor/         # ESP32-C3 Mini — Home Sensor + Lamp Servo Control
└── server/
    └── stb/                     # Server on Android STB (Termux)
        ├── anggira.py           # Core: MCP server + Telegram bot + all tools
        ├── bot.py               # Telegram bot for wake/control ESP32 Xiaozhi
        ├── stream_server.py     # Music streaming server (YouTube → MP3)
        ├── dashboard.py         # Web dashboard log monitor (port 8088)
        ├── google_auth.py       # OAuth2 Google Calendar setup (run once)
        └── launcher.sh          # Auto-launcher for all services with auto-restart

🔧 Hardware Components

Device Chip Function
ESP32-S3 ESP32-S3 Xiaozhi AI voice assistant (wake word, TTS, music)
ESP32-C3 Mini ESP32-C3 Home temperature/humidity/pressure sensor + lamp servo control
Android STB — Main server (Termux): AI, Telegram bot, music streaming

✨ Key Features

  • 🎵 Music Streaming — request songs via voice/Telegram, stream from YouTube to ESP32 or STB speakers
  • 📰 News — latest Indonesian news headlines
  • 🌤️ Weather — real-time weather for Salatiga city (OpenWeatherMap)
  • 📅 Google Calendar — view & add schedule via voice
  • 💡 Lamp Control — ON/OFF + automatic schedule via servo motor
  • 🌡️ Home Sensors — temperature, humidity, air pressure (AHT20 + BMP280)
  • 📱 Telegram Bot — control all features from phone
  • 🖥️ Web Dashboard — monitor logs from all services
  • 💬 Hourly Quotes — motivational Indonesian quotes every hour +1 minute
  • 🕐 Hourly Chime — automatic hourly announcement with custom text
  • 🎵 Playlist Management — manage music playlists via dashboard

🚀 Quick Start

1. STB Server (Termux)

# Install dependencies
pip install python-telegram-bot websockets flask yt-dlp requests

# Set environment variables in ~/.bashrc
export TELEGRAM_BOT_TOKEN="your_xiaozhi_bot_token"
export TELEGRAM_STB_TOKEN="your_anggira_bot_token"
export OPENROUTER_API_KEY="your_key"
export OPENWEATHER_API_KEY="your_key"
export GOOGLE_CLIENT_ID="client_id"
export GOOGLE_CLIENT_SECRET="client_secret"
export ESP32_SENSOR_IP="192.168.1.222"
export TELEGRAM_ALLOWED_USER_ID="your_user_id"
export MCP_ENDPOINT="ws://localhost:port/mcp"

source ~/.bashrc

# (First time) Setup Google Calendar
python ~/anggira/google_auth.py

# Run all services
bash ~/anggira/launcher.sh

2. ESP32-C3 Sensor Firmware

See firmware/esp32-c3-sensor/README.md

3. ESP32-S3 Xiaozhi Firmware

See firmware/esp32-s3-xiaozhi/README.md

🌐 STB Server Endpoints

Service Port URL
Music Server 8080 http://STB_IP:8080
Web Dashboard 8088 http://STB_IP:8088

🖥️ Web Dashboard Features

Web dashboard available at http://STB_IP:8088 with features:

📋 Logs

  • Monitor live logs from all services (anggira.py, stream_server.py, bot.py)
  • Auto-refresh every 2 seconds
  • Clear logs per service

🕐 Chime

  • Enable/disable hourly chime
  • Set command text spoken every hour
  • Select active hours (06:00-21:00 default)

💬 Quotes

  • Manage Indonesian motivational quotes list
  • Add/delete custom quotes
  • Set active hours for quotes
  • Reset to default list (25 quotes)
  • Quotes appear every hour +1 minute

🔑 Tokens

  • Manage API keys and tokens (Telegram, OpenRouter, OpenWeather, Google)
  • Save directly to ~/.bashrc

🎵 Playlist

  • Manage music playlists
  • Add/edit/delete playlists
  • Test play directly from dashboard

📡 ESP32 Control

  • Send direct commands to Xiaozhi
  • Quick actions (Test Chime, Lamp ON/OFF, Sensor, Weather)
  • Check ESP32 real-time status

📡 ESP32-C3 Endpoints

Endpoint Function
/ ESP32 web dashboard
/data JSON sensor data
/sensor_rumah Sensor data for Anggira
/on /off Lamp control
/jadwal View lamp schedule
/set?on=HH:MM&off=HH:MM Set lamp schedule

🔗 References

📄 License

MIT License — free to use and modify.

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages