Jalankan dari source

Di akhir halaman ini API Kanesh dan Studio jalan langsung di mesinmu, dan Studio otomatis reload saat kamu mengedit.

Kebutuhan

Tool	Versi	Ditentukan di
Go	1.27.3	`api/go.mod`
Node.js	24 atau lebih baru	`studio/package.json` (`engines`)
pnpm	12.8.1	`studio/package.json` (`packageManager`)
Git	versi terbaru

Note: Pakai versi Go yang persis sama dengan api/go.mod. Kalau kamu pakai corepack, jalankan corepack enable dan pnpm otomatis memakai versi yang dikunci.

Cek tool kamu:

go version        # go1.27.3
node --version    # v24.0.0 atau lebih baru
pnpm --version    # 12.8.1

1. Clone dan install dependency Studio

git clone https://github.com/kaneshdev/kanesh.git
cd kanesh/studio
pnpm install --frozen-lockfile
cd ..

2. Jalankan API dan Studio sekaligus

node docs/scripts/dev.js

Launcher ini mem-build API, menunggu sampai siap, lalu menjalankan Studio dengan proxy ke API. Ctrl+C menghentikan keduanya.

Service	URL default	Ubah dengan
Studio	`http://127.0.0.1:5173`	`STUDIO_PORT`
API	`http://127.0.0.1:8080`	`PORT`

Tanpa pengaturan database, data disimpan di SQLite pada api/.data/kanesh.db. Data yang sudah ada tetap tersimpan antar run.

Note: Launcher tidak membaca file .env. Ekspor variabel di shell dulu, misalnya export MCP_ENABLED=true.

3. Klaim instalasi

Buka http://127.0.0.1:5173 lalu tempel token sekali pakai dari api/.data/claim-token, atau isi ADMIN_EMAIL dan ADMIN_PASSWORD sebelum start pertama.

Menjalankan dua service terpisah

API, dari folder api/:

nice -n 10 go run -p 4 -tags=nomsgpack ./cmd/kanesh

Studio, dari folder studio/ di terminal lain:

pnpm dev

Restart API setelah mengubah backend; perubahan Studio langsung reload.

Pemecahan masalah

Port sudah dipakai: launcher berhenti, bukan mematikan proses lain. Kosongkan port atau atur PORT / STUDIO_PORT.
Versi Go salah: error saat build biasanya karena toolchain lama. Install Go 1.27.3.
Versi pnpm beda: jalankan corepack enable atau install pnpm 12.8.1.