Kembali
Documentation

Dokumentasi teknis.

Semua yang perlu diketahui untuk memasang dan menjalankan CAKRA-AI sendiri — dari prasyarat sampai konfigurasi provider AI.

Ringkasan

CAKRA-AI adalah software pendidikan inklusif yang menangkap suara guru secara real-time, mengubahnya jadi transkrip, lalu menyusun rangkuman, peta pikiran interaktif, dan kuis secara otomatis lewat AI. Materi tampil di proyektor kelas dan bisa dibawa pulang siswa lewat kode QR. Dirancang untuk sekolah dengan infrastruktur terbatas — AI bisa berjalan lokal lewat Ollama tanpa bergantung pada koneksi internet stabil.

Dokumen ini menjelaskan sisi teknis: apa saja yang perlu disiapkan di server sekolah, bagaimana proses instalasinya, variabel konfigurasi yang tersedia, dan gambaran umum arsitektur sistemnya. Untuk panduan pemakaian sehari-hari setelah instalasi selesai, lihat halaman Guide.

Prasyarat

Pasang keempat hal berikut sebelum mengkloning repository. Semua bisa berjalan di satu mesin yang sama — tidak perlu server terpisah untuk database maupun AI.

  • Node.js 20+ dan npm
  • PostgreSQL (lokal atau hosted)
  • Ollama (opsional, untuk AI lokal offline)
  • Git

Instalasi

Clone repo, install dependency, lalu jalankan server development. Perintah persiapan sebelum clone berbeda tergantung sistem operasi — pilih tab yang sesuai di bawah ini.

$brew install node@20 postgresql ollama
$git clone https://github.com/monn01/CAKRA-AI.git
$cd CAKRA-AI && npm install
$npm run dev

Setelah npm install selesai, jalankan npx prisma db push sekali untuk menyinkronkan schema ke database sebelum npm run dev.

Konfigurasi

Salin .env.local.example jadi .env.local, lalu isi variabel berikut. LLM provider bersifat provider-agnostic — tinggal ganti LLM_PROVIDER, tidak perlu ubah kode aplikasi sama sekali.

DATABASE_URLConnection string PostgreSQL (lokal atau hosted).
NEXTAUTH_SECRETSecret acak untuk sesi login NextAuth.
LLM_PROVIDERollama · qwen · openrouter — provider AI aktif.
LLM_BASE_URLEndpoint provider yang dipilih (mis. Ollama lokal).

Arsitektur singkat

Semua berjalan sebagai satu aplikasi Next.js, ditambah proses Socket.IO custom untuk koneksi real-time ke proyektor kelas. Tidak ada layanan mikro terpisah yang perlu dikelola.

Next.js App Router + TypeScript
PostgreSQL + Prisma
Socket.IO custom server (real-time)
React Flow untuk peta pikiran

Lisensi & kontribusi

CAKRA-AI open source dan bebas dipasang mandiri. Laporan bug, ide fitur, atau kontribusi kode bisa diajukan lewat repository GitHub.