Skip to content

tirtandro/ai-energy-tracker-groq

Repository files navigation

🌱 AI Energy Tracker | SMAN 2 Wates

AI Energy Tracker adalah sebuah dashboard interaktif berbasis Streamlit yang dirancang untuk melacak dan memvisualisasikan konsumsi energi, emisi karbon, serta penggunaan air secara real-time dari interaksi dengan model Generative AI super cepat Groq (Llama 3).

Proyek ini merupakan bagian dari Inovasi Konservasi Energi SMAN 2 Wates.

👨‍💻 Pengembang: Tirtandro Meda


✨ Fitur Utama

  • Pemantauan Real-Time: Menghitung estimasi penggunaan energi (kWh), jejak karbon (kgCO2eq), dan konsumsi air (m³).
  • 📝 Analogi Dampak Lingkungan: Mengonversi data numerik dampak digital menjadi perumpamaan sehari-hari (contoh: "Energi setara mengecas N buah Smartphone" atau "Emisi setara menaiki motor sejauh N meter") agar mudah dipahami awam.
  • 📊 Visualisasi Komprehensif: Menyediakan Multi-Area Chart untuk tren kumulatif, Bar Chart perbandingan per-prompt, dan Diagram Radar ekologis berbasis Plotly.
  • Smart Model Fallback: Menggunakan performa super cepat Groq API. Otomatis mencoba llama-3.3-70b-versatile dan mundur ke llama-3.1-8b-instant jika kuota limit (HTTP 429) tercapai.
  • Kustomisasi Zona Energi: Memungkinkan pemilihan zona bauran listrik (seperti Indonesia, US, Eropa) untuk penghitungan emisi yang lebih akurat.

🚀 Instalasi dan Menjalankan Lokal

  1. Clone repository ini

    git clone https://github.com/tirtandro/ai-energy-tracker-groq.git
    cd ai-energy-tracker-groq
  2. Setup Rahasia (API Key) Buat folder .streamlit dan sebuah file bernama secrets.toml:

    # .streamlit/secrets.toml
    GROQ_API_KEY = "masukkan_api_key_groq_anda_disini"
  3. Install dependensi Pastikan Anda sudah menginstal Python 3.10+. Jalankan perintah:

    pip install -r requirements.txt

    (Dependensi utama: streamlit, groq, pandas, plotly, dan ecologits)

  4. Jalankan Aplikasi

    streamlit run dashboard.py

    Aplikasi akan otomatis terbuka di browser pada http://localhost:8501.

🌐 Deployment (Streamlit Community Cloud)

Repository ini telah dikonfigurasi dan dioptimasi penuh agar siap di-deploy langsung ke Streamlit Community Cloud.

  1. Hubungkan repository GitHub ini di dashboard Streamlit Cloud.
  2. Pada bagian Advanced Settings, isikan kolom Secrets dengan GROQ_API_KEY.
  3. Aplikasi akan otomatis ter-deploy dengan aman.

Powered by

Proyek ini ditenagai oleh EcoLogits, sebuah pustaka open-source untuk melacak dampak lingkungan dari penggunaan API model AI Generatif.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages