Cara menginstal nanobot di Mac mini

Apa itu nanobot

nanobot adalah AI agent pribadi open source dari grup HKUDS di GitHub. nanobot ditulis dalam Python dengan lisensi MIT. Seperti OpenClaw, nanobot menyimpan memori, menjalankan tool, dan menjawab Anda dari aplikasi chat. Core-nya dibuat kecil dan mudah dibaca (github.com/HKUDS/nanobot, dibaca 2 Oktober 2026). Rilis terbaru di PyPI adalah 0.3.5, pada 15 September 2026.

Anda bisa memakainya di WebUI browser, di terminal, atau dari Telegram, Discord, Slack, Email, dan channel lain. nanobot bisa bekerja dengan file, menjalankan perintah shell, mencari di web, memakai MCP server, dan menjalankan job terjadwal. Satu catatan lagi soal nama. Ini bukan obot-platform/nanobot, yaitu framework Go untuk membangun agen MCP.

Kebutuhan

• Python 3.11 atau lebih baru. Cek dengan python3 --version. Installer berhenti jika tidak menemukannya, jadi pasang Python dulu jika perlu.
• macOS 13 atau lebih baru. Package prebuilt untuk Mac Apple silicon dan Intel sudah mencakup WebUI dan UI terminal.
• Penyedia model. Anthropic, OpenAI, OpenRouter, dan server lokal seperti Ollama semuanya dibahas di dokumentasi penyedia. Pakai API key dari penyedia yang Anda pilih.
• Git dan Bun, tetapi hanya jika Anda menginstal dari source. Instalasi normal tidak membutuhkannya.

Instal

Jalankan installer resmi satu perintah dari README.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Installer memasang package nanobot-ai dari PyPI. Installer menghindari instalasi pip di level sistem. Installer memakai virtual environment yang aktif, uv, pipx, atau environment miliknya sendiri di folder .nanobot di home Anda. Lalu installer menampilkan perintah persis yang dipakainya. Untuk melihat rencananya tanpa mengubah apa pun, tambahkan flag dry run.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

Jika Anda sudah memakai uv, perintah ini melakukan hal yang sama. Lalu cek versinya.

uv tool install nanobot-ai
nanobot --version

Eksekusi pertama dan model

README merekomendasikan WebUI untuk eksekusi pertama. WebUI terbuka di 127.0.0.1 port 8765 dan hanya mendengarkan di Mac ini.

nanobot webui

Buka Settings, lalu Models. Pilih penyedia, tempel API key-nya, dan pilih model. Lalu mulai topik baru dan kirim Hello. Balasan normal apa pun berarti penyedia, model, dan gateway bekerja sama dengan baik. Dari terminal, pesan sekali kirim melakukan pengecekan yang sama.

nanobot -m "Hello!"

Pengaturan disimpan ke config.json di folder .nanobot di home Anda. Kami belum menjalankan instalasi ini di mesin test kami sendiri. Perintah di sini disalin dari README dan dokumentasi nanobot per 2 Oktober 2026.

Jaga tetap berjalan 24/7

Gateway adalah bagian yang tetap online. Gateway menjaga aplikasi chat, job terjadwal, dan pekerjaan memori tetap berjalan. Perintah ini menjaganya tetap berjalan setelah Anda menutup terminal.

nanobot gateway --background

Cara itu tidak bertahan setelah reboot. Untuk itu, dokumentasi deployment memasang LaunchAgent. Selesaikan setup model di WebUI dulu. Lalu lihat dulu file layanannya dan pasang.

nanobot gateway install-service --manager launchd --dry-run
nanobot gateway install-service --manager launchd

Perintah itu menulis ai.nanobot.gateway.plist ke folder LaunchAgents di dalam Library di home Anda. Gateway dijalankan dengan Python yang sama yang memasang nanobot. Log masuk ke folder logs di dalam .nanobot. Jika gagal dengan pesan address already in use, hentikan dulu gateway yang Anda jalankan secara manual.

launchctl list | grep ai.nanobot.gateway
launchctl kickstart -k gui/$(id -u)/ai.nanobot.gateway
nanobot gateway uninstall-service --manager launchd

Gateway hanya membaca config.json saat startup. Restart gateway setelah setiap perubahan config.

LaunchAgent hanya berjalan saat ada user yang login. Di Mac tanpa pengawasan, aktifkan login otomatis untuk akun yang menjalankan nanobot. Lalu cegah Mac tidur, karena tidur menjeda gateway dan job terjadwalnya.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Detail lebih lanjut ada di apa yang terjadi saat Mac tidur dan panduan Mac yang selalu menyala.

Catatan keamanan

• Untuk production, dokumentasinya menyarankan dua pengaturan sekaligus. Atur restrictToWorkspace ke true, dan atur tools.exec.sandbox ke seatbelt di macOS. Seatbelt membatasi perintah shell ke folder workspace.
• Kedua pengaturan itu tidak membatasi akses jaringan. Simpan rahasia di luar workspace.
• WebUI dan health check gateway mendengarkan di 127.0.0.1 secara default. Biarkan hanya di Mac ini.
• Pengirim yang tidak dikenal di aplikasi chat mendapat kode pairing, bukan jawaban. Anda menyetujuinya dengan /pairing approve dan kodenya.
• Dokumentasinya menyarankan referensi variabel environment untuk API key, bukan key mentah di config.json. Apa pun caranya, perlakukan folder .nanobot seperti file password.

Perlindungan paling sederhana adalah Mac yang tidak menyimpan apa pun milik Anda selain itu. Jika agen berbuat aneh, kerusakannya berhenti di mesin itu.

Menjalankannya di Mac MacRun

Paket agen kami adalah Mac mini khusus yang tidak pernah tidur. Mesinnya berada di fasilitas privat milik kami sendiri di New Jersey. Sesi login-nya kembali sendiri setelah reboot, jadi LaunchAgent nanobot berjalan lagi. Claude Code dan Codex sudah terpasang. nanobot tidak. Anda memasangnya sendiri, bersama Python jika perlu, karena Anda punya akses admin penuh.

Anda bisa membuka WebUI di browser milik Mac itu sendiri lewat desktop browser kami. Paket agen seharga $169 per bulan. MacRun tidak menjual API key. Pakai API key dari penyedia model Anda, yang menagih pemakaian sesuai ketentuannya sendiri.

Kapan Anda tidak butuh MacRun

nanobot kecil dan bisa berjalan hampir di mana saja. Dokumentasinya membahas layanan Linux, Docker, dan deploy Render sekali klik. Jika Anda tidak butuh apa pun dari macOS, semua itu lebih murah daripada Mac. Dan jika Anda sudah punya Mac yang selalu menyala dan login, pakai itu.

MacRun untuk pekerjaan developer, sesuai kebijakan penggunaan kami. nanobot yang memilah issue atau menjalankan tugas rutin repo setiap malam cocok. nanobot yang mengurus inbox pribadi Anda tidak cocok. Untuk membandingkan paket, lihat halaman Mac untuk agen.