Skip to content

Latest commit

ย 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒŠ Kai - Your Daily AI Companion

React Groq AI TailwindCSS Languages License

๐Ÿ’ก Side Project Alert! Ini adalah project sampingan sederhana yang saya buat untuk belajar dan bereksperimen dengan AI chatbot. Ternyata cukup berguna untuk membantu aktivitas sehari-hari - dari schedule management, hitung-hitungan, sampai translate 16+ bahasa!

โœจ Tentang Project Ini

Kai adalah AI chatbot berbahasa Indonesia yang saya buat sebagai project coba-coba untuk mengeksplorasi:

  • ๐Ÿค– Integrasi dengan AI API (Groq AI + Llama 3.3)
  • โš›๏ธ React untuk UI interaktif
  • ๐Ÿ“… Manajemen jadwal sederhana
  • ๐ŸŒ Multi-language translation (16+ bahasa)
  • ๐Ÿงฎ Kalkulator AI yang bisa menjelaskan rumus

Awalnya cuma iseng bikin chatbot, eh ternyata malah sering saya pakai sendiri buat:

  • Track jadwal harian
  • Translate dokumen & komunikasi
  • Hitung-hitungan cepat (persentase, matematika, dll)
  • Tanya-tanya hal random ke AI

๐ŸŽฏ Fitur Utama

1๏ธโƒฃ Multi-Language Translator ๐ŸŒโœจ

  • ๐Ÿ”ค 16+ bahasa tersedia (Indonesia, English, ไธญๆ–‡, ๆ—ฅๆœฌ่ชž, ํ•œ๊ตญ์–ด, ุงู„ุนุฑุจูŠุฉ, dan lainnya)
  • ๐Ÿ” Auto detect bahasa sumber
  • ๐Ÿ”„ Swap language dengan cepat
  • ๐Ÿ“‹ Copy hasil terjemahan dengan 1 klik
  • ๐ŸŽฏ Powered by Llama 3.3 70B untuk akurasi tinggi
  • ๐Ÿ’ผ Perfect untuk business, travel, atau belajar bahasa

2๏ธโƒฃ Smart Schedule Management

  • โœ… Tambah/hapus jadwal dengan form yang mudah
  • ๐Ÿ”ด Status real-time: Sedang Berlangsung / Akan Datang / Selesai
  • โš ๏ธ Deteksi otomatis jadwal yang bentrok
  • ๐Ÿ“Š Lihat jadwal hari ini dan yang akan datang

3๏ธโƒฃ AI-Powered Math Helper

  • ๐Ÿงฎ Perhitungan matematika (persentase, aljabar, kalkulus, dll)
  • ๐Ÿ“ Penjelasan rumus dengan step-by-step
  • ๐Ÿ’ก Contoh soal dan cara pengerjaannya

4๏ธโƒฃ Chatbot Ramah

  • ๐Ÿ’ฌ Bahasa Indonesia yang natural dan friendly
  • โฐ Info waktu dan tanggal real-time
  • ๐ŸŒŠ Personality yang calm dan supportive
  • โšก Response super cepat (thanks to Groq AI!)

๐Ÿš€ Quick Start

Prerequisites

  • Browser modern (Chrome, Firefox, Edge, Safari)
  • API Key dari Groq (gratis!)

Installation

  1. Clone repository ini
git clone https://github.com/yourusername/kai-chatbot.git
cd kai-chatbot
  1. Edit API Key Buka file Kai.html dan ganti dengan API key Groq Anda:
    const GROQ_API_KEY = 'your-groq-api-key-here';
  2. Buka di browser Cukup double-click file Kai.html atau buka via browser!
    # Atau pakai simple HTTP server
    python -m http.server 8000
    # Buka http://localhost:8000

๐Ÿ’ป Tech Stack

Technology Purpose
React 18.2 UI Components & State Management
Groq AI (Llama 3.3 70B) AI Brain - Super fast inference!
TailwindCSS Styling & Responsive Design
Vanilla JS Schedule logic & commands
localStorage Session data persistence

๐Ÿ“ธ Screenshots

