Zaru CLI: यह क्या करता है और इसे कैसे इंस्टॉल करें, इसके README से

अन्य भाषाओं में: English, Español, Português, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano · हिन्दी में सभी गाइड

प्रकटीकरण: Zaru को 100monkeys AI, Inc. बनाती है, इसलिए इस गाइड को बनाने वाले का विवरण मानकर पढ़ें। इसका मसौदा हमारे एक AI एजेंट ने main ब्रांच पर zaru-cli README से तैयार किया, जिसे 28 अक्टूबर 2026 को पढ़ा गया, और कंपनी ने इसकी समीक्षा की; यह हिन्दी संस्करण मूल अंग्रेज़ी गाइड का अनुवाद है। नीचे की हर कमांड उसी README से कॉपी की गई है, और उद्धरण अंग्रेज़ी में हैं, अनुवाद साथ में। जहाँ README किसी सवाल का जवाब नहीं देता, वहाँ हम अंदाज़ा लगाने के बजाय यही कहते हैं।

एक पंक्ति में README: "Zaru is an AI assistant that works in your terminal. You give it a task, it asks a language model, and it runs the tools the model asks for: it reads and edits files, runs commands and fetches web pages, asking your permission first." (Zaru एक AI असिस्टेंट है जो आपके टर्मिनल में काम करता है। आप उसे एक टास्क देते हैं, वह एक लैंग्वेज मॉडल से पूछता है, और मॉडल जो टूल माँगे उन्हें चलाता है: फ़ाइलें पढ़ता और बदलता है, कमांड चलाता है और वेब पेज लाता है, पहले आपकी अनुमति लेकर।) हर कदम एक सादे टेक्स्ट ट्रांसक्रिप्ट में दर्ज होता है जिसे आप cat से पढ़ सकते हैं।

यह जानता है कि यह किस चरण में है

README साफ़ कहता है: "It is pre-alpha: there are no releases and no packages, you build it from source, and commands, files and settings can change without notice." (यह प्री-अल्फ़ा है: न कोई रिलीज़ है, न पैकेज, आप इसे सोर्स से बिल्ड करते हैं, और कमांड, फ़ाइलें और सेटिंग्स बिना सूचना के बदल सकती हैं।) यह Apache-2.0 के तहत ओपन सोर्स है। यह सैंडबॉक्स भी नहीं है: "Zaru acts on your machine with your user account's permissions." (Zaru आपकी मशीन पर आपके यूज़र अकाउंट की अनुमतियों से काम करता है।) किसी अहम चीज़ पर इसे लगाने से पहले README का Safety सेक्शन पढ़ें।

कदम 1. ज़रूरतें जाँचें

Linux। "does not build on Windows" (Windows पर बिल्ड नहीं होता), और macOS "is not tested" (टेस्ट नहीं किया गया)।
Rust 1.98.1, rust-toolchain.toml में तय; पहले बिल्ड पर rustup इसे इंस्टॉल करता है।
एक C कंपाइलर (cc) और पहले बिल्ड के लिए crates.io तक नेटवर्क एक्सेस।
एक मॉडल: Google Gemini API की, एक Ollama सर्वर, या OpenAI-संगत chat completions API वाला कोई भी सर्वर।

कदम 2. बिल्ड और इंस्टॉल करें

git clone https://github.com/100monkeys-ai/zaru-cli.git
cd zaru-cli
cargo install --path crates/zaru-cli --locked

इससे zaru ~/.cargo/bin में आ जाता है। यह काम करता है या नहीं, यह देखने के लिए zaru --version चलाएँ।

कदम 3. मॉडल चुनें

"Zaru has no default model." (Zaru का कोई डिफ़ॉल्ट मॉडल नहीं है।) ~/.zaru/config.toml आप ख़ुद बनाते हैं। Gemini के लिए, की सहेजें (यह स्टैंडर्ड इनपुट से पढ़ी जाती है: पेस्ट करें, Enter दबाएँ, फिर Ctrl-D) और मॉडल का नाम दें:

zaru providers keys add gemini

[model]
default = "gemini-3.6-flash"

सहेजी गई कीज़ एक ऐसी की से एन्क्रिप्ट होती हैं जो ऑपरेटिंग सिस्टम के कीरिंग में रखी जाती है। बिना कीरिंग वाली मशीन पर, जैसे सर्वर, WSL या कंटेनर, ZARU_CREDENTIAL_KEY को 64 छोटे अक्षरों वाले हेक्स कैरेक्टर पर सेट करें और वह मान सँभालकर रखें, क्योंकि "without it, the keys you stored cannot be read again." (इसके बिना, आपकी सहेजी कीज़ फिर से पढ़ी नहीं जा सकतीं।) Ollama के लिए की की ज़रूरत नहीं: [provider.default] के नीचे kind = "ollama" लिखें और Zaru http://localhost:11434 से जुड़ता है। OpenAI-संगत सर्वर के लिए kind = "openai-compatible" और उसका endpoint लिखें, और अगर सर्वर की मॉडल सूची विंडो नहीं बताती तो context_tokens भी।

