#jdZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZddlmZddlmZddlmZddlmZejeZe ejjZd Zd e eefd e eeffd Z d e eefd e eeffd Z!d e eefdeded dfdZ"ded e#fdZ$dggdgdgdgdgdddggdgdgdgdgdgdgddZ%d e eefd efd Z&d e eefd!ed dfd"Z'dd#l(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3dd$l4m5Z5m6Z6d%efd&Z7dd'l8m9Z9m:Z:m;Z;mZ>d e#fd)Z?dd*edzd dfd+Z@dd-ed.ed/e#d efd0ZAejBd1ZCd2ed efd3ZDdd-ed4eEd.eFd5edzd eFf d6ZGdd-ed4eEd.eFd5edzd eFf d7ZHdd-ed.e#d e#fd9ZIdd%ed:eEd;eEd eEfd<ZJd=eKfd>ZLd eKfd?ZMd eKfd@ZNd,dAd eKdBe#fdCZOd e#fdDZPd e#fdEZQd e#fdFZRd e#fdGZSd e#fdHZTd eKfdIZUd eKfdJZVd eKfdKZWd eKfdLZXd eKfdMZYejBdNZZdOed e#fdPZ[dQZ\d edzfdRZ]d edzfdSZ^dTZ_dUZ`dVZadWZbdXZcdYZddZZed eKfd[Zfdd eKd\e#fd]Zgd eKd e#fd^Zhd_ed efd`Zid eKdaed e efdbZjd eKdaed_ed e#fdcZkeeddz dez dfz dgz dhz ZldiZmdjdkdldmdndodpdqdrds ZndteKfduZodve d e#fdwZpdxdyeOfdzd{eVfd|d}eWfd~deffddegfddeYfgZqd eKd dfdZrdZsd eKde#fdZtd eKfdZudS)u Interactive setup wizard for Hermes Agent. Modular wizard with independently-runnable sections: 1. Model & Provider — choose your AI provider and model 2. Terminal Backend — where your agent runs commands 3. Agent Settings — iterations, compression, session reset 4. Messaging Platforms — connect Telegram, Discord, etc. 5. Tools — configure TTS, web search, image generation, etc. Config files are stored in ~/.hermes/ for easy access. N)Path)OptionalDictAny)get_nous_subscription_features)managed_nous_tools_enabled)base_url_hostname)get_optional_skills_dirz*https://hermes-agent.nousresearch.com/docsconfigreturnc|d}t|trt|St|tr*|rd|iSiS)Nmodeldefault)get isinstancedictstrstrip)r current_models 5/home/ubuntu/.hermes/hermes-agent/hermes_cli/setup.py_model_config_dictr$stJJw''M-&&#M"""-%%2-*=*=*?*?2=..0011 Icx|d}t|trt|niSNcredential_pool_strategiesrrr)r strategiess r_get_credential_pool_strategiesr-s6899J)*d;; C4   Crproviderstrategyc@|sdSt|}|||<||d<dSr)r)r rr rs r_set_credential_pool_strategyr"2s7 088J#Jx+5F '(((rcv|r|dkrdS|dkrdSddlm}||}|sdS|jdvS)NcustomF openrouterTrPROVIDER_REGISTRY>api_keyoauth_device_code)hermes_cli.authr'r auth_type)rr'pconfigs r"_supports_same_provider_pool_setupr-:sj x8++u<t111111##H--G u   @ @@r copilot-acp) gpt-5.4z gpt-5.4-miniz gpt-5-mini gpt-5.3-codexz gpt-5.2-codexzgpt-4.1zgpt-4oz gpt-4o-minizclaude-opus-4.6zclaude-sonnet-4.6zclaude-sonnet-4.5zclaude-haiku-4.5zgemini-2.5-pro)zgemini-3.1-pro-previewzgemini-3-pro-previewzgemini-3-flash-previewzgemini-3.1-flash-lite-preview)glm-5.1glm-5zglm-4.7zglm-4.5z glm-4.5-flash) kimi-k2.6 kimi-k2.5zkimi-k2-thinkingzkimi-k2-turbo-previewzstep-3.5-flashzstep-3.5-flash-2603)ztrinity-large-thinkingztrinity-large-previewz trinity-mini)z MiniMax-M2.7z MiniMax-M2.5z MiniMax-M2.1z MiniMax-M2)zanthropic/claude-opus-4.6zanthropic/claude-sonnet-4.6zopenai/gpt-5.4zgoogle/gemini-3-pro-previewzgoogle/gemini-3-flash-preview)r/r0zclaude-sonnet-4-6zgemini-3-flashr2r4 minimax-m2.7) r3r4r1r2z mimo-v2.5-proz mimo-v2.5z mimo-v2-proz mimo-v2-omnir5z minimax-m2.5z qwen3.7-maxz qwen3.6-plusz qwen3.5-plus)zQwen/Qwen3.5-397B-A17Bz"Qwen/Qwen3-235B-A22B-Thinking-2507z#Qwen/Qwen3-Coder-480B-A35B-Instructzdeepseek-ai/DeepSeek-R1-0528zdeepseek-ai/DeepSeek-V3.2zmoonshotai/Kimi-K2.5)r.copilotgeminizaiz kimi-codingzkimi-coding-cnstepfunarceeminimaxz minimax-cnkilocodez opencode-zenz opencode-go huggingfacec|d}t|trHt|dpdSdS)Nagentreasoning_effort)rrrrrlower)r agent_cfgs r_current_reasoning_effortrDrsc 7##I)T""L9==!344:;;AACCIIKKK 2reffortcr|d}t|tsi}||d<||d<dS)Nr?r@r)r rErCs r_set_reasoning_effortrGysD 7##I i & &$ #w$*I !!!r) cfg_getDEFAULT_CONFIGget_hermes_homeget_config_path get_env_path load_config save_configsave_env_valueremove_env_value get_env_valueensure_hermes_home)Colorscolortitlectttd|tjtjdS)zPrint a section header.u◆ N)printrTrSCYANBOLD)rUs r print_headerrZs5 GGG %u V[ 9 9:::::r) print_error print_info print_success print_warning)masked_secret_promptcttdd}|dS t|S#t$rYdSwxYw)z;Return True when stdin looks like a usable interactive TTY.stdinNF)getattrsysboolisatty Exception)ras ris_interactive_stdinrgsZ C$ ' 'E }uELLNN### uus = A  A reasonctttdtjtjt|rt |t dtt dt dt dt dtt dt dtd S) z8Print guidance for headless/non-interactive setup flows.u)⚕ Hermes Setup — Non-interactive modez+The interactive wizard cannot be used here.z@Configure Hermes using environment variables or config commands:z) hermes config set model.provider customz; hermes config set model.base_url http://localhost:8080/v1z1 hermes config set model.default your-model-namez?Or set OPENROUTER_API_KEY / OPENAI_API_KEY in your environment.zERun 'hermes setup' in an interactive terminal to use the full wizard.N)rWrTrSrXrYr\)rhs r#print_noninteractive_setup_guidancerjs GGG %;V[&+ V VWWW GGG 6<=== GGGQRRR:;;;LMMMBCCC GGGPQQQVWWW GGGGGrFquestionrpasswordc|r |d|d}n|d} |r(tt|tj}n't t|tj}t |}|p|pdS#ttf$r&ttj dYdSwxYw)z'Prompt for input with optional default. []: : rAN) r_rTrSYELLOWinput_sanitize_pasted_inputrKeyboardInterruptEOFErrorrWrcexit)rkrrldisplayvaluecleaneds rpromptr{s"-----///   9(w )F)FGGEE%7788E(//}}/'/R/ x (   sA7B 3CCz\x1b\[\s*200~|\x1b\[\s*201~rycjt|tr|s|Std|S)z@Strip terminal bracketed-paste control markers from pasted text.rA)rr_BRACKETED_PASTE_PATTERNsub)rys rrtrts6 eS ! ! # ' 'E 2 22rchoices descriptionc.ddlm}||||d|S)z?Single-select menu using curses. Delegates to curses_radiolist.r)curses_radiolist)selectedcancel_returnsr)hermes_cli.curses_uir)rkrrrrs r_curses_prompt_choicers2555555  HgPR`k l l llrc t||||}|dkr5||krtdt|St|Stt|tjt |D]X\}}||krdnd}||kr.ttd|d|tjCtd|d|Ytd|d zd  ttd t|d |d zdtj }|s|St|d z }d|cxkrt|krnn|Stdt|nS#t$rtdYn8ttf$r%tt!jd YnwxYw)zPrompt for a choice from a list with arrow key navigation. Escape keeps the current default (skips the question). Ctrl+C exits the wizard. )rrz Skipped (keeping current)u●u○  z Enter for default (rqz) Ctrl+C to exitTz Select [1-z] (z): z$Please enter a number between 1 and zPlease enter a number)rr\rWrTrSrr enumerateGREENrslenDIMintr[ ValueErrorrurvrcrw) rkrrridxichoicemarkerrys r prompt_choicers+ '7 T T TC axx '>> 4 5 5 5 GGGN   %&- ( ()))w''** 6w,,E << %.V..f.. == > > > > (v(((( ) ) ) )Ew{EEEFFF FS\\FFgkFFF SSE e**q.CC&&&&#g,,&&&&& Ms7||MM N N N N 1 1 1 / 0 0 0 0 0!8,    GGG HQKKKKK s%6AF 80F )F G$2GGTch|rdnd} tt|d|dtj}n9#t tf$r%ttj dYnwxYw|s|S|dvrdS|dvrd Std ) z=Prompt for yes/no. Ctrl+C exits, empty input returns default.zY/nzy/NTrnrorq>yyes>nnoFzPlease enter 'y' or 'n') rsrTrSrrrrBrurvrWrcrwr[)rkr default_strrys r prompt_yes_nors"-%%K/ ex;;;;;;V]KKLL E "8,    GGG HQKKKKK  N L 4 K  5-...#/sAA3BBitems pre_selectedc|g}ddlm}|||t|t|}t|S)u Display a multi-select checklist and return the indices of selected items. Each item in `items` is a display string. `pre_selected` is a list of indices that should be checked by default. A "Continue →" option is appended at the end — the user toggles items with Space and confirms with Enter on "Continue →". Falls back to a numbered toggle interface when curses is unavailable. Returns: List of selected indices (not including the Continue option). Nr)curses_checklist)r)rrsetsorted)rUrrrchosens rprompt_checklistr+sb 555555     L<(( F &>>rvarc t|dg}d|dd}t|dkr|dt|dz dz }ttt d|d|d d t jt|rtd ||d rtd |d t|dr/td|d|d d}n,td|d|d }|r't|d |tddStddS)zEDisplay a nicely formatted API key input screen for a single env var.tools, Nz, +z more ─── rname ───z Enables: urlz Get your key at: rlrr{Trl ✓ Savedz/ Skipped (configure later with 'hermes setup')) rjoinrrWrTrSrXr\r{rOr]r^)rr tools_strrys r_prompt_api_keyrHs GGGR E %)$$I 5zzA~~03u::>0000  GGG %Nsww}c&kBBNNNPVP[ \ \]]] GGG.,,,--- wwu~~75U55666 GGG wwz>n~|d?krc t2jd?du}n#t $rd}YnwxYw|r|d@n+|dAn|dB|jj r|dCnwt/|dDdEdFkr8|jjr|dGn@|dHn*t=r|jr|dItdJr|dK ddLl m!}|dMpi}|"dNs|"dOr|dPn#t $rYnwxYwtdQr|dRn|dS|dT|dU|dVtGdW|D}tI|}tK|dX|dYt|D]\}}}|r.tdZtMd[tNj(d\|6tdZtMd]tNj)d\|d\tMd^|d tNj*td_|D}|r>tWd`ddal,m-}tWdb|dcttttMddtNj(ttMdetNj(ttMdftNj(tddal,m-}ttMdg|dhtNj.tNj/ttdZtMditNj0djtctdZtMdktNj0djtetdZtMdltNj0dm|dntttMdotNj*tttMdptNj.tNj/ttdZtMdqtNj(drtdZtMdstNj(dttdZtMdutNj(dvtdZtMdwtNj(dxtdZtMdytNj(dzttdZtMd{tNj(d|tdZtMd}tNj(d~tdZtMdtNj(tdttdtdZtMdtctNj*tdZtMdtetNj*tttMdotNj*tttMdtNj.tNj/ttdZtMdtNj(dtdZtMdtNj(dtdZtMdtNj(dtdS)z#Print the setup completion summary.zTool Availability Summaryr)get_available_vision_backends)Vision (image analysis)TN)rFzrun 'hermes setup' to configureOPENROUTER_API_KEY)Mixture of AgentsTN)rFr)z(Web Search & Extract (Nous subscription)TNWeb Search & ExtractzWeb Search & Extract ()TN)rFzbEXA_API_KEY, PARALLEL_API_KEY, FIRECRAWL_API_KEY/FIRECRAWL_API_URL, TAVILY_API_KEY, or SEARXNG_URL)z%Browser Automation (Nous Browser Use)TNzBrowser AutomationzBrowser Automation (zVnpm install -g agent-browser, set CAMOFOX_URL, or configure Browser Use or Browserbase BrowserbasezOnpm install -g agent-browser and set BROWSERBASE_API_KEY/BROWSERBASE_PROJECT_IDz Browser Usez8npm install -g agent-browser and set BROWSER_USE_API_KEYCamofox CAMOFOX_URLz Local browserzAnpm install -g agent-browser && agent-browser install --with-depsF)z$Image Generation (Nous subscription)TN)Image GenerationTN)list_providers)_ensure_plugins_discoveredfalzImage Generation ()rFzFAL_KEY or OPENAI_API_KEY)z,Video Generation (FAL via Nous subscription)TNzVideo Generation (ttsredger)z-Text-to-Speech (OpenAI via Nous subscription)TN elevenlabsELEVENLABS_API_KEY)zText-to-Speech (ElevenLabs)TNopenaiVOICE_TOOLS_OPENAI_KEYOPENAI_API_KEY)zText-to-Speech (OpenAI)TNr;MINIMAX_API_KEY)zText-to-Speech (MiniMax)TNmistralMISTRAL_API_KEY)z Text-to-Speech (Mistral Voxtral)TNr7GEMINI_API_KEYGOOGLE_API_KEY)zText-to-Speech (Google Gemini)TNneutts)zText-to-Speech (NeuTTS local)TN)u)Text-to-Speech (NeuTTS — not installed)Frun 'hermes setup tts' kittentts)z Text-to-Speech (KittenTTS local)TN)u,Text-to-Speech (KittenTTS — not installed)Fr)zText-to-Speech (Edge TTS)TN)z#Modal Execution (Nous subscription)TNterminalbackendmodal)zModal Execution (direct Modal)TN)zModal ExecutionFzrun 'hermes setup terminal')z0Modal Execution (optional via Nous subscription)TN HASS_TOKEN)zSmart Home (Home Assistant)TN)get_provider_auth_statespotify access_token refresh_token)zSpotify (PKCE OAuth)TN GITHUB_TOKEN)Skills Hub (GitHub)TN)rFr)zTerminal/CommandsTN)zTask Planning (todo)TN)zSkills (view, create, edit)TNc3&K|] \}}}|dV dS)rqN).0_avails r z'_print_setup_summary..+s-DD 5!eD!DDDDDDr/z tool categories available:z u✓ru✗z (missing c"g|] \}}}|||f Srr)rrrrs r z(_print_setup_summary..;s(SSS&6dE3UStSkSSSrzDSome tools are disabled. Run 'hermes setup tools' to configure them,display_hermes_homezor edit z+/.env directly to add the missing API keys.┌─────────────────────────────────────────────────────────┐uA│ ✓ Setup Complete! │└─────────────────────────────────────────────────────────┘u📁 All your files are in z/:z Settings:rz API Keys:zData: z/cron/, sessions/, logs/u────────────────────────────────────────────────────────────u 📝 To edit your configuration:z hermes setupz Re-run the full wizardzhermes setup modelz Change model/providerzhermes setup terminalz Change terminal backendzhermes setup gatewayz Configure messagingzhermes setup toolsz Configure tool providersz hermes configz View current settingszhermes config editz Open config in your editorzhermes config set z. Set a specific valuez Or edit the files directly:znano u🚀 Ready to go!hermesz Start chattingzhermes gatewayz Start messaging gatewayz hermes doctorz Check for issues)3rWrZragent.auxiliary_clientrrfappendrQwebmanaged_by_nous availablecurrent_providerbrowser image_genagent.image_gen_registryrhermes_cli.pluginsrr is_available display_name video_genagent.video_gen_registryrHr importlibutil find_specrdirect_overridernous_auth_presentr*rrsumrr\rTrSrREDrr^hermes_constantsrrXrYrrrKrL)r hermes_home tool_statussubscription_featuresr_vision_backendslabelbrowser_providermissing_browser_hint _img_backendrr_p_list_video_providers_ensure_plugins_video_backend_vp tts_provider neutts_ok kittentts_okr_spotify_stateavailable_count total_countrr missing_vardisabled_tools_dhhs r_print_setup_summaryrds| GGG,---K:6BBHHHHHH88:: bBCCCC`aaa)**O<====MNNN 0bSTTTT  " ,b& $ 5 [Z-B-F-WZZZEE4.////a b b b-4E$4 PQQQQ  & 0 $  ?>+;>>>EE4.////w } , ,= !  . .J !  * *#0  0 0S !  !5*> ?   &6YOPPPP  ( 2Y;<<<<   ? ? ? ? ? ? E E E E E E & & ( ( ($n&&  7e##((') !H    D   Y    D\ D D DdDQ R R R R   W X X X &6UWXXXX " X X X X X X X X X X X X O   !N,,..  ''))),)9!H " " "!NNN "  U    F^ F F FdS T T T65*fEEEL 0!FXYYYY  % %-8L*M*M %FGGGG  ! !.// "3@AQ3R3R " BCCCC  " "}5F'G'G "CDDDD  " "}5F'G'G "KLLLL  ! !}5E'F'F !-XhJiJi !IJJJJ  ! ! !00::$FII   III   o   L M M M M   m n n n n  $ $ !$>33K@@LLL ! ! ! LLL !  r   O P P P P   p q q q qDEEE"2]NOOOO Y / /7 : : & 6 Z   M N N N N   X Y Y Y Y # % %]*?*Q][\\\\""HFGGG ;;;;;;00;;Ar   n - - E1C1CO1T1T E   C D D D      ^$$K>????IJJJ8999;<<<BCCCDD{DDDDDOk""K/LLKLLLMMM GGG(3$i   ;eV\22;;T;; < < < < geE6:..gggg>X+>X>X>XZ`Zd8e8egg     GGGSS+SSSN R    A@@@@@TTTTUUU  GGG   @BHBN     OQWQ]      @BHBN    GGG=<<<<< %8ddff888&+v{ S STTT GGG Hk6=11 H H_5F5F H HIII Ek6=11 E E\^^ E EFFF XeGV]++XX;XXX GGG % FJ ' '((( GGG %2FK M MNNN GGG Unfl33 U U UVVV T*FL99 T T TUUU V-v|<< V V VWWW R,fl;; R R RSSS W*FL99 W W WXXX GGG Tov|44 T T TUUU We(&,77WWW H7FF H HIII :;;; GGG *+++ @1o//116:>> @ @AAA =.lnn.. ;; = =>>> GGG % FJ ' '((( GGG %#V[&+ > >??? GGG Kh -- K K KLLL T& 55 T T TUUU Mov|44 M M MNNN GGGGGsA AA.I3I"I3" I/,I3.I//I33 J?J$L.?LL. L*'L.)L**L.. L=<L=!R66 SS=!T T.-T.2AZ ZZc<|di}ttd|dd}|rdnd}tdtdt d |}|d v|d<|d d }t d t |} t||d <n#t$rYnwxYw|dd}t dt |} t||d<n#t$rYnwxYw|dd} t dt | } t| |d<dS#t$rYdSwxYw)zMPrompt for container resource settings (Docker, Singularity, Modal, Daytona).rzContainer Resource Settings:container_persistentTrrz5 Persistent filesystem keeps files between sessions.z; Set to 'no' for ephemeral sandboxes that reset each time.z. Persist filesystem across sessions? (yes/no)>1rrtrue container_cpurqz CPU corescontainer_memoryiz Memory in MB (5120 = 5GB)container_diskiz Disk in MB (51200 = 50GB)N) setdefaultrWr\rr{rBrfloatrr) r rcurrent_persist persist_label persist_str current_cpucpu_str current_memmem_str current_diskdisk_strs r_prompt_container_resourcesr)s  R00H GGG-...ll#94@@O,6EE$MFGGGLMMM8-K(3'8'8':':>W'WH #$,,22K]C $4$455G $)'NN!!      ,,1488K2C 4D4DEEG '*7||#$$      << 0%88L3S5F5FGGH %(]]!"""      s6 C C+*C+"D55 EE9F FF)quickr*cddlm}m}tdt dt dt dt ddlm} |n#ttf$r t t dYnRt$rF}t d |td |t d Yd }~nd }~wwxYw|}|||d }|d }t%|t&r|d}||d S)uConfigure the inference provider and default model. Delegates to ``cmd_model()`` (the same flow used by ``hermes model``) for provider selection, credential prompting, and model picking. This ensures a single code path for all provider setup — any new provider added to ``hermes model`` is automatically available here. When *quick* is True, skips credential rotation, vision, and TTS configuration — used by the streamlined first-time quick setup. r)rMrNzInference Providerz.Choose how to connect to your main chat model. Guide: z/integrations/providers)select_provider_and_modelzProvider setup skipped.z0select_provider_and_model error during setup: %sz%Provider setup encountered an error: *You can try again later with: hermes modelNrr)hermes_cli.configrMrNrZr\ _DOCS_BASErWhermes_cli.mainr- SystemExitrurfloggerdebugr^clearupdaterrr) r r*rMrNr-exc _refreshedselected_provider_ms rsetup_model_providerr;s;:::::::%&&&?@@@?J???@@@ GGG:99999A!!#### ) *... ,----- AAA GMMMCcCCDDD?@@@@@@@@AJ LLNNN MM* G  B"d/FF:..Ks A.C C|jdkr|gd d n|gdd tdnO#|j tf$r,}t d|t dYd}~dSd}~wwxYwt dtt dt dt ||j ddddddgd dtdd S#|j |j f$r,}td|t d Yd}~dSd}~wwxYw)!zHInstall NeuTTS dependencies with user approval. Returns True on success.rNz,NeuTTS requires espeak-ng for phonemization.darwinz$Install with: brew install espeak-ngwin32z%Install with: choco install espeak-ngz(Install with: sudo apt install espeak-ngzInstall espeak-ng now?T)brewinstallr=)check)chocorFr=-y)sudoaptrFrIr=zespeak-ng installedz+Could not install espeak-ng automatically: z,Please install it manually and re-run setup.FzJespeak-ng is required for NeuTTS. Install it manually before using NeuTTS.z#Installing neutts Python package...z > > > \W $ $ > ? ? ? ? A B B B  14 8 8 h <8++NN#C#C#C4NPPPP\W,,NN#J#J#JRVNWWWWNN#P#P#PX\N]]]3444413DE   OAOOPPPIJJJuuuuu  f g g g GGG4555MNNN GGG  ^T5)T=) T     5666t  ):+D E444555GHHHuuuuus1A2D E !EE 3G H!HHc bddl}ddl}d}ttdt ||jdddd|d d gd d t dd S#|j|jf$r0}td|td|dYd}~dSd}~wwxYw)zKInstall KittenTTS dependencies with user approval. Returns True on success.rNz^https://github.com/KittenML/KittenTTS/releases/download/0.8.1/kittentts-0.8.1-py3-none-any.whlzOInstalling kittentts Python package (~25-80MB model downloaded on first use)...rLrMrFrN soundfilerOTrPrQz kittentts installed successfullyzFailed to install kittentts: z(Try manually: python -m pip install -U 'z ' soundfileF) rSrcrWr\rUrXr]rVrYr[)rSrc wheel_urlrZs r_install_kittentts_depsr_+sJJJ 1 GGG`aaa GGG  ^T5)T9kS\ ]     8999t  ):+D E7A77888TiTTTUUUuuuuus4A--B.>%B))B.c ddlm}t|dS#t$rYdSwxYw)zTrue iff xAI Grok OAuth credentials are already stored locally. Lets TTS / STT setup skip the API-key prompt for users who logged in through ``hermes model`` -> xAI Grok OAuth (SuperGrok / Premium+). rget_xai_oauth_auth_status logged_inF)r*rbrdrrfras r_xai_oauth_logged_in_for_setuprdDsa ======--//33K@@AAA uus/2 AAc ddlm}m}m}m}m}n*#t $r}td|Yd}~dSd}~wwxYw| }ttd ||}||d| d | d d | d  |d| d|dS#t $r}td|Yd}~dSd}~wwxYw)zRun the xAI Grok OAuth loopback login from inside the setup wizard. Returns True on success, False on any failure (the caller falls back to whatever the user picked next, e.g. Edge TTS). r)DEFAULT_XAI_OAUTH_BASE_URL_is_remote_session_save_xai_oauth_tokens_update_config_for_provider_xai_oauth_loopback_loginz$xAI Grok OAuth helpers unavailable: NFz6Signing in to xAI Grok OAuth (SuperGrok / Premium+)...) open_browsertokens discovery redirect_urirA last_refresh)rmrnroz xai-oauthbase_urlTzxAI Grok OAuth login failed: ) r*rfrgrhrirjrfr^rWr\r)rfrgrhrirjr7rkcredss r_run_xai_oauth_login_from_setuprrRs                 BSBBCCCuuuuu*)+++L GGGGHHH))|DDD (Oii ,,>266>22     $# :/IJJ   t ;c;;<<<uuuuus) 838$A;C!! D+DDc  |di}|dd}t|}dddddd d d d d }|||}ttdt d|tg}g}t r1|jr*|d|d|gd|gd |d|dt|dz }td||} | |krdS|| } | dk} | dkr>d} t dtdstdrtd| dkr tjddu} n#t $rd} YnwxYw| rt#dnJtt d t d!t d"tt%d#d$r!t'std%d} nt d&d} n| d'krftd(} | sStt)d)d$*}|r!t+d(|t#d+ndtd,d} nQ| dkrw| sutdptd} | sStt)d-d$*}|r!t+d|t#d.ntd,d} n| d/krt-}td0}|rt#d1n|rt#d2nttd3gd4d56}|d5kr0t/rt#d7ntd8d} nn|dkrWt)d9d$*}|r t+d0|t#d:n5d5d;lm}td<|d=d} ntd>d} | d/krtt)d?}|rw|rc||did/id@<t#dA|n(| dBkrftdC} | sStt)dDd$*}|r!t+dC|t#dEntd,d} n| dFkrftdG} | sStt)dHd$*}|r!t+dG|t#dInctd,d} nP| dJkrtdKptdL} | satt dMt)dNd$*}|r t+dK|t#dOntd,d} n| dPkr tjdPdu} n#t $rd} YnwxYw| rt#dQn{tt dRt dStt%dTd$r t9stdUd} nt dVd} d|vri|d<| |dd<t;|t#dW|| | dS)Xz@Interactive TTS provider selection with install flow for NeuTTS.rrrzEdge TTS ElevenLabsz OpenAI TTSzxAI TTSz MiniMax TTSzMistral Voxtral TTSzGoogle Gemini TTSNeuTTS KittenTTS) rrrxair;rr7rrz"Text-to-Speech Provider (optional)z Current: zCNous Subscription (managed OpenAI TTS, billed to your subscription)z nous-openai) z-Edge TTS (free, cloud-based, no setup needed)z+ElevenLabs (premium quality, needs API key)z(OpenAI TTS (good quality, needs API key)u0xAI TTS (Grok voices — OAuth login or API key)zMistral Voxtral TTS (multilingual, native Opus, needs API key)zJGoogle Gemini TTS (30 prebuilt voices, prompt-controllable, needs API key)z5NeuTTS (local on-device, free, ~300MB model download)z]>] " GGG5EEEG "7AAA89999NOOO! U   9::(77 , "     ' " F G G G G GGG&: JQ244 &!P"4 &HHq !6FFF &"=':::!"9::::LLLLLL!459TVV444 &HHJKKK! u   GGGZ[[H JHNN,, JQYQ_Q_QaQa!!%,,77rBB:NHhnn6F6FHHIII Y   !233 " GGG6FFFG "0':::9::::NOOO! Y   !233 " GGG6FFFG "0':::9::::NOOO! X   !122UmDT6U6U " GGG U V V V5EEEG "/99989999NOOO! [  & ) 8 8 E ET Q   & & & %    &  " : ; ; ; ; GGG \ ] ] ] S T T T GGG5t<< ".00&!"`aaa%Hijjj! Fu (F5M*S/*=*=h*Q*QSSTTTTTs$)!G GG9!Z Z*)Z*c$t|dS)z.Standalone TTS setup (for 'hermes setup tts').N)rr s r setup_ttsrdsrc fddl}tdtdtdtdtdt t |dd d }|d k}gd }d ddddd}dddddd}d}|r$|dd||<||d<|dz }|}|d|d|||<td||} | | } | |krtd|dS| | did <| d krZtdtd |d d!ttjn*| dkrttd"tjd} | st#d#td$ntd%| |d d&d'n| dkrtd(tjd)ptjd} | st#d*td+ntd,| |d d-d.n"| dkrtd/td0dd1lm} dd2lm}t-t/ot1|jo | d}|t |dd3}d4}|r@d5d6g}|d7krd}n|d8krd}nt5d9rdnd}td:||}|dk}|rId7|dd3<td;t5d9st5d<rtd=nd8|dd3<td> t7dn#t8$rtd?ddl}tjd@}|r)||dAdBdCt>j dgdDdDE}n'|t>j dFdAdBdgdDdDE}|j!dkrtdGnt#dHYnwxYwt tdItdJt5d9}|rgtdKtEdLd4rFtGdMdDN}tGdOdDN}|rtId9||rtId<|ntGdMdDN}tGdOdDN}|rtId9||rtId<|nD| dkr tdPtdQtdRtdS t7dn#t8$rtdTddl}tjd@}|r)||dAdBdCt>j dgdDdDE}n'|t>j dFdAdBdgdDdDE}|j!dkrtdUnWt#dV|j%rAtdW|j%&'dXYnwxYwt t5dY}|rRtdZtEd[d4r2tGd\dDN}|rtIdY|td]n2tGd\dDN}|rtIdY|td^|d d_d'n4| dkr-td`tdat5dbpdc}tGdd|}|rtIdb|t5depdc}tGdf|ptQj)dgdc} | rtIde| t5dhpdi}!tGdj|!}"|"r|"dikrtIdh|"t5dkpdc}#ttjdlz dmz }$tGdn|#p|$}%|%rtIdk|%|rtEdodDrtdpddl}gdq}&|%r|&*dr|%g|"r|"dikr|&*ds|"g|&| r| dt|n||&du||&dDdDdvw}|j!dkrtdxn8t#dy|j%&tdztId{| | dkr*tId||d d3d}tW|t td~| dS)z)Configure the terminal execution backend.rNTerminal Backendz1Choose where Hermes runs shell commands and code.z8This affects tool execution, file access, and isolation.r,z/developer-guide/environmentsrrlocalrLinux)z.Local - run directly on this machine (default)z7Docker - isolated container with configurable resourcesz Modal - serverless cloud sandboxzSSH - run on a remote machinez2Daytona - persistent cloud development environmentdockerrsshdaytona)rrqrrqrrr)rrrrrz.Singularity/Apptainer - HPC-friendly container singularityrxrzSelect terminal backend:zKeeping current backend: zTerminal backend: Localz&Commands run directly on this machine.cwdzTerminal backend: DockerzDocker not found in PATH!z3Install Docker: https://docs.docker.com/get-docker/zDocker found: docker_imagez*nikolaik/python-nodejs:python3.11-nodejs20z'Terminal backend: Singularity/Apptainer apptainerz(Singularity/Apptainer not found in PATH!z@Install: https://apptainer.org/docs/admin/main/installation.htmlzFound: singularity_imagez3docker://nikolaik/python-nodejs:python3.11-nodejs20zTerminal backend: Modalz@Serverless cloud sandboxes. Each session gets its own container.)is_managed_tool_gateway_ready)normalize_modal_mode modal_modeFzUse my Nous subscriptionzUse my own Modal accountmanageddirectMODAL_TOKEN_IDz,Select how Modal execution should be billed:zPModal execution will use the managed Nous gateway and bill to your subscription.MODAL_TOKEN_SECRETzZDirect Modal credentials are still configured, but this backend is pinned to managed mode.z+Requires a Modal account: https://modal.comzInstalling modal SDK...uvrMrF--pythonTcapture_outputtextrLzmodal SDK installedu2Install failed — run manually: pip install modalzModal authentication:z/ Get your token at: https://modal.com/settingsz! Modal token: already configuredz Update Modal credentials?z Modal Token IDrz Modal Token SecretzTerminal backend: Daytonaz*Persistent cloud development environments.zBEach session gets a dedicated sandbox with filesystem persistence.zSign up at: https://daytona.iozInstalling daytona SDK...zdaytona SDK installedu4Install failed — run manually: pip install daytona Error: rDAYTONA_API_KEYz% Daytona API key: already configuredz Update API key?z Daytona API keyz Updatedz Configured daytona_imagezTerminal backend: SSHz)Run commands on a remote machine via SSH.TERMINAL_SSH_HOSTrAz SSH host (hostname or IP)TERMINAL_SSH_USERz SSH userUSERTERMINAL_SSH_PORT22z SSH portTERMINAL_SSH_KEYz.sshid_rsaz SSH private key pathz Test SSH connection?z Testing connection...)r-oz BatchMode=yesrzConnectTimeout=5z-iz-p@zecho ok )rrrRz SSH connection successful!z SSH connection failed: z' Check your SSH key and host settings. TERMINAL_ENVTERMINAL_MODAL_MODEautozTerminal backend set to: ),rTrZr\r0rWrHsystemrrrrr]rrhomer?r@r^tools.managed_tool_gatewayrtools.tool_backend_helpersrrdrrrrQ __import__ ImportErrorrSrUrcrX returncoderr{rOstderrr splitlinesosgetenvr{rN)'r _platformcurrent_backendis_linuxterminal_choicesidx_to_backendbackend_to_idxnext_idxr terminal_idxselected_backend docker_binsing_binrrmanaged_modal_availableruse_managed_modal modal_choicesdefault_modal_idxmodal_mode_idxrSuv_binresultexisting_tokentoken_id token_secret existing_keyr( current_hosthost current_useruser current_portport current_key default_keyssh_keyssh_cmds' rsetup_terminal_backendrns     #$$$BCCCIJJJEJEEEFFF GGGfj)WMMMO!!W,H!X'e RRN A!PQRRNH PQQQ#0x (0}%A  ?_???@@@'6N#$ "$46FL&)),77'''@@@AAA3CFj"%%i07""/000;<<< z%%eS-=-=>>>> X % %0111\(++  6 5 6 6 6 L M M M M 4 44 5 5 5 z%% H     ] * *?@@@< ,,K ]0K0K - D E E E R     +++ , , , z%%  A    W $ $/000UVVVLLLLLLCCCCCC"& & ( ( 7 *6 2 2 D 7.-g66 # #  *)'&*l*S*STT ! " 4**MY&&$%!!x''$%!!)67G)H)H$OAAa!*>!N !/! 3  ? G/8F: | , i j j j-.. -@T2U2U p08F: | , D E E E X7#### X X X4555!!!!d++'^^"!%&N# (,!,  FF(^^uiI'+!,F $))!"78888!"VWWW7 X< GGG . / / / H I I I*+;<??? !>FFK%&:TJJJH#)*BT#R#R#RLC&'7BBB#K&';\JJJ!"6FFF%&>NNN ?"#3X>>>G"#7FFF Y & &1222?@@@WXXX3444 U y ! ! ! ! U U U 2 3 3 3    \$''F #UIz3>9U#'( $^T5)YG#'(  A%%56666TUUU=US6=+>+>+@+@+K+K+M+Mb+QSSTTT- U2 $%677  0 > ? ? ?0%88 1 !6FFF1"#4g>>>!-0002TBBBG 00':::./// z%% I     U " "-...>???%%899?R 3\BB  6 . 5 5 5%%899?R lL$IBIfb4I4IJJ  6 . 5 5 5%%899AT lL11  6DDLL . 5 5 5$$677=2 $)++.9:: 1;3M+NN  8 -w 7 7 7  FM":DAA F 0 1 1 1    NNNG 0g/// - d|,,, NNt=d++T+++ > > > NN9 % % %^^GDtUW^XXF A%%<====Q&-:M:M:O:OQQRRRDEEE>#34447"",fZ.@.D.D\SY.Z.Z[[[ GGG@.>@@AAAAAs&OB-RRWC5[  [ cd|did<tdd|did<d|d id <d |d d <d |did<t|tdt dt dt dt dt ddS)zDApply recommended defaults for all agent settings without prompting.r? max_turnsHERMES_MAX_ITERATIONSallrx tool_progressT compressionenabled? thresholdnone session_resetmodezApplied recommended defaults:z Max iterations: 150z Tool progress: allz Compression threshold: 0.50z2 Session reset: never (use /reset or compression)z. Run `hermes setup agent` later to customize.N)rrPrNr]r\rs r_apply_default_agent_settingsrs25Fgr"";/ ,---8=Fi$$_56:FmR((3)-F=+& 6d?|d } t%d@| | }|d5i|d krd7|d5d6<t dAt | } t|}|d kr ||d5d8<n#t$rYnwxYwt dBt | } t|}d |cxkrdCkrnn ||d5d:<n#t$rYnwxYwtdD|d5d8d9dE|d5d:d;dFnU|dkr)dK|d5d6<tdLtdMt|dS)NzSConfigure agent behavior: iterations, progress display, compression, session reset.Agent Settingsr,z/user-guide/configurationr?rZrz1Maximum tool-calling iterations per conversation.z3Higher = more complex tasks, but costs more tokens.zPress Enter to keep z5. Use 90 for most tasks or 150+ for open exploration.zMax iterationsrNrzMax iterations set to z%Invalid number, keeping current valuerAzTool Progress Displayz=Controls how much tool activity is shown (CLI and messaging).u- off — Silent, just the final responseu> new — Show tool name only when it changes (less noise)u7 all — Show every tool call with a short previewu0 verbose — Full args, results, and debug logsrxrrzTool progress mode>rnewoffverbosezTool progress set to: zUnknown mode 'z ', keeping ''zContext CompressionzAAutomatically summarizes old messages when context gets too long.zNHigher threshold = compress later (use more context). Lower = compress sooner.Trrrrz Compression threshold (0.5-0.95)gffffff?z%Context compression threshold set to zSession Reset PolicyzJMessaging sessions (Telegram, Discord, etc.) accumulate context over time.zMEach message adds to the conversation history, which means growing API costs.zMTo manage this, sessions can automatically reset after a period of inactivityzLor at a fixed time each day. When a reset happens, the agent saves importantuRthings to its persistent memory first — but the conversation context is cleared.z=You can also manually reset anytime by typing /reset in chat.)zDInactivity + daily reset (recommended - reset whichever comes first)z6Inactivity only (reset after N minutes of no messages)z+Daily only (reset at a fixed hour each day)zDNever auto-reset (context lives until /reset or context compression)zKeep current settingsrrboth idle_minutesiat_hourrrqrr)ridledailyrzSession reset mode:z Inactivity timeout (minutes)z% Daily reset hour (0-23, local time)zSessions reset after z min idle or daily at z:00rz min of inactivityrzSessions reset daily at rzGSessions will never auto-reset. Context is managed only by compression.zFLong conversations will grow in cost. Use /reset manually when needed.)rZr\r0rWrrHr{rrpoprPr]rr^rBrNrrr)r current_max max_iter_strmax_iter current_modercurrent_threshold threshold_strr reset_choicescurrent_policy current_idle current_hour default_reset reset_idxidle_stridle_valhour_strhour_vals rsetup_agent_settingsrsF!"""AJAAABBB GGG gfg{BGGGHHKBCCCDEEEa{aaa*K88L ?|$$ a<< ;CF  gr * *; 7 JJ{D ) ) ) 4 5 5 5 =8== > > > ???=>>>>>?rNNN&'''NOOO>???OPPPHIIIABBB69ouMMML & 5 5D zz||777 F " " "F9 -1ZZ\\y/*F=tzz||==>>>>HtHHHHHIII&'''RSSSX7;FmR((3 {DQQQ=sCT?U?UVVM -(( ) # # # #t # # # # #1:F= !+ .      ^}0E0I0I+W[0\0\^^ '(((TWrNNNWV\rNNNNOOOrNNNMZZ44N!%%ff55L!%%nd;;L!%%i33LAqAAEElTUVVM3]MRRI or***A~~*0':C 'B'B9a'P'P U U U     a*0' U     T   smA%C>>DD&*K KK0 R RR?*S** S76S75 V V#"V#*X.. X;:X;z^\d+:[A-Za-z0-9_-]{30,}$tokencPtt|SN)rd_TELEGRAM_BOT_TOKEN_REmatchrs r_is_valid_telegram_bot_tokenrms &,,U33 4 44rc ddlm}n#t$rYdSwxYwd} tt }d|vr/|dddd}n#t$rYnwxYw||S) zBAttempt automatic Telegram bot creation via managed QR onboarding.r)auto_setup_telegram_bot_resultNz /profiles/rrqr) profile_name)hermes_cli.telegram_managed_botrrrrJrstriprsplitrf)rrrs r_setup_telegram_auto_resultrqsRRRRRRR tt $L /++,, ; & &&--c2299#qAA"EL       * )| D D DDs AA,, A98A9c4t}|r|jndS)zBAttempt automatic Telegram bot creation and return only the token.N)rr)rs r_setup_telegram_autors ( * *F! +6<: (e.g., 123456789:ABCdefGHI-jklMNOpqrSTUvwxYZ))r\r{rr[rs r_prompt_telegram_bot_tokenr sh8999 +d;;; 4+E22  @     rc tdtd}|rtdtddstdsrtdtdd rStd t d }|r3t d|d d tddStdttdtdtdttdtdtt dd}d}d}| dkrit}|r*|j }t|stdd}d}nd}|s+ttdt|st}|sdSt d|tdttdtdtdtdtt|d d}|rt!|}td!|td"d rot d#}|g}|d d d$D]} | r| |vr|| d$|}nt d%}nt d%}|r6|d d }t d|td&ntd'ttd(td)td*|r-|d$d+ nd } | r]td,| d-d r$t d.| td/| dSt d0} | rt d.| dSdStd1t d2} | rt d.| dSdS)3z1Configure Telegram bot credentials and allowlist.TelegramTELEGRAM_BOT_TOKENzTelegram: already configuredzReconfigure Telegram?FTELEGRAM_ALLOWED_USERSuA⚠️ Telegram has no user allowlist - anyone can use your bot!zAdd allowed users now?Tz6 To find your Telegram user ID: message @userinfobotz"Allowed user IDs (comma-separated)rrAzTelegram allowlist configuredNz/How would you like to create your Telegram bot?z [1] Automatic (recommended)u6 Scan a QR code → confirm in Telegram → done.z! No token copy-paste needed.z [2] Manualz? Create a bot via @BotFather yourself and paste the token.z Choice [1/2]rrz7Automatic setup returned an invalid Telegram bot token.zFalling back to manual setup...zTelegram token saved,🔒 Security: Restrict who can use your botz! To find your Telegram user ID:z& 1. Message @userinfobot on Telegramz: 2. It will reply with your numeric ID (e.g., 123456789) owner_user_idz Detected your Telegram user ID: z+Allow this Telegram account to use the bot?z7Additional allowed user IDs (comma-separated, optional),?Allowed user IDs (comma-separated, leave empty for open access)zATelegram allowlist configured - only listed users can use the botu@⚠️ No allowlist set - anyone who finds your bot can use it!:📬 Home Channel: where Hermes delivers cron job results,. cross-platform messages, and notifications.z: For Telegram DMs, this is your user ID (same as above).rzUse your user ID (z) as the home channel?TELEGRAM_HOME_CHANNELzTelegram home channel set to zHHome channel ID (or leave empty to set later with /set-home in Telegram)zI You can also set this later by typing /set-home in your Telegram chat.z*Home channel ID (leave empty to set later))rZrQr\rr{rOreplacer]rWrrrrr[r rbrsplitrr) r allowed_usersrr setup_resultdetected_user_id detected_idextraidsuid first_user_id home_channels r_setup_telegramr7s122H 12224e<<  !9:: G^___ !94@@GWXXX$*+O$P$PM$G&'?AVAVWZ\^A_A_```%&EFFF F@AAA GGG.///GHHH2333 GGG~PQQQ GGG NC 0 0 0F EL ||~~244   &E/66 $UVVV# E  GGG 8 9 9 9 GGG -*,, '///())) GGG=>>>23337888KLLL GGG|_dCC *++ FFFGGG F M M TUUE-C}}S"--33C88 $ $$3c>>JJsOOOHHSMMMM"QMM M  W%--c266 /???YZZZZUVVV GGGKLLL?@@@KLLL;HPM'',,Q/55777bM B SmSSSUY Z Z F 2M B B B I-II J J J J J!"lmmL F6 EEEEE F F ^___JKK  B 2L A A A A A B Brc(tdtd}|r?tdtdds tddrt dStd td td td td tdtdt tdt t t t dd}|sdStd|t dd}|rtd|tdt tdtdt t d}|r4td| ddtdntdtdt tdtd td!td"td#t d$}|r$td%| dSdS)&z Configure Slack bot credentials.SlackSLACK_BOT_TOKENzSlack: already configuredzReconfigure Slack?FzcRegenerate the Slack app manifest with the latest command list? (recommended after `hermes update`)TNzSteps to create a Slack app:u9 1. Go to https://api.slack.com/apps → Create New AppuG Pick 'From an app manifest' — we'll generate one for you below.u= 2. Enable Socket Mode: Settings → Socket Mode → EnableuB • Create an App-Level Token with 'connections:write' scopeu4 3. Install to Workspace: Settings → Install AppzD 4. After installing, invite the bot to channels: /invite @YourBotzU Full guide: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/slack/zSlack Bot Token (xoxb-...)rzSlack App Token (xapp-...)SLACK_APP_TOKENzSlack tokens savedr%u\ To find a Member ID: click a user's name → View full profile → ⋮ → Copy member IDzTAllowed user IDs (comma-separated, leave empty to deny everyone except paired users)SLACK_ALLOWED_USERSrrAzSlack allowlist configureduJ⚠️ No Slack allowlist set - unpaired users will be denied by default.zw Set SLACK_ALLOW_ALL_USERS=true or GATEWAY_ALLOW_ALL_USERS=true only if you intentionally want open workspace access.r)r*zC To get a channel ID: open the channel in Slack, then right-clickuN the channel name → Copy link — the ID starts with C (e.g. C01ABC2DE3F).zF You can also set this later by typing /set-home in a Slack channel.z9Home channel ID (leave empty to set later with /set-home)SLACK_HOME_CHANNEL) rZrQr\r"_write_slack_manifest_and_instructrWr{rOr]r,r^r)r bot_token app_tokenr.r6s r _setup_slackrAs.//H .///1599 < 5 3444 F-...JKKKXYYYNOOOSTTTEFFFUVVV GGGfggg GGG '((( GGG3dCCCI $i0003dCCCI5()444&''' GGG=>>>mnnn GGG^MN,m.C.CC.L.LMMM23333bcccM N N N GGGKLLL?@@@TUUU_```WXXXUVVLC+\-?-?-A-ABBBBBCCrc ddlm}ddlm}|dd}t |dz }|jdd dd l}|| |d d dzdtd|tdtdd S#t$r,}td|tdYd }~d Sd }~wwxYw)uGenerate the Slack manifest, write it under HERMES_HOME, and print paste-into-Slack instructions. Exposed as its own helper so both the initial setup flow and the "reconfigure? → no" branch can refresh the manifest without the user re-entering tokens. Failures are non-fatal — if the manifest write fails for any reason, we print a warning and skip rather than abort the whole Slack setup. r)_build_full_manifest)rJHermeszYour Hermes agent on Slack)bot_namebot_descriptionzslack-manifest.jsonT)parentsexist_okNrF)indent ensure_ascii zutf-8)encodingzSlack app manifest written to: u Paste it into https://api.slack.com/apps → your app → Features → App Manifest → Edit, then Save. Slack will prompt to reinstall if scopes or slash commands changed.z\ Re-run `hermes slack manifest --write` anytime to refresh after Hermes adds new commands.zCouldn't write Slack manifest: zI You can generate it manually later with: hermes slack manifest --write)hermes_cli.slack_clirCrrJrparentmkdirjson write_textdumpsr]r\rfr^)rCrJmanifesttarget_jsonr7s rr>r>Js ======444444''8   oo''((+@@ D4888 KKK ? ?$ F     @@@AAA =    (         ===>>> ,          sB3B77 C-!C((C-c  tdtdptd}|r!tdtddsdStdtd td t t d }|r#t d |d t tdt dd}|rAt d|t d}|rt d|tdnSt d}|rt d|t dd}|rt d|td|stdrt tdd}|rt ddtd|rdnd} ddl m }m }|d } | r|td!|d"t| d# |d d$t|d%n8#t$r+} td&td'| Yd} ~ nd} ~ wwxYwn)#t$r t!dn#t$rtd!|d(ddl} t%jd)} | r)| | d*d+d,t*j|gdd-} n'| t*jd.d*d+|gdd-} | jdkrt|d%n[td/|d0| jrAtd'| jd1YnwxYwYnwxYwt td2td3t t d4}|r4t d5|d6d7td8ntd9t td:td;td<t d=}|rt d>|dSdSdS)?zConfigure Matrix credentials.MatrixMATRIX_ACCESS_TOKENMATRIX_PASSWORDzMatrix: already configuredzReconfigure Matrix?FNzMWorks with any Matrix homeserver (Synapse, Conduit, Dendrite, or matrix.org).zC 1. Create a bot user on your homeserver, or use your own accountzE 2. Get an access token from Element, or provide user ID + passwordz0Homeserver URL (e.g. https://matrix.example.org)MATRIX_HOMESERVERrzCAuth: provide an access token (recommended), or user ID + password.z-Access token (leave empty for password login)Tru9User ID (@bot:server — optional, will be auto-detected)MATRIX_USER_IDzMatrix access token savedzUser ID (@bot:server)PasswordzMatrix credentials savedz$Enable end-to-end encryption (E2EE)?MATRIX_ENCRYPTIONrz E2EE enabledzmautrix[encryption]mautrixr)ensurefeature_missingzplatform.matrixz Installing z (+ z runtime deps)...)r{z installedukInstall failed — run manually: pip install 'mautrix[encryption]' asyncpg aiosqlite Markdown aiohttp-socksrz...rrMrFrrrLu.Install failed — run manually: pip install 'z*' asyncpg aiosqlite Markdown aiohttp-socksrr%z- Matrix user IDs look like @username:serverr(MATRIX_ALLOWED_USERSrrAzMatrix allowlist configureduE⚠️ No allowlist set - anyone who can message the bot can use it!uI📬 Home Room: where Hermes delivers cron job results and notifications.zE Room IDs look like !abc123:server (shown in Element room settings)zD You can also set this later by typing /set-home in a Matrix room.z6Home room ID (leave empty to set later with /set-home)MATRIX_HOME_ROOM)rZrQr\rrWr{rOrr]tools.lazy_depsr_r`rrfr^rrrSr?r@rUrcrXrrrrr,)r homeserverruser_idrl want_e2ee matrix_pkg _lazy_ensurer`_missing_beforer7rSrrr. home_rooms r _setup_matrixrkus233W}EV7W7WH/0002E::  F^___TUUUVWWW GGGJKKJD*J,=,=c,B,BCCC GGGTUUU BT R R RE 6,e444TUU  6 +W 5 5 512222011  6 +W 5 5 5*t444  6 ,h 7 7 7 4 5 5 5 N: /00N: !"H%PP  * . 7 7 7 . ) ) ).7F**Y - Y O O O O O O O O-o.?@@O 2Y*YY#o2F2FYYY 2 L!25AAAA!Z";";";<<<< 222!) 030011111111 2 Y Y Y Y9%%%% Y Y Y8888999!!!!d++ '^^ :s~zZ'+$,FF (^^uiL'+$,F$))!Z";";";<<<<!S&SSS}Y"#Wv}/B/B/D/D/O/O/Q/QRT/U#W#WXXX- Y  Y< ABBBBCCC `aa  ` 1=3H3Hb3Q3Q R R R 7 8 8 8 8 ^ _ _ _ ^___Z[[[YZZZSTT  : -y 9 9 9 9 9]N:N:Z : :sa8I/H54I/5 I*?!I% I/%I**I// N;J  N DN NNNNctdtd}|r!tdtddsdStdtdtd td t td t t d }|st d dStd|dt dd}|st ddStd|tdt tdtdt t d}|r4td| ddtdntdt tdtdt d}|rtd |t td!td"drnt d#}|r] td$tt|td%|n#t$rt d&YnwxYwt td'td(td)dS)*z'Configure BlueBubbles iMessage gateway.zBlueBubbles (iMessage)BLUEBUBBLES_SERVER_URLzBlueBubbles: already configuredzReconfigure BlueBubbles?FNuCConnects Hermes to iMessage via BlueBubbles — a free, open-sourcez1macOS server that bridges iMessage to any device.z4 Requires a Mac running BlueBubbles Server v1.0.0+z% Download: https://bluebubbles.app/uNIn BlueBubbles Server → Settings → API, note your Server URL and Password.z6BlueBubbles server URL (e.g. http://192.168.1.10:1234)u5Server URL is required — skipping BlueBubbles setuprzBlueBubbles server passwordTru3Password is required — skipping BlueBubbles setupBLUEBUBBLES_PASSWORDzBlueBubbles credentials savedu0🔒 Security: Restrict who can message your botzJ Use iMessage addresses: email (user@icloud.com) or phone (+15551234567)zIAllowed iMessage addresses (comma-separated, leave empty for open access)BLUEBUBBLES_ALLOWED_USERSrrAz BlueBubbles allowlist configureduI⚠️ No allowlist set — anyone who can iMessage you can use the bot!uJ📬 Home Channel: phone or email for cron job delivery and notifications.zD You can also set this later with /set-home in your iMessage chat.z/Home channel address (leave empty to set later)BLUEBUBBLES_HOME_CHANNELz6Advanced settings (defaults are fine for most setups):z$Configure webhook listener settings?z%Webhook listener port (default: 8645)BLUEBUBBLES_WEBHOOK_PORTWebhook port set to z'Invalid port number, using default 8645zBRequires the BlueBubbles Private API helper for typing indicators,zGread receipts, and tapback reactions. Basic messaging works without it.zC Install: https://docs.bluebubbles.app/helper-bundle/installation)rZrQr\rrWr{r^rOrr]r,rrr)r server_urlrlr.r6 webhook_ports r_setup_bluebubblesrus)***566H45557??  FTUUUBCCCEFFF6777 GGG_``` GGGPQQJ MNNN+Z->->s-C-CDDD3dCCCH KLLL)84441222 GGGABBB[\\\ GGGfggM`2M4I4I#r4R4RSSS89999^___ GGG[\\\UVVVKLLLA1<@@@ GGGGHHH;UCCIEFF  I I93sz Route configuration guide:z_ https://hermes-agent.nousresearch.com/docs/user-guide/messaging/webhooks/#configuring-routesz2 Open config in your editor: hermes config edit)rZrQr\rrWr^r{rOrrr]rrr)rrsecretrs r_setup_webhooksr0sH.//H12224e<<  F GGGXYYYYZZZVWWW GGGijjj GGG / 0 0D E E >3s4yy>> : : : 777 8 8 8 8 E E E C D D D D D ECd S S SF _'000,----]^^^$f--- GGG1222<<<<<<EEEEFFFDEEEDEEE GGG.///pqqq GGGCDDDCDDDDDs:|)d?d2rk d}*d@}+d@},|$r|d@A\}*}+n1|r|d@Ad2}+n dd3l&m'}&|&-d@Ad2}+d2},t |+r|,stKdBd2r |$r||*dCkDn |r |n#|$rO}'tSd9t|'*D]}(t d5|(Yd}'~'nVd}'~'w|$r'}'tSd:|'|!d7Yd}'~'n,d}'~'wtV$r}'tSd:|'Yd}'~'nd}'~'wwxYwn#tV$r+}'tSdE|'t dFYd}'~'nd}'~'wwxYwt dG|$rt dHt dInddJl.m/}-|-r[t dKt dLt dMt dNt dOt dPnt dKt dQt ddSdS)Rz*Configure messaging platform integrations.r)_all_platforms_platform_status_configure_platformMessaging PlatformszAConnect to messaging platforms to chat with Hermes from anywhere.z&Toggle with Space, confirm with Enter.emojirrz (r configuredzSelect platforms to configure:zENo platforms selected. Run 'hermes setup gateway' later to configure.Nstatusr c|}|dkp)|dp|d S)Nnot configured partiallyzplugin disabled)rB startswith)rss r _is_progressz#setup_gateway.._is_progresssK LLNN ! ! /||K(( /||-..  rc3@K|]}|VdSrr)rprrs rrz setup_gateway..sJ./ %%a(())ru━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━zMessaging platforms configured!r#r+r"DISCORD_BOT_TOKENDISCORD_HOME_CHANNELDiscordr:r=r9rmrp BlueBubbles QQ_APP_IDQQBOT_HOME_CHANNELQQ_HOME_CHANNELQQBotzNo home channel set for: rz7 Without a home channel, cron jobs and cross-platformz2 messages can't be delivered to those platforms.z1 Set one later with /set-home in your chat, or:z hermes config set z_HOME_CHANNEL rDarwinWindows)_is_service_installed_is_service_runningsupports_systemd_serviceshas_conflicting_systemd_unitshas_legacy_hermes_units install_linux_gateway_from_setup$print_systemd_scope_conflict_warningprint_legacy_unit_warning systemd_startsystemd_restartlaunchd_install launchd_startlaunchd_restartUserSystemdUnavailableErrorSystemScopeRequiresRootError$_system_scope_wizard_would_need_root_print_system_scope_remediationrestartz) Restart the gateway to pick up changes?T)gateway_windowsu0 Restart failed — user systemd not reachable:rz Restart failed: startz Start the gateway service?u. Start failed — user systemd not reachable:z Start failed: systemdlaunchdzScheduled Taskz Install the gateway as a z. service? (runs in background, starts on boot)F)forcez Start the service now?r)rz Install failed: z. You can try manually: hermes gateway installz/ You can install later: hermes gateway installzA Or as a boot-time service: sudo hermes gateway install --systemz' Or run in foreground: hermes gateway) is_containerz,Start the gateway to bring your bots online:z> hermes gateway run # Run as container main processrAz4For automatic restarts, use a Docker restart policy:z* docker run --restart unless-stopped ...z/ docker restart # Manual restartz2 hermes gateway # Run in foreground)0rxrrrrZr\rWrrrrrdanyr]rQr^rupperrTrrrrrrrrrrrrrrrrrrr hermes_clirrr[rrfrrFrr)0r rr platformsrrrplatrrr any_messaging missing_homer _is_linux _is_macos _is_windowsrrrrrrrrrrrrrrrrrservice_installedservice_runningsupports_systemdsupports_service_managerrrZlinesvc_nameinstalled_scope did_installstarted_inlinerrrs0 @@r setup_gatewayr_sy XXXXXXXXXX&'''RSSS7888 GGG  I ELY''##4!!$'' W CCW CC&CCCDDD \ ! !    " " " @%VVH Z[[[,,IcN++++  S T    3A>3C3CM| :7888 - . . ,} #8 8  ,    + + + , - - +m "7 7  +    * * * * + + )MBV4W4W )    ( ( ( 1 2 2 /=Ic;d;d /    . . .  % % ) . / / )3@AR3S3S )    ( ( (   GGG Odii 6M6MOO P P P P Q Q Q K L L L J K K K$  VdjjllVVV %$$$$$&&'1 $$&&(2 &&((I5                                       (2133--//4466#3#Oy#OK     = = ? ?  0 0 2 2 2 GGG   7 7 9 9  % % ' ' ' GGG n Q :$H$H$J$J :// ::::JDQQ ::'2'))))"2'))))$2>>>>>>'//1112+++ RSSS #A 1 1 3 3++k4kk****+++++3???  8Q 8 899933I>>>>>>>> ::: 8Q 8 899999999:) :,U Q 8$H$H$J$J 8//8888=tDD 88'0% "0% $0>>>>>>'--///2+++ PQQQ #A 1 1 3 3++k4kk****+++++3=== 61 6 677733G<<<<<<<< 888 61 6 6777777778! 8$&@ Q ,$ ,$+fhfff- F$Q&*O"'K%*N' .7W7W^c7d7d7d4" .'e4444&* ?>>>>>'//e/<<<&* )-GGG"@>@mLfhl>m>m@ @/0 - _5P Q Q Q Q Q!*0 - :333'(XYYY(+A(9(9(;(;33 %k4kk 2 2 2 233333;EEE'(>1(>(>???;;GDDDDDDDD(@@@'(>1(>(>????????@ QQQ 8Q 8 8999OPPPPPPPPQLMMM#dbcccDEEEE 5 5 5 5 5 5|~~ QIJJJ[\\\2QRRRGHHHLMMMMIJJJOPPP:y||s6QS, ARS,S S,S''S,6UW;AV&&W;.W W;W66W;%A+]Z10]1]6A\;]]\*%]* ]7] ]]] ^ !!^^  first_installc,ddlm}|||dS)uConfigure tools — delegates to the unified tools_command() in tools_config.py. Both `hermes setup tools` and `hermes tools` use the same flow: platform selection → toolset toggles → provider/API key configuration. Args: first_install: When True, uses the simplified first-install flow (no platform menu, prompts for all unconfigured API keys). r) tools_command)rr N)hermes_cli.tools_configr)r rrs r setup_toolsrO s1655555M f======rc ddlm}|rdSn#t$rYnwxYw ddlm}n#t$ri}YnwxYwdtfd}t |t r|dnd}t |t ro|d pd  }||vr|||rdS|d krd D]}t|rdSd D]}t|rdS| D]\}}|d kr ||rdSdS)uReturn True when any known inference provider has usable credentials. Sources of truth: * ``PROVIDER_REGISTRY`` in ``hermes_cli.auth`` — lists every supported provider along with its ``api_key_env_vars``. * ``active_provider`` in the auth store — covers OAuth device-code / external-OAuth providers (Nous, Codex, Qwen, Gemini CLI, ...). * The legacy OpenRouter aggregator env vars, which route generic ``OPENAI_API_KEY`` / ``OPENROUTER_API_KEY`` values through OpenRouter. rget_active_providerTr&r cL|jD]}|dkr t|rdSdS)NCLAUDE_CODE_OAUTH_TOKENTF)api_key_env_varsrQ)r,env_vars r_has_keyz0_model_section_has_credentials.._has_keyz sF/  G333W%% tt urrNrrAr%)rrr6F) r*rrfr'rdrrrrrBrQr) r rr'r model_cfg provider_idrpidr,s r_model_section_has_credentialsrc s 777777    4       5555555 T(2&$'?'?I 7###TI)T""  }}Z006B==??EEGG + + +x)+677 t , & &C   )) 44 <  ! ! 44 *//11 W )    8G   44  5s ""- <<rcf|ddd}|p|S)zFStrip trailing parenthetical qualifiers from a gateway platform label.(rqr)r-r)rbases r_gateway_platform_short_labelr s0 ;;sA  q ! ' ' ) )D =5r section_keyc|dkrt|sdS|d}t|tr(|r|St|t r9t|dp|dpdSdS|dkrt |ddd}d |S|d krt |d d d }d |S|dkr7ddlm}m fd|D}|rd |SdS|dkrg}tdr| dtdr| dtdr| d|rd |SdSdS)a)Return a short summary if a setup section is already configured, else None. Used after OpenClaw migration to detect which sections can be skipped. ``get_env_value`` is the module-level import from hermes_cli.config so that test patches on ``setup_mod.get_env_value`` take effect. rNrrrrrrz backend: r?rrz max turns: gatewayr)rrcng|]1}|r$|dkt|d2S)rr)r)rrrs rrz/_get_section_config_summary.. s[   %% +;*:4*@*@DT*T*T *$w- 8 8*T*T*TrrrrzTTS/ElevenLabsBROWSERBASE_API_KEYBrowserFIRECRAWL_API_KEY Firecrawl) rrrrrrrHrxrrrrQr) r rrrrrrrrs @r_get_section_config_summaryr sg-f55 4 7## eS ! ! !ekkmm !;;== eT " " Suyy++Quyy/A/AQ\RR R|  " "&*iIII$7$$$   FG["EEE (Y(((  ! !GGGGGGGG     &((    )99Z(( (t    - . . + LL) * * * . / / $ LL # # # , - - & LL % % %  $99U## #t 4rct||}|sdSttd|d|td|dd S)zShow an already-configured section summary and offer to skip. Returns True if the user chose to skip, False if the section should run. Frrpz Reconfigure ?r)rrWr]rrB)r rrsummarys r_skip_configured_sectionr sr*&+>>G u GGG)u))))***>ekkmm>>>NNN NNrzoptional-skills migrationzopenclaw-migrationscriptszopenclaw_to_hermes.pyctsdStjdt}||jdStj|}ddl}||j|j < |j |n/#t$r"|j |j dwxYw|S)zLoad the openclaw_to_hermes migration script as a module. Returns the loaded module, or None if the script can't be loaded. Nopenclaw_to_hermesr) _OPENCLAW_SCRIPTexistsrrspec_from_file_locationloadermodule_from_specrcmodulesr exec_modulerfr)specmod_syss r_load_openclaw_migration_moduler s  " " $ $t > 1 1.  D |t{*t . ) )$ / /C!DL $$$$  D)))  Js ?B,Cu\⚠ Gateway/messaging — this will configure Hermes to use your OpenClaw messaging channelsuE⚠ Telegram — this will point Hermes at your OpenClaw Telegram botuE⚠ Slack — this will point Hermes at your OpenClaw Slack workspaceuC⚠ Discord — this will point Hermes at your OpenClaw Discord botuL⚠ WhatsApp — this will point Hermes at your OpenClaw WhatsApp connectionuM⚠ Config values — OpenClaw settings may not map 1:1 to Hermes equivalentsuO⚠ Instruction file — may contain OpenClaw-specific setup/restart proceduresuJ⚠ Memory/context file — may reference OpenClaw-specific infrastructureu?⚠ Context file — may contain OpenClaw-specific instructions) rtelegramslackdiscordwhatsappr soulmemorycontextreportc4|dg}|stddSd|D}d|D}d|D}t}|rEtt dt j|D] }|dd }|d d }|rXt|ttj d } td |dd| ntd || } t| } t D]"\} } | | vs| | vr|| #t|r|tt dt j|D]D}|dd }|dd}td |dd|Et|r|tt dt j|D]D}|dd }|dd }td |dd|Et|rtt dt jt#|D],} tt d| t j-ttt dt jtt dt jtt dt jtdSdS)zPrint a detailed dry-run preview of what migration would do. Groups items by category and adds explicit warnings for high-impact changes like gateway token takeover and config value differences. rzNothing to migrate.NcDg|]}|ddk|S)rmigratedrrrs rrz,_print_migration_preview..2 ,HHHA!%%//Z*G*Ga*G*G*GrcDg|]}|ddk|S)rconflictrrs rrz,_print_migration_preview..3 rrcDg|]}|ddk|S)rskippedrrs rrz,_print_migration_preview..4 s,FFF1xI)E)EQ)E)E)Erz Would import:kindunknown destinationrA~rz<22s → z: Would overwrite (conflicts with existing Hermes config):rhzalready existsrz Would skip:u ── Warnings ──z zF Note: OpenClaw config values may have different semantics in Hermes.uM For example, OpenClaw's tool_call_execution: "auto" ≠ Hermes's yolo mode.zL Instruction files (.md) from OpenClaw may contain incompatible procedures.)rr\rrWrTrSrrr,rrrB_HIGH_IMPACT_KIND_KEYWORDSraddrrrr)rrmigrated_itemsconflict_items skipped_itemswarnings_shownitemr dest dest_short kind_lower dest_lowerkeywordwarningrhs r_print_migration_previewr' s JJw # #E ()))HHHHHNHHHHHNFFFFFMUUN e%v|44555" 0 0D88FI..D88M2..D ' YY..s49;;/?/?EE ;t;;;z;;<<<<otoo&&&JT**J$>$D$D$F$F 0 0 j((Gz,A,A"&&w/// 0  ePRXR_``aaa" 2 2D88FI..DXXh(899F 0400000 1 1 1 1  eOVZ00111! 2 2D88FI..DXXh++F 0400000 1 1 1 1  e. >>???n-- : :G %(w((&-88 9 9 9 9  e\^d^kllmmm eegmgtuuvvv ebdjdqrrsss rrc  tjdz }|sdStsdSt t dtd|tdt tddstd dSt}|stt t}|td dSnF#t$r9}td |td dYd }~dSd }~wwxYw |d d d}|||dd ddd |d }|}nF#t$r9}td|tddYd }~dSd }~wwxYw|di}|dd} | dkrt tddSt t d| dtdt t-|tdds tdtddS |||dd ddd |d } | } nF#t$r9}td|tddYd }~dSd }~wwxYw| di} | dd} | d d}| d!d}| d"d}t | rt/d#| d$|rtd%|d&|rtd%|d'|rt|d(| d)}|rtd*|t/d+dS),aDetect ~/.openclaw and offer to migrate during first-time setup. Runs a dry-run first to show the user exactly what would be imported, overwritten, or taken over. Only executes after explicit confirmation. Returns True if migration ran successfully, False otherwise. z .openclawFzOpenClaw Installation DetectedzFound OpenClaw data at zDHermes can preview what would be imported before making any changes.z+Would you like to see what can be imported?TrzLSkipping migration. You can run it later with: hermes claw migrate --dry-runNz Could not load migration script.z!Could not load migration script: z$OpenClaw migration module load error)exc_infofull)preset) source_root target_rootexecuteworkspace_target overwritemigrate_secrets output_dirselected_options preset_namezMigration preview failed: z OpenClaw migration preview errorrrrz Nothing to import from OpenClaw.uMigration Preview — z item(s) would be importedz5No changes have been made yet. Review the list below:zProceed with migration?zCMigration cancelled. You can run it later with: hermes claw migratezIUse --dry-run to preview again, or --preset minimal for a lighter import.zMigration failed: zOpenClaw migration errorr rerrorz Imported z item(s) from OpenClaw.zSkipped zU item(s) that already exist in Hermes (use hermes claw migrate --overwrite to force).z" item(s) (not found or unchanged).u3 item(s) had errors — check the migration report.r'zFull report saved to: z,Migration complete! Continuing with setup...)rris_dirrrrWrZr\rrKrNrMrr^rfr3r4resolve_selected_optionsMigratorresolvemigraterrr])r openclaw_dir config_pathrrZr dry_migratorpreview_reportpreview_summary preview_countmigratorrrrr  conflictserrorsr's r_offer_openclaw_migrationr9g s49;;,L    u  " " $ $u GGG1222777888UVVV GGG FPT U U U Z   u"##K     #KMM"""-// ; < = = =5  =!==>>> ;d KKKuuuuu //d6/JJ||$,,..#++--! %$   &--// 6166777 7$ GGGuuuuu %((B77O#'' A66M 5666u GGGS-SSSTTTFGGG GGG^,,, 2E B B B Q     W   u<<$,,..#++--! %   !!## .1../// /$ ???uuuuu jjB''G{{:q))Hkk)Q''G J**I [[! $ $F GGGEC(CCCDDD@~i~~~KIgIIIJJJ VTTTUUUL))J:8J88999@AAA 4sJ4D E .EEA.G H.H  H"AL99 M<.M77M<rModel & ProviderrzText-to-SpeechrrrzMessaging Platforms (Gateway)rToolsr?rcddlm}tttdtjttdtjttdtjtt dt dt dtt d t dd lm}||n#tttf$r0tt d t d Yd St$rU}td|ttd|t d Yd }~d Sd }~wwxYw |}t!|t"r)|||n#t$rYnwxYwtt)dt dt dd S)uOne-shot Nous Portal setup — OAuth + model pick + provider + Tool Gateway. Wired into ``hermes setup --portal`` and ``hermes portal``. This is the Nous-Portal slice of the first-time quick setup, collapsed into a single shareable command so a brand-new user goes from zero to a fully working Hermes session — model selected, provider set, and web/image/tts/browser tools routed via their Portal sub — without being told to run ``hermes setup`` and hunt for the quick-setup option. The login + model selection + provider switch + Tool Gateway opt-in are all delegated to ``_model_flow_nous`` — the exact same flow quick setup uses (``_run_first_time_quick_setup``) and the same one ``hermes model`` runs when you pick Nous. Routing through it (instead of hand-rolling the auth + provider write here) means ``hermes portal`` always offers a model picker, and there is a single source of truth for the Nous onboarding steps. rrMruC│ ⚕ Hermes Setup — Nous Portal (one-shot) │rz7 One subscription, 300+ models, plus the Tool Gateway:z9 web search, image generation, TTS, browser automationu0 — all routed through your Nous Portal sub.z> Sign up: https://portal.nousresearch.com/manage-subscription_model_flow_nousz Setup cancelled.z+ You can retry later with `hermes portal`.Nz1_model_flow_nous error during `hermes portal`: %sz* Nous Portal setup encountered an error: zPortal setup complete.z. Run `hermes portal info` to inspect routing.z! Run `hermes` to start chatting.)r/rMrWrTrSMAGENTAr\r1r?rurvr2rfr3r4r[rrr5r6r])r rMr?r7r8s r_run_portal_one_shotrA so".----- GGG   @ N    %UW]We f fggg   @ N    GGGHIIIJKKKABBB GGGOPPP GGG444444    x 4    '(((@AAA  H#NNN FFFGGG@AAA   []] j$ ' ' & LLNNN MM* % % %       GGG*+++?@@@233333s31DAF' F'A F""F'+AG44 HHcTddlm}m}|r |ddStt t |dd}|r5t tjttdt t |dd}t t |d d}t}t}t}|rldd lm} |d | d } ddl} | j|| n#t*$rd} YnwxYwd} t |d d} | st-sd} | rt/ddSt t |ddrt1|dSt |dd} | r!t2D]\}}}|| krt5t5t7dt8jt5t7d|ddt8jt5t7dt8j||t |t5t|ddSt=d| t?dd dt2DdSddl!m"}|}t tGdpt tGdp|du}t5t5t7dt8jt5t7dt8jt5t7d t8jt5t7d!t8jt5t7d"t8jt5t7dt8jd}|r|rtI||dSt5tKd#td$t?d%t?d&t?d't?d(t?d)nzt5|s|rt?d*t5tM|}|rt}tOd+d,d-gd}|dkrtQ|||dStKd.t?d/tt?d0tSt?d1|t?d2tTt5t?d3|r;t5t?d4t?d5t?d6|rtW|d7d8stY||rtW|d9d:st[||st]||rtW|d;d<st_||rtW|d=d>sta|| ?t || rJ| r6t?d@| t?dAt?dB| dC|tc||dS)DuRun the interactive setup wizard. Supports full, quick, and section-specific setup: hermes setup — full or quick (auto-detected) hermes setup model — just model/provider hermes setup tts — just text-to-speech hermes setup terminal — just terminal backend hermes setup gateway — just messaging platforms hermes setup tools — just tool configuration hermes setup agent — just agent settings r) is_managed managed_errorzrun setup wizardNresetFz Configuration reset to defaults. reconfigurer*)datetimez .yaml.bak.z %Y%m%d_%H%M%Snon_interactiveTz;Running in a non-interactive environment (no TTY detected).portalsectionru│ ⚕ Hermes Setup — z<34su │rz configuration complete!zUnknown setup section: zAvailable sections: rc3"K|] \}}}|V dSrr)rkrs rrz#run_setup_wizard.. s(3T3T'!QA3T3T3T3T3T3TrrrOPENAI_BASE_URLu@│ ⚕ Hermes Agent Setup Wizard │u├─────────────────────────────────────────────────────────┤u>│ Let's configure your Hermes Agent installation. │u>│ Press Ctrl+C at any time to exit. │ Reconfigurez#You already have Hermes configured.uARunning the full wizard — each prompt shows your current value.z9Press Enter to keep it, or type a new value to change it.rAzBTip: jump straight to a section with 'hermes setup model|terminal|zC gateway|tools|agent', or fill only missing items with --quick.u=No existing configuration found — running first-time setup.z$How would you like to set up Hermes?uXQuick Setup (Nous Portal) — free OAuth login, no API keys, model + tools (recommended)uUFull setup — configure every provider, tool & option yourself (bring your own keys)zConfiguration LocationzConfig file: zSecrets file: zData folder: zInstall dir: z=You can edit these files directly or use 'hermes config edit'z%Settings were imported from OpenClaw.uGEach section below will show what was imported — press Enter to keep,z#or choose to reconfigure if needed.rr:rrrrrr;)rzPrevious config backed up to: z9If setup changed a value you customized, restore it with:z cp r)2r/rCrDrRrdrbrNcopydeepcopyrIr]rMrJrKrrG with_suffixnowstrftimer?copy2rfrgrjrASETUP_SECTIONSrWrTrSr@r[r\rr*rrQ_run_quick_setuprZr9r_run_first_time_quick_setuprL PROJECT_ROOTrr;rrrrr)argsrCrDreset_requestedreconfigure_requestedquick_requestedr rr1_dt _backup_pathr?rHrJkeyrfuncractive_provider is_existing migration_ran setup_modes rrun_setup_wizardreN s6<;;;;;;;z|| ()))74%8899O:DM.112228999 }e!D!DEE74%8899O ]]F!##K"##K ,,,,,,".. >++O<< > >   MMM FLl 3 3 3 3   LLL  d$5u==O #7#9#9+ I     GD(E * *++V$$$dIt,,G .   Cg~~L eLELLLLfn]]^^^L V F###@@@AAA'* 7g77888V$))3T3T^3T3T3T*T*TVVWWW433333))++O ]/ 0 011 '  /00 1 1 ' $ &  GGG   @ N     NPVP^      @ N     Lfn     Lfn      @ N  M/   V[ 1 1 1 F ]###;<<<VWWWNOOO2WXXXXYYYY  ! O  V W W W GGG2+>>  # ]]F" 2jg      ?? ' [ I I I F)***3 1 1334440 00111- --.... ../// GGGNOOO: :;;;\]]]8999 %6vwHZ[[%V$$$ '6vzK]^^'v&&& .%f--- 6vyJ_``f ;6vwPP;Fk/::::9 ++--9BLBBCCCNOOO7<77+77888-----sE E&%E&rbcddlm}ttdt dt dt dt ddlm}||n#ttf$r tt dYnRt$rF}t d |td |t d Yd }~nd }~wwxYw|}| ||t|t!|t#|tt%d ddgd}|dkrt'|t#|tt)dtt d|dkrt dtt+||d S)uStreamlined first-time setup via Nous Portal: OAuth, model, terminal & messaging. Routes straight to the Nous Portal provider — runs the device-code OAuth login, picks a Nous model, then configures the terminal backend and (optionally) a messaging platform. Applies sensible defaults for everything else (agent settings, tools); the user can customize later via ``hermes setup
`` or switch providers with ``hermes model``. rr=z Nous Portalz5One subscription, 300+ models, plus the Tool Gateway:z8 web search, image generation, TTS, browser automation.zzNous Portal setup cancelled.z-_model_flow_nous error during quick setup: %sz(Nous Portal setup encountered an error: r.Nz7Connect a messaging platform? (Telegram, Discord, etc.)z"Set up messaging now (recommended)u1Skip — set up later with 'hermes setup gateway'z#Setup complete! You're ready to go.z) Configure all settings: hermes setupz1 Connect Telegram/Discord: hermes setup gateway)r/rMrWrZr\r1r?rurvrfr3r4r^r5r6rrrNrrr]r)r rrbrMr?r7r8gateway_choices rrWrW5 sL.-----  GGGFGGGIJJJMNNN GGG A444444    x (333 122222 AAA DcJJJFFFGGG?@@@@@@@@AJ LLNNN MM*6""""&))) GGG"A 0 ?  NfF GGG7888 GGG:;;;FGGG GGG-----s A22.C1" C1+. s9m@T@T rF) required_onlyc<g|]}|d|Srmrros rrz$_run_quick_setup.. s9AEE-DXDX rz(Everything is configured! Nothing to do.z:Run 'hermes setup' and choose 'Full Setup' to reconfigure,z)or pick a specific section from the menu.Nz required setting(s) missing:u • rrrrArz Get key at: rlr{Trz Saved z Skipped cDg|]}|ddk|S)categorytoolrros rrz$_run_quick_setup.. s.PPP1AEE*4E4E4O4OQ4O4O4Orcng|]2}|ddk|d0|3S)rt messagingadvancedrros rrz$_run_quick_setup.. sJ 55   + +AEE*4E4E + + + +rz Tool API Keysrrrrz(Which tools would you like to configure?rz7Connect Hermes to messaging apps to chat from anywhere.z:You can configure these later with 'hermes setup gateway'.TELEGRAMr"DISCORDrSLACKr9cBg|]}dddd||S)u 📱 Telegramu 💬 Discordu 💼 Slackr"rr9r)rrs rrz$_run_quick_setup.. sI    ,)%  c!Qii    rz)Which platforms would you like to set up?u📱u💬u💼r}rrrrz SkippedzAdding z& new config option(s) with defaults...z Added r_z = r_config_version)r/rirjrkrWrZr]r\rrTrSrXrr{rOr^rrrrrrNr)r rrirjrkmissing_requiredmissing_optionalmissing_config current_ver latest_verhas_anything_missingrry missing_toolsmissing_messagingchecklist_labelsrrselected_indicesrplatform_orderrrrplatform_labels vars_listrfields rrVrV~ s}  GGG5666''e<<<''e<<</.00N2244K  $  $  $  #  @AAA OPPP>???: c*++JJJKKK# - -C +c&k++ , , , , # : :C GGG %*S[**FK88 9 9 9 8CGGM26688 9 9 9wwu~~ :8CJ88999wwz"" FDCGGHc&k$B$BDDtTTTDCGGHc&k$B$BDDEE :s6{E2226V66777783v;889999QP 0PPPM!! _%%%  Y YCGGGR((E:?G6 %) 4 4666RI  # #sww}c&k'J'J$WI$W$W X X X X+ 6    $ ! !C$C C 9 *+++LMMMOPPP $ 7 7Cv;DT!!!d"" D9$$%%d+++  r * * 1 1# 6 6 6 6  $    , 7    $  C!#&D!$I!'FVLLPPQUWYZZE GGG %?u??t???MM N N N GGG  < r : :<<===775>>20CJ0011177:&&J"#H#f+(F(F#H#HSWXXXEE"#H#f+(F(F#H#HIIE/"3v;666!-0000!+...     Qc.)) Q Q Q   $ J JE HU5\HHeI6FHH I I I I%/ !F-----rr)NF)rN)T)F)v__doc__importlib.utilrloggingrrer?rcrOpathlibrtypingrrrhermes_cli.nous_subscriptionrrrutilsr rr getLogger__name__r3__file__rNr.rXr0rrrr"rdr-_DEFAULT_PROVIDER_MODELSrDrGr/rHrIrJrKrLrMrNrOrPrQrRhermes_cli.colorsrSrTrZhermes_cli.cli_outputr[r\r]r^hermes_cli.secret_promptr_rgrjr{compiler}rtlistrrrrrrrrr)r;rAr[r_rdrrrrrrrrrrrr r7rAr>rkrurwrrrrrrrrrrrr9rUrArerWrVrrrrs    &&&&&&&&&&GGGGGGAAAAAA######444444  8 $ $tH~~$+3355 9 tCH~$sCx.DDcNDtCH~DDDD 6$sCx.6C6SV6[_6666 A A A A A A"  G F FZZZ]]] "78 P P PMMMPPP___}}}NNNC&&Rd38n+$sCx.+#+$++++                          ,+++++++;;;;;  :99999d  d  d    &S3#(&2:&DEE3#3#3333mmCm$mmWZ]aWammpmmmm((C($((sUYz(eh((((V//C/$/$////0CDD:IIIII8[ [ [ [ [ |' ' ' ' ' h9>66666666|W$WWWW /d////d2     #####LiUiUiUiUiUX d    gB4gBgBgBgB^ A$AAAA8iiiiib$$?@@555555EEE$,cDj,,,, C$J    kBkBkB\ACACACH( ( ( Vq:q:q:h>V>V>VB ,E,E,E^h$hhhh` > > >T > > > >(;4;D;;;;| 44348C=4444n O  O" O+. O  O O O O*L+<<== @nW TT^] ]ZP  =T====@B4BDBBBBT  "67 i(#%;</? g{#  45 Q4Q4$Q4Q4Q4Q4hd.d.d.NF.F.F.F.F.F.Rc.Tc.c.c.c.c.c.r