Chat Interface

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  ๐ŸŒŠ Kai - Your Daily AI Companion   โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚                                     โ”‚
โ”‚  [Bot] Halo! Saya Kai ๐ŸŒŠ           โ”‚
โ”‚        Ada yang bisa saya bantu?    โ”‚
โ”‚                                     โ”‚
โ”‚              [User] Hitung 15% dari โ”‚
โ”‚                     250.000         โ”‚
โ”‚                                     โ”‚
โ”‚  [Bot] ๐Ÿงฎ PERHITUNGAN               โ”‚
โ”‚        15% dari 250.000 = 37.500   โ”‚
โ”‚                                     โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Schedule Manager

  • ๐Ÿ”ด Sedang Berlangsung : Meeting Tim (10:00 - 11:30)
  • ๐ŸŸข Akan Datang : Presentation (14:00 - 15:00)
  • โšช Selesai : Daily Standup (09:00 - 09:15) โœ“

Translator Interface

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚     ๐ŸŒ TRANSLATOR                   โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  ๐Ÿ” Auto     โ”‚  ๐Ÿ‡ฌ๐Ÿ‡ง English         โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Source Text       โ”‚  Translation   โ”‚
โ”‚                    โ”‚                โ”‚
โ”‚  Selamat pagi,     โ”‚  Good morning, โ”‚
โ”‚  apa kabar?        โ”‚  how are you?  โ”‚
โ”‚                    โ”‚                โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         [๐ŸŒ Translate]

๐ŸŒ Translator Feature Details

Supported Languages (16+)

Region Languages
Asia ๐Ÿ‡ฎ๐Ÿ‡ฉ Indonesian, ๐Ÿ‡จ๐Ÿ‡ณ Chinese, ๐Ÿ‡ฏ๐Ÿ‡ต Japanese, ๐Ÿ‡ฐ๐Ÿ‡ท Korean, ๐Ÿ‡ฎ๐Ÿ‡ณ Hindi, ๐Ÿ‡น๐Ÿ‡ญ Thai, ๐Ÿ‡ป๐Ÿ‡ณ Vietnamese
Europe ๐Ÿ‡ฌ๐Ÿ‡ง English, ๐Ÿ‡ช๐Ÿ‡ธ Spanish, ๐Ÿ‡ซ๐Ÿ‡ท French, ๐Ÿ‡ฉ๐Ÿ‡ช German, ๐Ÿ‡ท๐Ÿ‡บ Russian, ๐Ÿ‡ต๐Ÿ‡น Portuguese, ๐Ÿ‡ฎ๐Ÿ‡น Italian, ๐Ÿ‡ณ๐Ÿ‡ฑ Dutch
Middle East ๐Ÿ‡ธ๐Ÿ‡ฆ Arabic

Use Cases

  • ๐Ÿ“ง Business Communication - Translate emails, documents, proposals
  • โœˆ๏ธ Travel - Understand local language, menus, signs
  • ๐Ÿ“š Learning - Study foreign languages with instant translation
  • ๐ŸŒ International Work - Collaborate with global teams
  • ๐Ÿ“ฑ Social Media - Understand posts in different languages
  • ๐Ÿ“– Reading - Translate articles, books, news

๐ŸŽฎ Cara Pakai

Commands Dasar

๐Ÿ’ฌ Percakapan:
   "Halo" / "Hi"              โ†’ Sapaan ramah dari Kai
   "Siapa kamu?"              โ†’ Info tentang Kai
   "Bantuan"                  โ†’ Panduan lengkap

โฐ Waktu & Tanggal:
   "Jam berapa?"              โ†’ Waktu saat ini
   "Tanggal berapa?"          โ†’ Tanggal hari ini

๐Ÿ“… Jadwal:
   Klik "โž• Jadwal"           โ†’ Form tambah jadwal
   "Lihat jadwal"             โ†’ Tampilkan semua jadwal
   "Hapus jadwal [ID]"        โ†’ Hapus jadwal tertentu