कदम 4. एक टास्क चलाएँ

zaru "read src/main.rs and tell me what it does"

इसे उसी डायरेक्टरी से चलाएँ जहाँ आप चाहते हैं कि यह काम करे। यह "सैंडबॉक्स नहीं है" वाली सूचना, हर टूल कॉल और उसने क्या किया, जवाब, "counted by the provider" (प्रोवाइडर द्वारा गिने गए) टोकन, और वैलिडेटर के बारे में एक नोट दिखाता है। बिना आर्ग्युमेंट के zaru इसकी जगह एक इंटरैक्टिव सेशन खोलता है; zaru --continue मौजूदा डायरेक्टरी का पिछला सेशन फिर खोलता है।

कदम 5. अनुमति के सवालों का जवाब दें

फ़ाइल लिखने, उसे बदलने, कमांड चलाने या पेज लाने से पहले Zaru दिखाता है कि कॉल क्या करेगी और पूछता है [y/N/a ...]। y एक बार अनुमति देता है, a सेशन भर के लिए उसी कॉल की अनुमति देता है, और N, Enter या Esc मना करते हैं जबकि टास्क चलता रहता है। Ctrl-C पूरा टास्क रोक देता है। पेज लाते समय पूरा URL दिखता है, "because a URL can carry data off your machine" (क्योंकि URL आपकी मशीन से डेटा बाहर ले जा सकता है)। पूछने के लिए टर्मिनल न हो तो कॉल अस्वीकार होती है। डिफ़ॉल्ट मोड ask है; allow आपकी अलाउलिस्ट वाली चीज़ें बिना पूछे करता है, और yolo कुछ नहीं पूछता, जिसे README "only for a directory and a task you trust entirely." (सिर्फ़ ऐसी डायरेक्टरी और टास्क के लिए जिन पर आपको पूरा भरोसा हो) इस्तेमाल करने को कहता है।

कदम 6. ट्रांसक्रिप्ट पढ़ें

zaru sessions list
cat ~/.zaru/sessions/<id>/transcript.jsonl

हर पंक्ति में एक JSON ऑब्जेक्ट: आपका टास्क, मॉडल का हर जवाब और उसकी माँगी टूल कॉल, हर कॉल को अनुमति मिली या नहीं, उसने क्या लौटाया ("exactly as the model was given it", ठीक वैसा जैसा मॉडल को दिया गया) और जवाब। कुछ भी लिखे जाने से पहले सहेजी गई कीज़ और टोकन एक प्लेसहोल्डर से बदल दिए जाते हैं।

कदम 7. वैलिडेटर जोड़ें

zaru init एक नमूना ./zaru.toml लिखता है। वैलिडेटर एक कमांड है जो मॉडल के काम की जाँच करती है:

[[validator]]
name = "test"
run = "cargo test"
expect = "exit-zero"

वैलिडेटर घोषित होने पर टास्क एक लूप बन जाता है: मॉडल कुछ बदलता है, वैलिडेटर चलते हैं और विफलता मॉडल के पास लौटती है, जब तक सब पास न हो जाएँ या runtime.max_iterations न पहुँच जाए। वैलिडेटर आपकी मंज़ूरी के बाद ही चलते हैं, और बदलने पर आपसे फिर पूछा जाता है; "the permission mode does not skip it." (परमिशन मोड इस सवाल को नहीं छोड़ता।)

यह अभी क्या नहीं करता

सिर्फ़ तीन तरह के प्रोवाइडर काम करते हैं: gemini, ollama और openai-compatible। "anthropic and aegis are recognised but have no client." (anthropic और aegis पहचाने जाते हैं पर उनका कोई क्लाइंट नहीं है।)
रनटाइम टियर contained और linked "can be selected but are not built yet" (चुने जा सकते हैं पर अभी बने नहीं हैं): हर टियर पर टूल कॉल सीधे आपकी मशीन पर चलती हैं।
zaru learned और zaru inbox प्लेसहोल्डर हैं।

README क्या खुला छोड़ता है

पहली रिलीज़ या पैकेज कब आएगा। README सिर्फ़ इतना कहता है कि अभी कोई नहीं है।
CLI सेशन ask.myzaru.com के वेब ऐप की बातचीत से कैसे जुड़ते हैं। README Carbon Forge से कनेक्शन (zaru notes tokens add) बताता है, पर वेब ऐप नहीं।
Gemini के और कौन-से मॉडल नाम काम करते हैं। README एक ही दिखाता है।