[{"data":1,"prerenderedAt":396},["ShallowReactive",2],{"navigation_docs_en":3,"-en-quick-start-macos-install":59,"-en-quick-start-macos-install-surround":391},[4,25,42],{"title":5,"path":6,"stem":7,"children":8,"page":24},"Quick Start","/en/quick-start","en/1.quick-start",[9,12,16,20],{"title":5,"path":10,"stem":11},"/en/quick-start/overview","en/1.quick-start/0.overview",{"title":13,"path":14,"stem":15},"Install and Download","/en/quick-start/install","en/1.quick-start/1.install",{"title":17,"path":18,"stem":19},"First Launch and First Message","/en/quick-start/first-run","en/1.quick-start/2.first-run",{"title":21,"path":22,"stem":23},"macOS Install Guide","/en/quick-start/macos-install","en/1.quick-start/3.macos-install",false,{"title":26,"path":27,"stem":28,"children":29,"page":24},"Manual","/en/manual","en/2.manual",[30,34,38],{"title":31,"path":32,"stem":33},"User Manual","/en/manual/overview","en/2.manual/0.overview",{"title":35,"path":36,"stem":37},"Provider and Model Configuration","/en/manual/providers","en/2.manual/1.providers",{"title":39,"path":40,"stem":41},"Conversation and Context Management","/en/manual/chat-and-context","en/2.manual/2.chat-and-context",{"title":43,"path":44,"stem":45,"children":46,"page":24},"Faq","/en/faq","en/3.faq",[47,51,55],{"title":48,"path":49,"stem":50},"FAQ","/en/faq/overview","en/3.faq/0.overview",{"title":52,"path":53,"stem":54},"Privacy Policy","/en/faq/privacy-policy","en/3.faq/1.privacy-policy",{"title":56,"path":57,"stem":58},"Account Deletion","/en/faq/account-deletion","en/3.faq/2.account-deletion",{"id":60,"title":21,"body":61,"description":384,"extension":385,"links":386,"meta":387,"navigation":388,"path":22,"seo":389,"stem":23,"__hash__":390},"docs_en/en/1.quick-start/3.macos-install.md",{"type":62,"value":63,"toc":376},"minimark",[64,68,72,78,81,86,93,98,101,148,151,155,162,215,224,227,242,246,249,264,275,282,296,300,314,318,329,332,340,343,347,350,365,372],[65,66,21],"h1",{"id":67},"macos-install-guide",[69,70,71],"p",{},"BotHub is not yet signed with an Apple Developer ID, so macOS may show one of these dialogs on first launch:",[73,74,75],"blockquote",{},[69,76,77],{},"\"BotHub.app\" is damaged and can't be opened. You should move it to the Trash.",[69,79,80],{},"Or:",[73,82,83],{},[69,84,85],{},"\"BotHub.app\" can't be opened because Apple cannot check it for malicious software.",[69,87,88,92],{},[89,90,91],"strong",{},"The app is not actually damaged or malicious",". This is just macOS Gatekeeper's default protection for unsigned apps. BotHub's source is open for inspection — it's safe to bypass with any of the methods below.",[94,95,97],"h2",{"id":96},"method-a-allow-via-system-settings-recommended-easiest","Method A: Allow via System Settings (recommended, easiest)",[69,99,100],{},"Works on macOS 13 Ventura and later.",[102,103,104,113,120,126,135,140,143],"ol",{},[105,106,107,108,112],"li",{},"Double-click ",[109,110,111],"code",{},"BotHub.app"," once to trigger the \"damaged\" dialog",[105,114,115,116,119],{},"Click ",[89,117,118],{},"Cancel"," on the dialog (do NOT click \"Move to Trash\")",[105,121,122,123],{},"Open ",[89,124,125],{},"System Settings → Privacy & Security",[105,127,128,129,132],{},"Scroll to the bottom. You should see:",[130,131],"br",{},[89,133,134],{},"\"BotHub.app was blocked from use because it is not from an identified developer\"",[105,136,115,137],{},[89,138,139],{},"Open Anyway",[105,141,142],{},"Authenticate with your password or Touch ID",[105,144,107,145,147],{},[109,146,111],{}," again — it will open normally",[69,149,150],{},"After this, every future launch works without prompts.",[94,152,154],{"id":153},"method-b-terminal-command-when-method-a-fails","Method B: Terminal command (when Method A fails)",[69,156,157,158,161],{},"If the \"Open Anyway\" button never shows up, or clicking it still fails, open ",[89,159,160],{},"Terminal.app"," and run:",[163,164,169],"pre",{"className":165,"code":166,"language":167,"meta":168,"style":168},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","sudo xattr -rd com.apple.quarantine /Applications/BotHub.app\nsudo codesign --force --deep --sign - /Applications/BotHub.app\n","bash","",[109,170,171,193],{"__ignoreMap":168},[172,173,176,180,184,187,190],"span",{"class":174,"line":175},"line",1,[172,177,179],{"class":178},"sBMFI","sudo",[172,181,183],{"class":182},"sfazB"," xattr",[172,185,186],{"class":182}," -rd",[172,188,189],{"class":182}," com.apple.quarantine",[172,191,192],{"class":182}," /Applications/BotHub.app\n",[172,194,196,198,201,204,207,210,213],{"class":174,"line":195},2,[172,197,179],{"class":178},[172,199,200],{"class":182}," codesign",[172,202,203],{"class":182}," --force",[172,205,206],{"class":182}," --deep",[172,208,209],{"class":182}," --sign",[172,211,212],{"class":182}," -",[172,214,192],{"class":182},[216,217,218,221],"ul",{},[105,219,220],{},"Line 1: removes the macOS quarantine flag added to downloaded files",[105,222,223],{},"Line 2: applies an ad-hoc (local, empty-identity) signature so Gatekeeper accepts the bundle",[69,225,226],{},"You'll need to enter your login password. Then launch BotHub normally.",[69,228,229,230,233,234,237,238,241],{},"If line 1 reports ",[109,231,232],{},"Operation not permitted",", your terminal lacks ",[89,235,236],{},"Full Disk Access",". Go to ",[89,239,240],{},"System Settings → Privacy & Security → Full Disk Access"," and add your terminal app, then restart it and retry.",[94,243,245],{"id":244},"method-c-disable-gatekeeper-last-resort-not-recommended-long-term","Method C: Disable Gatekeeper (last resort, not recommended long-term)",[69,247,248],{},"If neither A nor B works, or if you regularly install unsigned apps, run:",[163,250,252],{"className":165,"code":251,"language":167,"meta":168,"style":168},"sudo spctl --master-disable\n",[109,253,254],{"__ignoreMap":168},[172,255,256,258,261],{"class":174,"line":175},[172,257,179],{"class":178},[172,259,260],{"class":182}," spctl",[172,262,263],{"class":182}," --master-disable\n",[69,265,266,267,270,271,274],{},"Then go to ",[89,268,269],{},"System Settings → Privacy & Security → Allow applications downloaded from"," and pick the new ",[89,272,273],{},"Anywhere"," option.",[69,276,277,278,281],{},"All unsigned apps will now launch directly by double-click. ",[89,279,280],{},"This lowers your system's security posture — use only if you understand the trade-off."," To re-enable:",[163,283,285],{"className":165,"code":284,"language":167,"meta":168,"style":168},"sudo spctl --master-enable\n",[109,286,287],{"__ignoreMap":168},[172,288,289,291,293],{"class":174,"line":175},[172,290,179],{"class":178},[172,292,260],{"class":182},[172,294,295],{"class":182}," --master-enable\n",[94,297,299],{"id":298},"install-location","Install location",[69,301,302,303,305,306,309,310,313],{},"We recommend dragging ",[109,304,111],{}," into ",[89,307,308],{},"Applications",". Other locations work too, but Spotlight search and Dock pinning are easier from ",[109,311,312],{},"/Applications",".",[94,315,317],{"id":316},"uninstall","Uninstall",[216,319,320,326],{},[105,321,322,323,325],{},"Option 1: Open Applications in Finder and drag ",[109,324,111],{}," to Trash",[105,327,328],{},"Option 2: Use a tool like AppCleaner to also remove preferences and caches",[69,330,331],{},"User data lives at:",[163,333,338],{"className":334,"code":336,"language":337},[335],"language-text","~/Library/Application Support/BotHub/\n","text",[109,339,336],{"__ignoreMap":168},[69,341,342],{},"Remove this directory for a complete uninstall.",[94,344,346],{"id":345},"still-cant-open","Still can't open?",[69,348,349],{},"If all three methods fail, the download may be corrupted. Try:",[102,351,352,359,362],{},[105,353,354,355,358],{},"Re-download the ",[109,356,357],{},".dmg"," from the official site",[105,360,361],{},"Verify SHA256 against the release page (if listed)",[105,363,364],{},"Make sure you downloaded the right architecture (arm64 for Apple Silicon, x86_64 for Intel)",[69,366,367,368,371],{},"If the problem persists, check the ",[369,370,48],"a",{"href":49}," or open an issue.",[373,374,375],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":168,"searchDepth":195,"depth":195,"links":377},[378,379,380,381,382,383],{"id":96,"depth":195,"text":97},{"id":153,"depth":195,"text":154},{"id":244,"depth":195,"text":245},{"id":298,"depth":195,"text":299},{"id":316,"depth":195,"text":317},{"id":345,"depth":195,"text":346},"If macOS blocks BotHub on first launch with \"is damaged\", here is how to work around it.","md",null,{},true,{"title":21,"description":384},"Urun0dyWKafIAZEHZUQN4oVONRGurv6p_coJzT1JPLI",[392,394],{"title":17,"path":18,"stem":19,"description":393},"Configure a provider and send your first message.",{"title":31,"path":32,"stem":33,"description":395},"Feature guides and configuration.",1782456937959]