Crush सेटअप: API Key, Base URL और मॉडल

crushrc में openai-compat provider से Crush को BetterToken से जोड़ें। GPT मॉडल के साथ macOS परीक्षण में Crush 0.98.2 ने cold-start के तीनों टेक्स्ट अनुरोध और /v1/chat/completions से एक फ़ाइल-पठन tool call पूरा किया।

मुख्य सेटिंग्स

फ़ील्ड	मान
API Key	--api-key से दी गई BetterToken API Key
Base URL	--base-url से दिया https://bettertoken.ai/v1
मॉडल	bettertoken/YOUR_MODEL_ID
प्रोवाइडर का प्रकार	openai-compat
कॉन्फ़िगरेशन फ़ाइल	~/.config/crush/crushrc

आवश्यकताएं

• नीचे दिए इंस्टॉलेशन command के लिए Homebrew
• BetterToken API Key: रजिस्टर करें और प्राप्त करें
• model plaza से Model ID और उसकी context limit

इंस्टॉल करें

आधिकारिक Crush repository का Homebrew command इस्तेमाल करें:

brew install charmbracelet/tap/crush
crush --version

मैन्युअल सेटअप

जिस terminal में Crush चलाएंगे, उसमें BetterToken API Key सेट करें:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

अनुशंसित Bash configuration format का उपयोग करके ~/.config/crush/crushrc बनाएं। हर YOUR_MODEL_ID बदलें और --context-window को चुने गए मॉडल की दर्ज सीमा पर सेट करें। उदाहरण का 128000 client में घोषित मान है, BetterToken मॉडल की सत्यापित सीमा नहीं।

provider add bettertoken --type openai-compat --base-url "https://bettertoken.ai/v1" --api-key "$BETTERTOKEN_API_KEY"
model add bettertoken/YOUR_MODEL_ID --name "YOUR_MODEL_ID" --context-window 128000
model large bettertoken/YOUR_MODEL_ID
model small bettertoken/YOUR_MODEL_ID
permissions allow view

ये commands crushrc में सहेजें; शुरू होने पर Crush इन्हें चलाता है। permissions allow view फ़ाइल देखने वाले tool की अनुमति देता है। मूल परियोजना में पुराने JSON कॉन्फ़िगरेशन प्रारूप को अप्रचलित घोषित किया गया है, लेकिन अब भी काम करता है; परीक्षण में उसका टेक्स्ट अनुरोध भी सफल रहा।

कनेक्शन जांचें

उसी terminal से अपने project में चलाएं:

crush run "Reply with only: OK"

अंतिम उत्तर OK है या नहीं जांचें। फ़ाइल एक्सेस के लिए Crush से अपने project की किसी ज्ञात फ़ाइल को पढ़ने को कहें और view tool result तथा अंतिम उत्तर, दोनों जांचें।

मॉडल बदलें

model add से दूसरा मॉडल जोड़ें, crushrc में model large और model small चयन अपडेट करें और नया run शुरू करें।

सामान्य त्रुटियां

समस्या	क्या जांचें
No providers configured	उपयोगी provider लोड न होने पर Crush अनुरोध भेजने से पहले यह बताता है। crushrc का स्थान और सामग्री जांचें; project configuration इसे override कर सकती है।
401	Crush शुरू करने से पहले BETTERTOKEN_API_KEY export करें और उसका मान जांचें।
कॉन्फ़िगरेशन में स्पष्ट मॉडल नहीं हैं	केवल provider कॉन्फ़िगर होने पर परीक्षण में Crush ने /v1/models से मॉडल खोजे। स्पष्ट model add entries से इस उदाहरण वाला मॉडल नामित किया जा सकता है।
फ़ाइल एक्सेस के लिए अनुमति चाहिए	लोड किए गए configuration में permissions allow view जांचें।

संबंधित गाइड

• समर्थित टूल की तुलना
• API त्रुटियां और rate limits
• Crush कॉन्फ़िगरेशन संदर्भ

तकनीकी विवरण

परीक्षण किए गए openai-compat provider ने generation अनुरोध /v1/chat/completions पर भेजे। स्पष्ट model entries न होने पर मॉडल खोजने के लिए /v1/models उपयोग हुआ।