Mac mini पर nanobot कैसे इंस्टॉल करें

nanobot क्या है

nanobot, GitHub के HKUDS ग्रुप का ओपन सोर्स निजी AI एजेंट है। यह Python में लिखा है, MIT लाइसेंस के तहत। OpenClaw की तरह यह मेमोरी रखता है, टूल चलाता है और चैट ऐप से आपको जवाब देता है। इसका core छोटा और पढ़ने लायक रखा गया है (github.com/HKUDS/nanobot, 2 अक्टूबर 2026 को पढ़ा)। PyPI पर सबसे नई रिलीज़ 0.3.5 थी, 15 सितंबर 2026 को।

आप इसे ब्राउज़र WebUI में, टर्मिनल में, या Telegram, Discord, Slack, Email और दूसरे channels से इस्तेमाल कर सकते हैं। यह फ़ाइलों के साथ काम कर सकता है, शेल कमांड चला सकता है, वेब पर खोज सकता है, MCP सर्वर इस्तेमाल कर सकता है और scheduled jobs चला सकता है। नाम पर एक और बात। यह obot-platform/nanobot नहीं है, जो MCP एजेंट बनाने का एक Go framework है।

ज़रूरतें

• Python 3.11 या नया। python3 --version से जाँचें। अगर installer को यह न मिले, तो वह रुक जाता है, इसलिए ज़रूरत हो तो पहले Python इंस्टॉल करें।
• macOS 13 या नया। Apple silicon और Intel Mac के लिए पहले से बने packages में WebUI और terminal UI शामिल हैं।
• एक मॉडल प्रोवाइडर। Anthropic, OpenAI, OpenRouter और Ollama जैसे लोकल सर्वर, सब provider डॉक्स में हैं। जो प्रोवाइडर आप चुनें, उसकी API key इस्तेमाल करें।
• Git और Bun, पर सिर्फ़ तब जब आप source से इंस्टॉल करें। सामान्य इंस्टॉल को इनकी ज़रूरत नहीं।

इसे इंस्टॉल करें

README वाला ऑफ़िशियल एक-कमांड installer चलाएँ।

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

यह PyPI से nanobot-ai package इंस्टॉल करता है। यह system-wide pip इंस्टॉल से बचता है। यह सक्रिय virtual environment, uv, pipx, या आपकी होम के .nanobot फ़ोल्डर में अपना environment इस्तेमाल करता है। फिर यह वही कमांड प्रिंट करता है जो उसने इस्तेमाल की। कुछ बदले बिना प्लान देखने के लिए dry run फ़्लैग जोड़ें।

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

अगर आप पहले से uv इस्तेमाल करते हैं, तो यह वही काम करता है। फिर वर्ज़न जाँचें।

uv tool install nanobot-ai
nanobot --version

पहला रन और एक मॉडल

README पहले रन के लिए WebUI की सलाह देता है। यह 127.0.0.1 के पोर्ट 8765 पर खुलता है और सिर्फ़ इसी Mac पर सुनता है।

nanobot webui

Settings खोलें, फिर Models। एक प्रोवाइडर चुनें, उसकी API key पेस्ट करें, और एक मॉडल चुनें। फिर एक नया topic शुरू करें और Hello भेजें। कोई भी सामान्य जवाब मतलब प्रोवाइडर, मॉडल और gateway साथ में काम कर रहे हैं। टर्मिनल से एक बार का मैसेज भी यही जाँच करता है।

nanobot -m "Hello!"

सेटिंग्स आपकी होम के .nanobot फ़ोल्डर में config.json में सेव होती हैं। हमने यह इंस्टॉल अभी अपनी टेस्ट मशीन पर नहीं चलाया है। यहाँ की कमांड 2 अक्टूबर 2026 के nanobot README और डॉक्स से कॉपी की गई हैं।

इसे 24/7 चालू रखें

gateway वह हिस्सा है जो ऑनलाइन रहता है। यह चैट ऐप, scheduled jobs और मेमोरी का काम चलाता रहता है। यह कमांड टर्मिनल बंद करने के बाद भी इसे चालू रखती है।

nanobot gateway --background

यह रीबूट के बाद नहीं बचता। उसके लिए deployment डॉक्स एक LaunchAgent इंस्टॉल करते हैं। पहले WebUI में मॉडल सेटअप पूरा करें। फिर सर्विस फ़ाइल का preview देखें और उसे इंस्टॉल करें।

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