๐ŸŒ Translator:
   Klik "๐ŸŒ Translator"       โ†’ Buka modal translator (RECOMMENDED)
   "Translate..."             โ†’ Terjemah via chat
   "Terjemahkan..."           โ†’ Terjemah via chat
   
   Bahasa tersedia:
   โ€ข ๐Ÿ‡ฎ๐Ÿ‡ฉ Indonesia  โ€ข ๐Ÿ‡ฌ๐Ÿ‡ง English    โ€ข ๐Ÿ‡จ๐Ÿ‡ณ Chinese
   โ€ข ๐Ÿ‡ฏ๐Ÿ‡ต Japanese   โ€ข ๐Ÿ‡ฐ๐Ÿ‡ท Korean     โ€ข ๐Ÿ‡ธ๐Ÿ‡ฆ Arabic
   โ€ข ๐Ÿ‡ช๐Ÿ‡ธ Spanish    โ€ข ๐Ÿ‡ซ๐Ÿ‡ท French     โ€ข ๐Ÿ‡ฉ๐Ÿ‡ช German
   โ€ข ๐Ÿ‡ท๐Ÿ‡บ Russian    โ€ข ๐Ÿ‡ต๐Ÿ‡น Portuguese โ€ข ๐Ÿ‡ฎ๐Ÿ‡ณ Hindi
   โ€ข ๐Ÿ‡น๐Ÿ‡ญ Thai       โ€ข ๐Ÿ‡ป๐Ÿ‡ณ Vietnamese โ€ข ๐Ÿ‡ฎ๐Ÿ‡น Italian
   โ€ข ๐Ÿ‡ณ๐Ÿ‡ฑ Dutch      + Auto Detect ๐Ÿ”

๐Ÿงฎ Matematika:
   "Hitung 20% dari 500.000"  โ†’ Kalkulator persentase
   "Jelaskan rumus pythagoras" โ†’ Penjelasan rumus
   "Solve: 2x + 5 = 15"       โ†’ Selesaikan persamaan

๐Ÿ—๏ธ Project Structure

kai-chatbot/
โ”‚
โ”œโ”€โ”€ index.html          # Main file (All-in-one!)
โ”‚
โ””โ”€โ”€ README.md               # You are here ๐Ÿ˜Š

Yep, cuma 1 file HTML! Simple kan? ๐ŸŽ‰

๐Ÿค” Why This Project?

Ini adalah learning project yang saya buat untuk:

  1. Belajar AI Integration - Gimana caranya panggil AI API dengan efisien
  2. Eksperimen React - State management tanpa framework berat
  3. Explore UI/UX - Bikin chatbot yang enak dipakai
  4. Multi-language Processing - Implementasi translator dengan AI
  5. Solve Real Problems - Ternyata berguna buat daily task management!

Bonus : Fitur translator yang tadinya cuma eksperimen, sekarang jadi salah satu fitur favorit saya! ๐ŸŒ

โš ๏ธ Disclaimer

  • ๐Ÿ”ง Ini adalah project sampingan yang dibuat untuk belajar dan fun
  • ๐Ÿ› Mungkin ada bugs atau hal-hal yang bisa diimprove
  • ๐Ÿš€ Not production-ready, tapi cukup untuk daily use!
  • ๐Ÿ’ก Feel free to fork, modify, atau improve!

๐ŸŽฏ Roadmap

Completed โœ…

  • Multi-language translator (16+ languages)
  • Smart schedule management
  • AI math helper
  • Conflict detection for schedules

Maybe in the Future? ๐Ÿค”

Kalau sempat dan ada ide, mungkin akan ditambah:

  • Export jadwal ke Google Calendar
  • Dark mode toggle
  • Voice input untuk chat dan translator
  • Reminder notifications
  • Text-to-speech untuk hasil translate
  • Mobile app version
  • Cloud sync untuk jadwal
  • Translation history
  • Batch translation untuk multiple texts

Tapi ya... ini side project, jadi no promises ๐Ÿ˜…

๐Ÿค Contributing

Mau contribute? Silakan banget!

  1. Fork this repo
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add some AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Any improvements welcome! ๐Ÿ™Œ

๐Ÿ› Known Issues

  • Jadwal tidak persist setelah refresh (pakai localStorage untuk session only)
  • AI parsing kadang tidak konsisten (makanya ditambah form manual)
  • Translation via chat kurang optimal (gunakan modal translator untuk hasil terbaik)
  • Belum ada unit tests (it's a side project ๐Ÿ˜ฌ)

๐Ÿ“ License

MIT License - Feel free to use this project for anything!

๐Ÿ‘จโ€๐Ÿ’ป Author

Your Name

๐Ÿ™ Acknowledgments

  • Groq - Amazing fast AI inference!
  • Meta's Llama 3.3 - Powerful language model with excellent multilingual support
  • React - UI library
  • TailwindCSS - Styling framework
  • Kopi โ˜• - Fuel for coding sessions
  • All the language communities worldwide ๐ŸŒ - For inspiring the translator feature

**โญ Star this repo if you find it helpful!**

Made with โค๏ธ and lots of โ˜• for learning purposes

๐ŸŒŠ Stay calm like ocean waves ๐ŸŒŠ

NEW : Now with 16+ languages translation! ๐ŸŒโœจ

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages