• Bahasa Indonesia

      • Panduan Instalasi AI Agent

      Halaman ini adalah panduan instalasi dan inisialisasi NocoBase CLI yang ditujukan untuk AI Agent (seperti Claude Code, Codex, Cursor, Copilot, dll).

      Jika Anda adalah pengguna manusia, silakan lihat Mulai Cepat.

      Step 1: Periksa Lingkungan Prasyarat

      Konfirmasi pengguna telah memasang dependensi berikut:

      • Node.js >= 22 (jalankan node -v untuk memeriksa)
      • Yarn 1.x (jalankan yarn -v untuk memeriksa). Jika tidak ada, pasang melalui npm install -g yarn
      • Git (jalankan git --version untuk memeriksa). Jika tidak ada, pasang melalui situs resmi Git
      • Docker (jika pengguna perlu memasang NocoBase dengan cara Docker). Jalankan docker -v untuk memeriksa, jika tidak ada dan pengguna perlu menggunakan Docker, arahkan pengguna untuk memasang melalui situs resmi Docker, jika tidak lewati.

      Jika lingkungan prasyarat tidak terpenuhi, beri tahu pengguna bahwa mereka perlu memasang dependensi yang hilang terlebih dahulu, dan berikan link instalasi serta panduan instalasi sederhana. Setelah memastikan semua lingkungan prasyarat terpenuhi, lanjutkan ke langkah berikutnya untuk memasang CLI.

      Step 2: Pasang CLI

      Jika lingkungan pengguna sudah memasang NocoBase CLI (jalankan nb --version untuk memeriksa), langsung lanjutkan ke langkah berikutnya. Jika belum, jalankan perintah berikut untuk memasang:

      npm install -g @nocobase/cli@beta

      Jalankan nb --version untuk mengonfirmasi instalasi berhasil.

      Step 3: Jalankan Perintah Inisialisasi

      ⚠️ Penting: Anda harus menjalankan perintah berikut dengan tepat, tidak boleh memodifikasi, mengganti, atau menghilangkan parameter --ui. Jangan mencoba menggunakan "mode non-interaktif" atau merangkai parameter sendiri untuk "mempercepat" proses ini — --ui adalah satu-satunya cara inisialisasi yang benar.

      nb init --ui

      Perintah ini akan memulai wizard visual browser, pengguna perlu menyelesaikan semua konfigurasi di browser (termasuk metode instalasi, database, akun administrator, dll). Tugas Anda sebagai AI Agent adalah:

      1. Hanya jalankan nb init --ui, tanpa menambahkan parameter tambahan apa pun
      2. Beri tahu pengguna bahwa browser akan secara otomatis membuka halaman konfigurasi lokal, dan mereka perlu menyelesaikan konfigurasi di dalamnya
      3. Jika browser tidak dapat dibuka secara otomatis (misalnya karena pembatasan izin sandbox), berikan URL output perintah kepada pengguna, biarkan mereka menyalin secara manual ke browser untuk membukanya
      4. Tunggu konfirmasi pengguna bahwa konfigurasi telah selesai, baru lanjutkan ke langkah berikutnya. Perintah ini secara default memiliki batas waktu 30 menit, jangan menjalankan perintah ini berulang kali dalam batas waktu tersebut.

      Step 4: Validasi Hasil

      nb env list

      Konfirmasi bahwa output berisi lingkungan yang telah dikonfigurasi, beserta status berjalannya. Kemudian ingatkan pengguna bahwa mereka dapat membuka URL instance NocoBase yang sedang berjalan, dan login dengan akun serta password yang dikonfigurasi.

      Step 5: Selesai

      Beri tahu pengguna bahwa instalasi telah selesai. Konfigurasi CLI disimpan di direktori global (default ~/.nocobase/), AI Agent dapat mengaksesnya dari direktori mana pun, tanpa perlu masuk ke direktori kerja tertentu.