यह आपकी होम Library के LaunchAgents फ़ोल्डर में ai.nanobot.gateway.plist लिखता है। यह gateway को उसी Python से शुरू करता है जिससे nanobot इंस्टॉल हुआ था। लॉग .nanobot के अंदर logs फ़ोल्डर में जाते हैं। अगर यह address already in use के साथ फ़ेल हो, तो पहले हाथ से शुरू किया gateway बंद करें।

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

gateway, config.json सिर्फ़ शुरू होते समय पढ़ता है। हर config बदलाव के बाद इसे रीस्टार्ट करें।

LaunchAgent सिर्फ़ तब चलता है जब कोई यूज़र लॉग इन हो। बिना निगरानी वाले Mac पर, nanobot चलाने वाले अकाउंट के लिए automatic login चालू करें। फिर Mac को स्लीप होने से रोकें, क्योंकि स्लीप gateway और उसके scheduled jobs को रोक देता है।

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

ज़्यादा जानकारी Mac के स्लीप होने पर क्या होता है और हमेशा चालू Mac की गाइड में है।

सुरक्षा से जुड़ी बातें

• production के लिए डॉक्स दो सेटिंग्स साथ में करने की सलाह देते हैं। restrictToWorkspace को true करें, और macOS पर tools.exec.sandbox को seatbelt करें। Seatbelt शेल कमांड को workspace फ़ोल्डर तक सीमित करता है।
• इनमें से कोई भी सेटिंग नेटवर्क एक्सेस को सीमित नहीं करती। secrets को workspace के बाहर रखें।
• WebUI और gateway की health check डिफ़ॉल्ट रूप से 127.0.0.1 पर सुनते हैं। इन्हें सिर्फ़ इसी Mac तक रहने दें।
• चैट ऐप पर अनजान भेजने वालों को जवाब नहीं, एक pairing कोड मिलता है। आप उन्हें /pairing approve और उनके कोड से मंज़ूर करते हैं।
• डॉक्स config.json में सीधे keys रखने के बजाय API keys के लिए environment variable references की सलाह देते हैं। जो भी करें, .nanobot फ़ोल्डर को पासवर्ड फ़ाइल की तरह मानें।

सबसे आसान सुरक्षा ऐसा Mac है जिस पर आपका और कुछ न हो। अगर एजेंट कुछ अजीब करे, तो नुकसान उसी मशीन पर रुक जाता है।

MacRun Mac पर इसे चलाना

हमारा एजेंट प्लान एक डेडिकेटेड Mac mini है, जो कभी स्लीप नहीं होता। यह न्यू जर्सी में हमारी अपनी निजी सुविधा में रखा है। रीबूट के बाद इसका लॉग इन सेशन अपने आप लौट आता है, इसलिए nanobot का LaunchAgent फिर से शुरू होता है। Claude Code और Codex पहले से इंस्टॉल आते हैं। nanobot नहीं आता। आप इसे खुद इंस्टॉल करते हैं, ज़रूरत हो तो Python के साथ, क्योंकि आपके पास पूरे एडमिन अधिकार हैं।

आप हमारे ब्राउज़र डेस्कटॉप के ज़रिए Mac के अपने ब्राउज़र में WebUI खोल सकते हैं। एजेंट प्लान $169 प्रति माह है। MacRun कोई API key नहीं बेचता। अपने मॉडल प्रोवाइडर की API key इस्तेमाल करें, जो अपनी शर्तों पर इस्तेमाल का बिल करता है।

जब आपको MacRun की ज़रूरत नहीं

nanobot छोटा है और लगभग कहीं भी चलता है। डॉक्स में Linux services, Docker और one click Render deploy हैं। अगर आपको macOS से कुछ नहीं चाहिए, तो इनमें से कोई भी Mac से सस्ता है। और अगर आपके पास पहले से ऐसा Mac है जो चालू और लॉग इन रहता है, तो उसे इस्तेमाल करें।

MacRun हमारी acceptable use policy के तहत डेवलपर काम के लिए है। जो nanobot issues छाँटता है या रात में रिपॉज़िटरी के काम करता है, वह ठीक है। जो आपका निजी inbox चलाता है, वह नहीं। प्लान की तुलना के लिए एजेंट Mac पेज देखें।