Guide

Setelah instal, mulai dari sini.

Panduan singkat memakai CAKRA-AI di kelas — dari instalasi pertama sampai sesi mengajar yang tampil di proyektor.

Instalasi cepat

Belum pasang CAKRA-AI sama sekali? Mulai dari sini. Pilih sistem operasi server sekolahnya, salin perintahnya, lalu jalankan berurutan dari atas ke bawah. Untuk detail konfigurasi lebih lanjut, lihat halaman Docs.

$brew install node@20 postgresql ollama

$git clone https://github.com/monn01/CAKRA-AI.git

$cd CAKRA-AI && npm install

$npm run dev

Setup

Buat akun guru pertama, lalu masuk lewat halaman login.

Jalankan perintah ini sekali di server setelah instalasi selesai untuk membuat akun guru pertama. Akun ini punya akses penuh untuk membuat sesi, memvalidasi materi, dan mengelola akun guru lain di kemudian hari.

$npm run create-teacher

Baca README lengkap di GitHub

Sesi mengajar pertama

Dari dashboard guru, buka Sesi Baru, beri judul materi, lalu mulai bicara — mikrofon menangkap suara secara langsung dan transkripnya muncul real-time. Setelah selesai, AI menyusun rangkuman, peta pikiran, dan kuis dari transkrip tersebut, siap divalidasi sebelum tampil ke proyektor.

Tidak perlu mengedit manual — guru cukup membaca sekilas hasil AI-nya, koreksi kalau ada yang meleset, lalu tekan validasi. Materi langsung tersinkron ke layar proyektor di depan kelas dalam hitungan detik.

Menjalankan AI lokal

Untuk sekolah dengan internet terbatas, jalankan model AI lokal lewat Ollama — tidak ada data yang perlu dikirim ke luar. Cocok dipakai di ruang server sekolah yang koneksinya seadanya, karena semua pemrosesan terjadi di mesin yang sama.

$ollama serve

$ollama pull qwen2.5:7b

Set LLM_PROVIDER=ollama di .env.local supaya aplikasi memakainya secara default.

Tips proyektor & QR

Beberapa hal kecil yang bikin sesi di depan kelas lebih lancar tanpa perlu pengaturan tambahan:

Layar proyektor otomatis pakai kontras tinggi dan font besar — tidak perlu pengaturan tambahan.
Kode QR resume muncul otomatis di akhir sesi — siswa tinggal memindai dengan HP masing-masing.
Kuis bisa langsung dimainkan di kelas selagi materi masih segar, sebelum siswa pulang membawa resume-nya.