idZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z m Z ddlmZddlmZddlmZejeZe ejjZdZd e ee fd e ee ffd Zd e ee fd e eeffd Zd e ee fd eded dfdZd ed e fdZ!dggdgdgdgdgdgdgdgdgdgdgdgdgddZ"d e ee fd efdZ#d e ee fded dfd Z$dd!l%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.dd"l/m0Z0m1Z1d#efd$Z2dd%l3m4Z4m5Z5m6Z6m7Z7d e fd&Z8dd'edzd dfd(Z9dd*ed+ed,e d efd-Z:dd*ed.e;d+edd*ed+e d e fd3Z?dd#ed4e;d5e;d e;fd6Z@d7eAfd8ZBd eAfd9ZCd eAfd:ZDd)d;d eAdZFd e fd?ZGd eAfd@ZHd eAfdAZId eAfdBZJd eAfdCZKd eAfdDZLdEZMdFZNdGed e;fdHZOdIZPdJZQdKZRdLZSdMZTdNZUdOZVdPZWdQZXdRZYdSZZdTZ[dUZ\dVZ]dWZ\dXZ^dYdZeMfd[d\eNfd]d^ePfd_d`eUfdadbeVfdcddeWfdedfeQfdgdheRfdidjeSfdkdleXfdmdneYfdodpeZfdqdre[fdsdteTfdudve]fdwdxe\fdydze^fgZ_d eAfd{Z`dd eAd|e fd}Zad eAd~ed e efdZbd eAd~eded e fdZceedz dz dz dz dz ZddZedddddddddd ZfdeAfdZgde d e fdZhddeEfddeIfddeJfdde`fddeafddeLfgZigdZjdZkd e e;efdZldZmd eAde fdZnd eAfdZodS)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)get_optional_skills_dirz*https://hermes-agent.nousresearch.com/docsconfigreturnc|d}t|trt|St|tr*|rd|iSiS)Nmodeldefault)get isinstancedictstrstrip)r current_models 8/home/agentuser/.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 rrrs r_set_credential_pool_strategyr!0s7 088J#Jx+5F '(((rcv|r|dkrdS|dkrdSddlm}||}|sdS|jdvS)NcustomF openrouterTr)PROVIDER_REGISTRY>api_keyoauth_device_code)hermes_cli.authr%r auth_type)rr%pconfigs r"_supports_same_provider_pool_setupr+8sj 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-codexgpt-4.1gpt-4o gpt-4o-minizclaude-opus-4.6zclaude-sonnet-4.6zclaude-sonnet-4.5zclaude-haiku-4.5gemini-2.5-prozgrok-code-fast-1)zgemini-3.1-pro-previewzgemini-3-flash-previewzgemini-3.1-flash-lite-previewr2zgemini-2.5-flashzgemini-2.5-flash-litezgemma-4-31b-itzgemma-4-26b-it)glm-5.1glm-5zglm-4.7zglm-4.5z glm-4.5-flash) kimi-k2.5zkimi-k2-thinkingzkimi-k2-turbo-preview)ztrinity-large-thinkingztrinity-large-previewz trinity-mini)z MiniMax-M2.7z MiniMax-M2.5z MiniMax-M2.1z MiniMax-M2)anthropic/claude-opus-4.6anthropic/claude-sonnet-4.6z openai/gpt-5zgoogle/gemini-3-flash)r6r7zopenai/gpt-5.4zgoogle/gemini-3-pro-previewzgoogle/gemini-3-flash-preview)r-r.zclaude-sonnet-4-6zgemini-3-flashr4r5 minimax-m2.7)r3r4r5z mimo-v2-proz mimo-v2-omniz minimax-m2.5r8)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,copilotgeminizai kimi-codingkimi-coding-cnarceeminimax minimax-cn ai-gatewaykilocodez opencode-zenz opencode-go huggingfacec|d}t|trHt|dpdSdS)Nagentreasoning_effort)rrrrrlower)r agent_cfgs r_current_reasoning_effortrJrsc 7##I)T""L9==!344:;;AACCIIKKK 2reffortcr|d}t|tsi}||d<||d<dS)NrErFr)r rKrIs r_set_reasoning_effortrMysD 7##I i & &$ #w$*I !!!r) DEFAULT_CONFIGget_hermes_homeget_config_path get_env_path load_config save_configsave_env_value get_env_valueensure_hermes_home)Colorscolortitlectttd|tjtjdS)zPrint a section header.u◆ N)printrXrWCYANBOLD)rYs r print_headerr^s5 GGG %u V[ 9 9:::::r) print_error print_info print_success print_warningcttdd}|dS t|S#t$rYdSwxYw)z;Return True when stdin looks like a usable interactive TTY.stdinNF)getattrsysboolisatty Exception)rds ris_interactive_stdinrjsZ 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)r[rXrWr\r]r`)rks r#print_noninteractive_setup_guidancerms GGG %;V[&+ V VWWW GGG 6<=== GGGQRRR:;;;LMMMBCCC GGGPQQQVWWW GGGGGrFquestionrpasswordc~|r |d|d}n|d} |r2ddl}|t|tj}n't t|tj}|p|pdS#t tf$r&ttj dYdSwxYw)z'Prompt for input with optional default. []: : rNrG) getpassrXrWYELLOWinputrKeyboardInterruptEOFErrorr[rfexit)rnrrodisplayruvalues rpromptr}s"-----///   9 NNNOOE'6=$A$ABBEE%7788E{{}}--2- x (   sA2B3B<;B<choices descriptionc.ddlm}||||d|S)z?Single-select menu using curses. Delegates to curses_radiolist.r)curses_radiolist)selectedcancel_returnsr)hermes_cli.curses_uir)rnr~rrrs 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 (rtz) Ctrl+C to exitTz Select [1-z] (z): z$Please enter a number between 1 and zPlease enter a number)rr`r[rXrWrv enumerateGREENrwlenDIMintr_ ValueErrorrxryrfrz) rnr~rridxichoicemarkerr|s 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/NTrqrrrt)yyes)nnoFzPlease enter 'y' or 'n') rwrXrWrvrrHrxryr[rfrzr_)rnr default_strr|s 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 simple_term_menu is unavailable. Returns: List of selected indices (not including the Continue option). Nr)curses_checklist)r)rrsetsorted)rYrrrchosens rprompt_checklistrsb 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: rorr}Tro ✓ Savedz/ Skipped (configure later with 'hermes setup')) rjoinrr[rXrWr\r`r}rTrarb)rr tools_strr|s r_prompt_api_keyr<s GGGR E %)$$I 5zzA~~03u::>0000  GGG %Nsww}c&kBBNNNPVP[ \ \]]] GGG.,,,--- wwu~~75U55666 GGG wwz>n*t+r|jr|d?td@r%tdAr|dBn:td@r|dCn|dDtdEr|dFtdGr|dHn|dI|dJ|dK|dLt/dM|D} t1|} t3| dN| dOt|D]\}}}|r.tdPt5dQt6jdR|6tdPt5dSt6jdR|dRt5dT|d t6jtdU|D}|r>t?dVddWl m!}t?dX|dYtttt5dZt6jtt5d[t6jtt5d\t6jtddWl m!}tt5d]|d^t6j"t6j#ttdPt5d_t6j$d`tKtdPt5dat6j$d`tMtdPt5dbt6j$dc|ddttt5det6jttt5dft6j"t6j#ttdPt5dgt6jdhtdPt5dit6jdjtdPt5dkt6jdltdPt5dmt6jdntdPt5dot6jdpttdPt5dqt6jdrtdPt5dst6jdttdPt5dut6jtdvttdwtdPt5dxtKt6jtdPt5dxtMt6jttt5det6jttt5dyt6j"t6j#ttdPt5dzt6jd{tdPt5d|t6jd}tdPt5d~t6jdtdS)z#Print the setup completion summary.zTool Availability Summaryrget_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)rFzUEXA_API_KEY, PARALLEL_API_KEY, FIRECRAWL_API_KEY/FIRECRAWL_API_URL, or TAVILY_API_KEY)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 browserznpm install -g agent-browserF)z$Image Generation (Nous subscription)TN)Image GenerationTN)rFFAL_KEYttsredge)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)TNr:GEMINI_API_KEYGOOGLE_API_KEY)zText-to-Speech (Google Gemini)TNneutts)zText-to-Speech (NeuTTS local)TN)u)Text-to-Speech (NeuTTS — not installed)Fzrun 'hermes setup tts')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)TNTINKER_API_KEY WANDB_API_KEY)RL Training (Tinker)TN)rFr)rFr HASS_TOKEN)zSmart Home (Home Assistant)TN GITHUB_TOKEN)Skills Hub (GitHub)TN)rFr)zTerminal/CommandsTN)zTask Planning (todo)TN)zSkills (view, create, edit)TNc3&K|] \}}}|dV dS)rtN).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)'r[r^ragent.auxiliary_clientrriappendrUwebmanaged_by_nous availablecurrent_providerbrowser image_genrrimportlib.utilutil find_specrdirect_overridernous_auth_presentsumrr`rXrWrREDrrbhermes_constantsrr\r]rvrPrQ)r hermes_home tool_statussubscription_featuresr_vision_backendslabelbrowser_providermissing_browser_hint tts_provider importlib neutts_okavailable_count total_countrr missing_vardisabled_tools_dhhs r_print_setup_summaryrXs  GGG,---K:6BBHHHHHH88:: bBCCCC`aaa)**O<====MNNN 0USTTTT  " ,U& $ 5 [Z-B-F-WZZZEE4.////T U U U-4E$4 PQQQQ  & 0 $  ?>+;>>>EE4.////w } , ,= !  . .J !  * *#0  0 0#A  !5*> ?   &6COPPPP  ( 2C;<<<<ABBB::eR((,,Z@@L 0FXYYYY  % %-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 nDEEE"2]NOOOO J # # ' ' 2 2g = = & 6 Z   M N N N N   X Y Y Y Y # % %]*?*Q][\\\%&&N=+I+IN?@@@@ ' ( (NKLLLLLMMM\""HFGGG^$$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 GGGGGs#A AA2 N N"!N"c<|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))rtruer1 container_cpurtz CPU corescontainer_memoryiz Memory in MB (5120 = 5GB)container_diskiz Disk in MB (51200 = 50GB)N) setdefaultr[r`rr}rHrfloatrr) 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 FFquickrc8 ddlm}m}tdt dt dt dt ddlm} |n#ttf$r t t dYnRt$rF}t d |td |t d Yd }~nd }~wwxYw|}|d |d |d <d|vr |d|d<n|dd d }|d }t#|t$r|d}|dk} |s:t'|r* ddlm} ddlm} ddlm} | |} | }t7|}t9d|D}||z }t tdt dt dt dt |dkrt d|d|d|d|d nt d|d|t;ddrp| | |d d d d d d d dd!dd d"# | |} t7| }t d$|d%t;ddp|d&krgd'}t=||d(}dd&d)d*|d}t?d+||}gd*|}tA|||tCd,|d-|n2#t$r%}t d.|Yd }~nd }~wwxYw|rd}nS dd/l"m#}tI|}n#t$rtI}YnwxYwtK| }||vrd}|rXd0d1d2d3d4d5d6d7d8d9d:d; }|||pd<}t td=t d>|t d?t d@t gdA}t?dB|d)}|dkrWtMdCdDE'}|r!tQdF|tCdGnvt dHne|d&krOtMdI'pdJ}dK} dL|)vrdM} tM| dDE'}!|!rtQdN|!|*dOi*dPi}"||"dQ<dL|)vr9gdR}#|#dSgz}$t?dT|$d}%|%t7|#kr|#|%ndU}&n!tMdV'}&tQdW|&tCdX||&rd|&dYnd znt dHnt dZ|||s|dkrtW|d Sd Sd 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)rRrSzInference 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: z*You can try again later with: hermes modelNr custom_providersrnous)SimpleNamespace) load_pool)auth_add_commandc3|K|]7}tt|ddd3dV8dS)sourcerGmanualrtN)rre startswith)rentrys rrz'setup_model_provider..sKppUWUHVX=Y=Y9Z9Z9e9efn9o9opqpppppprz!Same-Provider Fallback & RotationzHHermes can keep multiple credentials for one provider and rotate betweenzCthem when a credential is exhausted or rate-limited. This preserveszEyour primary provider while reducing interruptions from quota issues.zCurrent pooled credentials for rsz (z manual, z$ auto-detected from env/shared auth)z2Add another credential for same-provider fallback?FrGg.@,) rr)rr& portal_url inference_url client_idscope no_browsertimeoutinsecure ca_bundlemin_key_ttl_secondszProvider pool now has z credential(s).rt)uUFill-first / sticky — keep using the first healthy credential until it is exhausteduJRound robin — rotate to the next healthy credential after each selectionu5Random — pick a random healthy credential each time fill_first)r0 round_robinrandomz'Select same-provider rotation strategy:zSaved z rotation strategy: z7Could not configure same-provider fallback in setup: %srzNous Portal API keyzGitHub CopilotzGitHub Copilot ACPz Z.AI / GLMzKimi / MoonshotzKimi / Moonshot (China)MiniMaxz MiniMax CN AnthropiczVercel AI Gatewayzyour custom endpoint) znous-apir9r,r;r<r=r?r@ anthropicrAr#z your providerz"Vision & Image Analysis (optional)z+Vision uses a separate multimodal backend. z=doesn't currently provide one Hermes can auto-use for vision,z4so choose a backend now or skip and configure later.)u<OpenRouter — uses Gemini (free tier at openrouter.ai/keys)uBOpenAI-compatible endpoint — base URL, API key, and vision modelz Skip for nowzConfigure vision:z OpenRouter API keyTrru/OpenRouter key saved — vision will use Geminiu%Skipped — vision won't be availablez Base URL (blank for OpenAI)zhttps://api.openai.com/v1z API keyzapi.openai.comz OpenAI API keyr auxiliaryvisionbase_url)r0r1r/z gpt-4.1-miniz gpt-4.1-nanozUse default (gpt-4o-mini)zSelect vision model:r1z0 Vision model (blank = use main/custom default)AUXILIARY_VISION_MODELzVision configured with ruRSkipped — add later with 'hermes setup' or configure AUXILIARY_VISION_* settings),hermes_cli.configrRrSr^r` _DOCS_BASEr[hermes_cli.mainr SystemExitrxriloggerdebugrbrpoprrr+typesragent.credential_poolrhermes_cli.auth_commandsr entriesrrrrrr!rarrrrgr}rrTrHr _setup_tts_provider)'r rrRrSrexc _refreshedselected_provider_mnous_subscription_selectedrrr poolrE entry_count manual_count auto_countstrategy_labelscurrent_strategydefault_strategy_idx strategy_idxstrategy_value_vision_needs_setuprr _prov_names _prov_display_vision_choices _vision_idx_or_key _base_url_api_key_label_oai_key_vaux_oai_vision_models _vm_choices_vm_idx_selected_vision_models' rsetup_model_providerrcqs ;:::::::%&&&?@@@?J???@@@ GGG:99999A!!#### ) *... ,----- AAA GMMMCcCCDDD?@@@@@@@@AJ nnWfjj.A.ABBF7OZ''%/0B%C!"" %t,,, G  B"d/FF:..!2f!< JY78IJJJYI Y - - - - - - 7 7 7 7 7 7 A A A A A A9.//DllnnGg,,KppgpppppL$|3J GGG < = = = Z    U    W    GGGA~~`6G``;``$``/9``` _=N__R]__``` TV[\\ R  #O!2"$" $#'&*"&"#( $!&"&,2"!y!233!$,,..11 PKPPPQQQ) TV[\\ R,Q### $C6#J#J#N#NO`bn#o#o "##$((#&** % -=#(   "I!H!H!V-f6GXXX^'8^^n^^___ Y Y Y LLRTW X X X X X X X X Y (# % L L L L L L"#@#@#B#BCC   % % %"uu    %#''7"8"88  0 0 0"' Cm-'/,7 &$-,   $(9;L;_P_``  9:::PPPQQQRSSSIJJJ     $$7!LL !  3dCCCIIKKG D3W===OPPPPBCCCC A  >??EEGGfKfI(N9??#4#444!3nt<<<BBDDH D/:::))+r::EEhPRSS$-j!#y'8'888)m)m)m&"48S7T"TK+,BKQRSSG#S);%<%<<<+733*+* .44f-g-g-m-m-o-o*79OPPP9i999OW525555UWY BCCCC k l l lK $&&00F#####$$00sI A.C CN99N>O%%P?PcRddl}|jddup|jdduS)z Check if espeak-ng is installed.rN espeak-ngespeak)shutilwhich)rgs r_check_espeak_ngriQs9MMM 6< $ $D 0 VLFL4J4JRV4VVrc ddl}ddl}tsCtt d|jdkrt dn*|jdkrt dnt dttd d r |jdkr|gd d n>|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)brewinstallre)check)chocornre-y)sudoaptrnrqrezespeak-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  |di}|dd}t|}dddddd d d d }|||}ttd t d|tg}g}t r1|jr*|d|d|gd|gd |d|dt|dz }td||} | |krdS|| } | dk} | dkr>d} t dtdstdrtd| dkr ddl } | jddu} n#t $rd} YnwxYw| rt#dnPtt 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+njtd,d} nW| dkrw| sutdptd}|sStt)d-d$*}|r!t+d|t#d.ntd,d} n| d/krxtd0}|sett)d1d$*}|r!t+d0|t#d2ndd3lm}td4|d5d} n\| d6kretd7}|sStt)d8d$*}|r!t+d7|t#d9ntd,d} n| d:krdtd;}|sRtt)dkrtd?ptd@}|satt dAt)dBd$*}|r t+d?|t#dCntd,d} d|vri|d<| |dd<t1|t#dD|| | dS)Ez@Interactive TTS provider selection with install flow for NeuTTS.rrrzEdge TTS ElevenLabsz OpenAI TTSzxAI TTSz MiniMax TTSzMistral Voxtral TTSzGoogle Gemini TTSNeuTTS)rrrxair?rr:rz"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)z$xAI TTS (Grok voices, needs 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)Keep current (rrtzSelect TTS provider:NrzKOpenAI TTS will use the managed Nous gateway and bill to your subscription.rrziDirect OpenAI credentials are still configured and may take precedence until removed from ~/.hermes/.env.rrFzNeuTTS is already installedzNeuTTS requires:uH • Python package: neutts (~50MB install + ~300MB model on first use)u, • System package: espeak-ng (phonemizer)z Install NeuTTS dependencies now?Tz9NeuTTS installation incomplete. Falling back to Edge TTS.zISkipping install. Set tts.provider to 'neutts' after installing manually.rrzElevenLabs API keyrzElevenLabs API key savedz.No API key provided. Falling back to Edge TTS.zOpenAI API key for TTSzOpenAI TTS API key savedr XAI_API_KEYzxAI API key for TTSzxAI TTS API key savedrzQNo xAI API key provided for TTS. Configure XAI_API_KEY via hermes setup model or z//.env to use xAI TTS. Falling back to Edge TTS.r?rzMiniMax API key for TTSzMiniMax TTS API key savedrrzMistral API key for TTSzMistral TTS API key savedr:rrz]>] " GGG5EEEG "7AAA89999NOOO! U   // " GGG2TBBBG "}g66656666HHHHHH0-1TVV000 " Y   !233 " GGG6FFFG "0':::9::::NOOO! Y   !233 " GGG6FFFG "0':::9::::NOOO! X   !122UmDT6U6U " GGG U V V V5EEEG "/99989999NOOO! Fu (F5M*S/*=*=h*Q*QSSTTTTTs( G GGc$t|dS)z.Standalone TTS setup (for 'hermes setup tts').N)rFr s r setup_ttsr1src &ddl}ddl}tdtdtdtdtdt |did d }|d k}gd }d d dddd}dddddd}d}|r$|dd||<||d<|dz }|} |d|d||| <td|| } || } | | krtd|dS| | did <| d kr4tdtdt td td!td"|did#d$} td%| pttj} | r | |dd#<t t!d&}|rtd' nXt#d(d)r2td*d+,}|rt%d&|td- n| d krtd.|jd }|st)d/td0ntd1||did2d3}td4|}||dd2<t%d5|t+|nV| dkrtd6|jd7p|jd}|st)d8td9ntd:||did;d<}td=|}||dd;<t%d>|t+|n| dkrtd?td@ddAlm}ddBlm}t5t7ot9|jo |d}||didC}d)}|r@dDdEg}|dFkrd}n|dGkrd}nt!dHrdnd}tdI||}|dk}|rIdF|ddC<tdJt!dHst!dKrtdLndG|ddC<tdM t=dn#t>$rtdNddl }|jdO}|r)|!|dPdQdRtDj#dgd+d+S}n'|!tDj#dTdPdQdgd+d+S}|j$dkrtdUnt)dVYnwxYwt tdWtdXt!dH}|rftdYt#dZd)rFtd[d+,} td\d+,}!| rt%dH| |!rt%dK|!nFtd[d+,} td\d+,}!| rt%dH| |!rt%dK|!t+|n| dkrMtd]td^td_td` t=dn#t>$rtdaddl }|jdO}|r)|!|dPdQdRtDj#dgd+d+S}n'|!tDj#dTdPdQdgd+d+S}|j$dkrtdbnWt)dc|j%rAtdd|j%&'deYnwxYwt t!df}"|"rRtdgt#dhd)r2tdid+,}#|#rt%df|#tdjn2tdid+,}#|#rt%df|#tdk|didld3}tdm|}||ddl<t%dn|t+|n4| dkr-tdotdpt!dqpd$}$tdr|$}%|%rt%dq|%t!dspd$}&tdt|&ptQj)dud$}'|'rt%ds|'t!dvpdw}(tdx|(})|)r|)dwkrt%dv|)t!dypd$}*ttjdzz d{z }+td||*p|+},|,rt%dy|,|%rt#d}d+rtd~ddl }gd}-|,r|-*d|,g|)r|)dwkr|-*d|)g|-|'r|'d|%n|%|-d|!|-d+d+d}|j$dkrtdn8t)d|j%&tdt%d| | dkr*t%d|ddCdtW|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.rz/developer-guide/environmentsrrlocalLinux)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)rrtr1rrtr1rr)rrrrrz.Singularity/Apptainer - HPC-friendly container singularityrrzSelect terminal backend:zKeeping current backend: zTerminal backend: Localz&Commands run directly on this machine.z)Working directory for messaging sessions:z7 When using Hermes via Telegram/Discord, this is wherezD the agent starts. CLI mode always starts in the current directory.cwdrGz Messaging working directory SUDO_PASSWORDzSudo password: configuredz???LMMM R   jjR0044UB?? 4k6USEUEUVV  ,(+F: u % %o66  9 2 3 3 3 3NPU 9##4tDDD 9"?I>>>!"7888 X % %0111"V\(++  6 5 6 6 6 L M M M M 4 44 5 5 5 :r2266 H  '77-2z>*.666#F++++ ] * *?@@@ 6< ,,K  ]0K0K - D E E E R     +++ , , , :r2266 !V  *M::27z./3U;;;#F++++ W $ $/000UVVVLLLLLLCCCCCC"& & ( ( 7 *6 2 2 D 7.-g66 # #  *)&**Z*D*D*H*H*V*VWW ! " 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#F++++ Y & &1222?@@@WXXX3444 U y ! ! ! ! U U U 2 3 3 3    !V\$''F #UIz3>9U#'( $^T5)YG#'(  A%%56666TUUU=US6=+>+>+@+@+K+K+M+Mb+QSSTTT- U2 $%677  0 > ? ? ?0%88 1 !6FFF1"#4g>>>!-0002TBBBG 00':::./// :r2266 I  (-88.3z?+/777#F++++ 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&!U11B)XX]..C1a"!a"cd|did<tddd|did<d |d id <d |d d <|diddddt|t dt dt dt dt dt ddS)zDApply recommended defaults for all agent settings without prompting.ZrE max_turnsHERMES_MAX_ITERATIONS90allr{ tool_progressT compressionenabled? threshold session_resetbothr)mode idle_minutesat_hourzApplied recommended defaults:z Max iterations: 90z Tool progress: allz Compression threshold: 0.50z5 Session reset: inactivity (1440 min) + daily (4:00)z. Run `hermes setup agent` later to customize.N)r rTupdaterSrar`rs r_apply_default_agent_settingsrs24Fgr"";/*D1118=Fi$$_56:FmR((3)-F=+& or**1133 1222%&&&%&&&.///FGGG?@@@@@rc tdtdtdtt dp6t |didd}tdtd td td |} t|}|d kr^tdt ||| did<| dd td|n#t$rtdYnwxYwtdtdtdtdtdtdtd|didd}td|}|dvrZd|vri|d<||dd<t!|td|ntd|d|dtd td!td"d#| d$id%<|d$id&d'}td(t |} t#|}d'|cxkrd)krnn ||d$d&<n#t$rYnwxYwtd*|d$d&d'td+td,td-tdtd.td/td0tdtd1tdgd2} |d3i} | d4d5}| d6d7} | d8d9} d d:d;d| | }| d3i|d krd5|d3d4<td?t | } t|}|d kr ||d3d6<n#t$rYnwxYwtd@t | } t|}d |cxkrdAkrnn ||d3d8<n#t$rYnwxYwtdB|d3d6d7dC|d3d8d9dDnU|d:krdE|d3d4<td?t | } t|}|d kr ||d3d6<n#t$rYnwxYwtdB|d3d6d7dFn|d;krdG|d3d4<td@t | } t|}d |cxkrdAkrnn ||d3d8<n#t$rYnwxYwtdH|d3d8d9dDn/|d 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 logsr{rrzTool progress mode)offnewrverbosezTool 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 settingsrrrrrrrrtr1r)ridledailynonezSession reset mode:z Inactivity timeout (minutes)z% Daily reset hour (0-23, local time)zSessions reset after z min idle or daily at z:00r z min of inactivityr zSessions reset daily at r zGSessions will never auto-reset. Context is managed only by compression.zFLong conversations will grow in cost. Use /reset manually when needed.)r^r`r<r[rUrrr}rrTr rArarrbrHrSr r)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_settingsrsv!"""AJAAABBB GGG 788C 7B##K44==KBCCCDEEEZ[[[*K88L?|$$ a<< 2CMM B B B:BF  gr * *; 7 JJ{D ) ) ) =8== > > > ???=>>>>>?rNNN&'''NOOO>???OPPPHIIIABBB::i,,00%HHL & 5 5D zz||777 F " " "F9 -1ZZ\\y/*F=tzz||==>>>>HtHHHHHIII&'''RSSSX7;FmR((3 ="5599+tLL=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   sm:A3D..E  E *L// L<;L< S// S<;S<*U UU W44 XX!*Z ZZctdtd}|rtdtddstdsrtdtdd rStd t d }|r3t d|d d tddStdddl} t dd }|sdS| d|std< t d|tdttdtdtdtdtt d}|r4t d|d d tdntdttdtdtd |r-| d!d nd }|r]td"|d#d r$t d$|td%|dSt d&}|rt d$|dSdStd't d(}|rt d$|dSdS))z1Configure Telegram bot credentials and allowlist.TelegramTELEGRAM_BOT_TOKENzTelegram: already configuredzReconfigure Telegram?FTELEGRAM_ALLOWED_USERSuA⚠️ Telegram has no user allowlist - anyone can use your bot!Add allowed users now?Tz6 To find your Telegram user ID: message @userinfobot"Allowed user IDs (comma-separated)rrGzTelegram allowlist configuredNz'Create a bot via @BotFather on TelegramrzTelegram bot tokenrz^\d+:[A-Za-z0-9_-]{30,}$znInvalid token format. Expected: : (e.g., 123456789:ABCdefGHI-jklMNOpqrSTUvwxYZ)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)?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).,zUse 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))r^rUr`rr}rTreplacerarematchr_r[splitr)r allowed_usersr+token first_user_id home_channels r_setup_telegramr2Us[122H 12224e<<  !9:: G^___ !94@@GWXXX$*+O$P$PM$G&'?AVAVWZ\^A_A_```%&EFFF F8999 III +d;;;  Fxx3U;;  @     '///())) GGG=>>>23337888KLLL GGGIMW/1F1FsB1O1OPPPYZZZZUVVV 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 Brctdtd}|rtdtddstdstdtdd ratd t d }|rAt |}t dd |td dStdt dd }|sdSt d|tdttdtdtdtdttdtt d}|rBt |}t dd |td ntdttdtdtdtdtdt d}|rt d |dSdS)!z0Configure Discord bot credentials and allowlist.DiscordDISCORD_BOT_TOKENzDiscord: already configuredzReconfigure Discord?FDISCORD_ALLOWED_USERSu@⚠️ Discord has no user allowlist - anyone can use your bot!r"TuJ To find Discord ID: Enable Developer Mode, right-click name → Copy IDr#r(zDiscord allowlist configuredNz;Create a bot at https://discord.com/developers/applicationszDiscord bot tokenrzDiscord token savedr$z To find your Discord user ID:z/ 1. Enable Developer Mode in Discord settingsu' 2. Right-click your name → Copy IDzB You can also use Discord usernames (resolved on gateway start).zLAllowed user IDs or usernames (comma-separated, leave empty for open access)uF⚠️ No allowlist set - anyone in servers with your bot can use it!r&r'uA To get a channel ID: right-click a channel → Copy Channel IDz0 (requires Developer Mode in Discord settings)zH You can also set this later by typing /set-home in a Discord channel.9Home channel ID (leave empty to set later with /set-home)DISCORD_HOME_CHANNEL) r^rUr`rr}_clean_discord_user_idsrTrrar[)rr. cleaned_idsr/r1s r_setup_discordr;s011H 01113U;;  !899 F]^^^ !94@@Fklll$*+O$P$PM$F&=m&L&L &'>@U@UVVV%&DEEE FLMMM & 6 6 6E &...'((( GGG=>>>1222@AAA8999 GGGSTTT GGGVM]-m<< .0E0EFFF45555[\\\ GGGKLLL?@@@RSSSABBBYZZZUVVL=-|<<<<<==rrawcg}|dddD]}|}|dr=|dr(|dd}|dr |dd }|r|||S) zGStrip common Discord mention prefixes from a comma-separated ID string.rrGr(z<@>z<@!zuser:rN) r*r-rr$endswithlstriprstriprHr)r<cleaneduids rr9r9sG{{3##))#..  iikk >>$   0CLL$5$5 0**U##**3//C 99;; ! !' * * abb'C  NN3    Nrctdtd}|r!tdtddsdStdtdtd td td td td tdtdtdtdtdt dt dtdtdtdt tdt t dd}|sdStd|t dd}|rtd|tdt tdtd t t d!}|r5td"| d#d$td%dSt d&td'dS)(z Configure Slack bot credentials.SlackSLACK_BOT_TOKENzSlack: already configuredzReconfigure Slack?FNzSteps to create a Slack app:uH 1. Go to https://api.slack.com/apps → Create New App (from scratch)u= 2. Enable Socket Mode: Settings → Socket Mode → EnableuB • Create an App-Level Token with 'connections:write' scopeu< 3. Add Bot Token Scopes: Features → OAuth & Permissionsz5 Required scopes: chat:write, app_mentions:read,z2 channels:history, channels:read, im:history,z< im:read, im:write, users:read, files:read, files:writez3 Optional for private channels: groups:historyuF 4. Subscribe to Events: Features → Event Subscriptions → Enablez@ Required events: message.im, message.channels, app_mentionz3 Optional for private channels: message.groupsu> ⚠ Without message.channels the bot will ONLY work in DMs,z not public channels.u4 5. Install to Workspace: Settings → Install Appz8 6. Reinstall the app after any scope or event changeszD 7. 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-...)TrzSlack 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_USERSrrGzSlack 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^rUr`rrbr[r}rTrar*)r bot_token app_tokenr.s r _setup_slackrKs.//H.///1599  F-...YZZZNOOOSTTTMNNNFGGGCDDDMNNNDEEEWXXXQRRRDEEERSSS-...EFFFIJJJUVVV GGGfggg GGG3dCCCI $i0003dCCCI5()444&''' GGG=>>>mnnn GGG^MN,m.C.CC.L.LMMM233333bcccM N N N N Nrc 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|stdrIt tdd}|rt ddtd|rdnd} tdn#t$rtd|dd dl }tj d!}|r)||d"d#d$tj|gdd%} n'|tjd&d"d#|gdd%} | jd krt|d'n[t%d(|d)| jrAtd*| jd+YnwxYwt td,td-t t d.} | r4t d/| d0d1td2ntd3t td4td5td6t d7} | rt d8| dSdSdS)9zConfigure 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]mautrixz Installing z...rrrurnrrrtz installedu.Install failed — run manually: pip install 'rrrr$z- Matrix user IDs look like @username:serverr%MATRIX_ALLOWED_USERSrrGzMatrix allowlist configuredE⚠️ 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)r^rUr`rr[r}rTrArarrrvrgrhrxrfr{rrbrrrr*) r homeserverr/user_idro want_e2ee matrix_pkgrvrrr. home_rooms r _setup_matrixr]sk233W}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 0: /000: !"H%PP  * . 7 7 7 . ) ) ).7F**Y  U y ! ! ! ! U U U 4Z444 5 5 5    \$''F #UIz3>:V#'d( $^T5)ZH#'d( A%%7778888\z\\\]]]=US6=+>+>+@+@+K+K+M+Mb+QSSTTT' U* ABBBBCCC `aa  ` 1=3H3Hb3Q3Q R R R 7 8 8 8 8 ^ _ _ _ ^___Z[[[YZZZSTT  : -y 9 9 9 9 9a0:0:^ : :sG--DK0/K0ctdtd}|r!tdtddsdStdtdtd t t d }|r#t d |d t d d}|sdSt d|tdt tdtdtdt t d}|r4t d| ddtdntdt tdtdtdt d}|rt d|dSdS)z%Configure Mattermost bot credentials. MattermostMATTERMOST_TOKENzMattermost: already configuredzReconfigure Mattermost?FNz/Works with any self-hosted Mattermost instance.uF 1. In Mattermost: Integrations → Bot Accounts → Add Bot Accountz 2. Copy the bot tokenz3Mattermost server URL (e.g. https://mm.example.com)MATTERMOST_URLrz Bot tokenTrzMattermost token savedr$u6 To find your user ID: click your avatar → Profilez' or use the API: GET /api/v4/users/mer%MATTERMOST_ALLOWED_USERSrrGzMattermost allowlist configuredrVuL📬 Home Channel: where Hermes delivers cron job results and notifications.uH To get a channel ID: click channel name → View Info → copy the IDzK You can also set this later by typing /set-home in a Mattermost channel.r7MATTERMOST_HOME_CHANNEL) r^rUr`rr[r}rTrArar*)rmm_urlr/r.r1s r_setup_mattermostreks/00H34446>>  F@AAAWXXX)*** GGG I J JF ='s););<<< ; . . .E %u---*+++ GGG=>>>GHHH8999 GGG\]]M\1=3H3Hb3Q3QRRR78888Z[[[ GGG]^^^YZZZ\]]]UVVL@0,?????@@rc^tdtd}|rtddStdtdtt ddr?t dd t d td td dSdS) zConfigure WhatsApp bridge.WhatsAppWHATSAPP_ENABLEDzWhatsApp: already enabledNz2WhatsApp connects via a built-in bridge (Baileys).z9Requires Node.js. Run 'hermes whatsapp' for guided setup.zEnable WhatsApp now?TrzWhatsApp enabledz>Run 'hermes whatsapp' to choose your mode (separate bot numberz,or personal self-chat) and pair via QR code.)r^rUr`r[rrTra)rs r_setup_whatsappris/00H.///CDDDJKKK GGG+T22C)6222()))STTTABBBBB CCrc&ddlm}|dS)z>Configure Weixin (personal WeChat) via iLink Bot API QR login.r) _setup_weixinN)hermes_cli.gatewayrk)_gateway_setup_weixins rrkrk)IIIIIIrc&ddlm}|dS)z#Configure Signal via gateway setup.r) _setup_signalN)rlrp)_gateway_setup_signals rrprprnrc&ddlm}|dS)z"Configure Email via gateway setup.r) _setup_emailN)rlrs)_gateway_setup_emails rrsrs)GGGGGGrc&ddlm}|dS)z)Configure SMS (Twilio) via gateway setup.r) _setup_smsN)rlrw)_gateway_setup_smss rrwrws)CCCCCCrc&ddlm}|dS)z%Configure DingTalk via gateway setup.r)_setup_dingtalkN)rlrz)_gateway_setup_dingtalks rrzrzs)MMMMMMrc&ddlm}|dS)z*Configure Feishu / Lark via gateway setup.r) _setup_feishuN)rlr})_gateway_setup_feishus rr}r}rnrc&ddlm}|dS)z6Configure WeCom (Enterprise WeChat) via gateway setup.r) _setup_wecomN)rlr)_gateway_setup_wecoms rrrrurc&ddlm}|dS)z>>HIII GGG O $ $F DEEE; ///.>>>M HIII%}555,--- GGG<===ABBB GGG`aaMJ)=+@+@b+I+IJJJ34444HIII GGGSTTTJKKL8(,777 GGG&'''''rctdtd}|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.BlueBubbles (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_USERSrrGz 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)r^rUr`rr[r}rbrTrArar*rrr)r server_urlror.r1 webhook_ports r_setup_bluebubblesrs)***566H45557??  FTUUUBCCCEFFF6777 GGG_``` GGGPQQJ MNNN+Z->->s-C-CDDD3dCCCH KLLL)84441222 GGGABBB[\\\ GGGfggM`2M4I4I#r4R4RSSS89999^___ GGG[\\\UVVVKLLLA1<@@@ GGGGHHH;UCCIEFF  I I93s.Ls0EEa5W1D1D1D1D1D1DEErN)_setup_standard_platform)rlrnextr)r qq_platformrs rrrIsm------EE:EEEtLLK.??????  -----..rctdtd}|r!tdtddsdSt t dt dt d t td t t d }|r] td tt|td |n#t$rt dYnwxYwt dd}|r td|tdnt dtddt tdddl m }td|dtdtdt tdtdt tddS) zConfigure webhook integration.WebhooksWEBHOOK_ENABLEDzWebhooks: already configuredzReconfigure webhooks?FNuD⚠ Webhook and SMS platforms require exposing gateway ports to thezE internet. For security, run the gateway in a sandboxed environmentzB (Docker, VM, etc.) to limit blast radius from prompt injection.zX Full guide: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/webhooks/zWebhook port (default 8644) WEBHOOK_PORTrz'Invalid port number, using default 8644z-Global HMAC secret (shared across all routes)TrWEBHOOK_SECRETzWebhook secret saveduENo secret set — you must configure per-route secrets in config.yamlrzWebhooks enabled! Next steps:rrz 1. Define webhook routes in z /config.yamlz3 2. Point your service (GitHub, GitLab, etc.) at:z3 http://your-server:8644/webhooks/z Route configuration guide:z_ https://hermes-agent.nousresearch.com/docs/user-guide/messaging/webhooks/#configuring-routesz2 Open config in your editor: hermes config edit)r^rUr`rr[rbr}rTrrrarrr)rrsecretrs r_setup_webhooksrRs9.//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 GGGCDDDDDs:n |r |n)#t8$r}"t;d5|"Yd }"~"nd }"~"wwxYwn#t8$r+}"t;d?|"td@Yd }"~"nd }"~"wwxYwtdA| rtdBtdCnd-dDlm}&|&r[tdEtdFtdGtdHtdItdJntdEtdKtdd Sd S)Lz*Configure messaging platform integrations.Messaging PlatformszAConnect to messaging platforms to chat with Hermes from anywhere.z&Toggle with Space, confirm with Enter.rMrOz (configured)zSelect platforms to configure:zENo platforms selected. Run 'hermes setup gateway' later to configure.Nr r5rFrrrr`rNrhrrrrrrru━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━zMessaging platforms configured!r)rr8r4SLACK_HOME_CHANNELrEr BlueBubblesrQQBotzNo 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 rrDarwin) _is_service_installed_is_service_runningsupports_systemd_serviceshas_conflicting_systemd_units install_linux_gateway_from_setup$print_systemd_scope_conflict_warning systemd_startsystemd_restartlaunchd_install launchd_startlaunchd_restartz) Restart the gateway to pick up changes?Tz Restart failed: z Start the gateway service?z Start failed: systemdlaunchdz 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 processrGz4For automatic restarts, use a Docker restart policy:z* docker run --restart unless-stopped ...z/ docker restart # Manual restartz2 hermes gateway # Run in foreground) r^r`r[r_GATEWAY_PLATFORMSrgrUrrrarbrupperrwrrlrrrrrrrrrrrrrir_rr)'r rrrrenv_var_func is_configuredrrr_env_var setup_func any_messaging missing_homeplatr _is_linux _is_macosrrrrrrrrrrrservice_installedservice_runningsupports_systemdsupports_service_managerr}svc_nameinstalled_scope did_installrs' r setup_gatewayrsJ &'''RSSS7888 GGG EL%./A%B%B##! !D'5]73344 8  M  /@!A!ABBM+8B4''''d U  #    " " " @%VVH Z[[[%7%<"h   *++ , , - - , * + + , * + + ,  ) )  , - . .  , + , ,  , . / / , * + + , + , , , - . . ,  ) ) ,  ( ( , , - - , 1 2 2 ,  % % , * + +#&} :7888 - . . ,} #8 8  ,    + + + , - - +m "7 7  +    * * * * + + )MBV4W4W )    ( ( ( 1 2 2 /=Ic;d;d /    . . .  % % )m1(>(>????????@ QQQ 8Q 8 8999OPPPPPPPPQLMMM#dbcccDEEEE 5 5 5 5 5 5|~~ QIJJJ[\\\2QRRRGHHHLMMMMIJJJOPPP:{}}ssR"" S ,SS !S<< T#TT#AW V+*W+ W5W W WW X !XX  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_toolsrM s1655555M f======r section_keyc|dkrttdptdptd}|s$ ddlm}|rd}n#t$rYnwxYw|sdS|d}t |tr(|r|St |tr9t|d p|dpd Sd S|d kr/|d id d }d|S|dkr/|didd}d|S|dkrFg}tdr| dtdr| dtdr| dtdr| dtdr| dtdr| dtd std!r| d"td#r| d$td%r| d&td'r| d(td)r| d*td+r| d,td-r| d.td/r| d0td1r| d2|rd3 |SdS|d4krg}td5r| d6td7r| d8td9r| d:|rd3 |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. r rrANTHROPIC_API_KEYrget_active_providerTNr configuredrrrz backend: rErrz max turns: gatewayr rr5r4rFrESIGNAL_ACCOUNTrrrrSMSrNrOrMr`r_WHATSAPP_PHONE_NUMBER_IDrgrrrFeishurWeComrWeixinrrrrrrrzTTS/ElevenLabsBROWSERBASE_API_KEYBrowserFIRECRAWL_API_KEY Firecrawl) rgrUr(rrirrrrrrr) r rhas_keyrr rr platformsrs r_get_section_config_summaryra sg . / / 2-.. 2011     ??????&&((#"G     4 7## eS ! ! !ekkmm !;;== eT " " Suyy++Quyy/A/AQ\RR R|  " "**Z,,00GDD$7$$$   JJw++// R@@ (Y(((  ! ! - . . )   Z ( ( ( , - - (   Y ' ' ' * + + &   W % % % ) * * '   X & & &  ) ) &   W % % % - . . $   U # # # . / / '=AR3S3S '   X & & & + , , +   \ * * * 3 4 4 )   Z ( ( ( - . . )   Z ( ( (  ) ) '   X & & &  ( ( &   W % % % , - - '   X & & & 1 2 2 ,   ] + + + * + + )   Z ( ( (  (99Y'' 't    - . . + LL) * * * . / / $ LL # # # , - - & LL % % %  $99U## #t 4sA A%$A%rct||}|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. Frrsz Reconfigure ?r)rr[rarrH)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_specrfmodulesr exec_modulerirA)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)statusmigratedrrrs rrz,_print_migration_preview.. ,HHHA!%%//Z*G*Ga*G*G*GrcDg|]}|ddk|S)rconflictrrs rrz,_print_migration_preview.. rrcDg|]}|ddk|S)rskippedrrs rrz,_print_migration_preview.. s,FFF1xI)E)EQ)E)E)Erz Would import:kindunknown destinationrG~rz<22s → z: Would overwrite (conflicts with existing Hermes config):rkzalready 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`rr[rXrWrrr*rrrH_HIGH_IMPACT_KIND_KEYWORDSraddrvrr)rrmigrated_itemsconflict_items skipped_itemswarnings_shownitemrdest dest_short kind_lower dest_lowerkeywordwarningrks r_print_migration_previewr0 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 errorrrerrorz 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_dirrrr[r^r`rrPrSrRr rbrir?r@resolve_selected_optionsMigratorresolvemigraterr0ra)r openclaw_dir config_pathrr}r dry_migratorpreview_reportpreview_summary preview_countmigratorrrrr conflictserrorsr;s r_offer_openclaw_migrationrMC 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<r Model & ProviderrzText-to-SpeechrrrMessaging Platforms (Gateway)rToolsrEr)r rrrrEc ddlm}m}|r |ddStt t |dd}|r5t tjttdt}t}t |dd}|stsd }|rtd dSt |d d}|r!tD]\}} } ||krt!t!t#d t$jt!t#d | ddt$jt!t#dt$j| |t |t!t| ddSt)d|t+dddtDdSddlm} | } t t3dpt t3dp| du} t!t!t#d t$jt!t#dt$jt!t#dt$jt!t#dt$jt!t#dt$jt!t#dt$jd}| rt!t5dtdt!gd}t7d |d}|dkrt9||dS|d!krn|d"krt+d#dSd$|cxkrd%krhnnt:|d$z t=fd&tDd}|r0|\}} } | |t |t?||dSnYt!tA|}|rt}t7d'd(d)gd}|dkrtC||| dSt5d*t+d+tEt+d,tGt+d-|t+d.tHt!t+d/|r;t!t+d0t+d1t+d2|rtK|d3d4stM||rtK|d5d6stO||rtK|d7d8stQ||rtK|d9d:stS||rtK|d;d<stU|| =t |t?||tWdS)>uRun 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.non_interactiveTz;Running in a non-interactive environment (no TTY detected).sectionru│ ⚕ Hermes Setup — z<34su │rz configuration complete!zUnknown setup section: zAvailable sections: rc3"K|] \}}}|V dSNr)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. │z Welcome Back!z#You already have Hermes configured.)z*Quick Setup - configure missing items onlyz#Full Setup - reconfigure everythingrNrrOrPrExitzWhat would you like to do?rtz-Exiting. Run 'hermes setup' again when ready.r1c34K|]}|dk|VdSrNr)rsrs rrz#run_setup_wizard..t s1MM!19L9LA9L9L9L9LMMrz$How would you like to set up Hermes?u9Quick setup — provider, model & messaging (recommended)u#Full setup — configure everythingzConfiguration 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.r rNrrrErrrrrP)r),r;rRrSrVrgrerScopydeepcopyrNrarRrOrjrmSETUP_SECTIONSr[rXrWMAGENTAr_r`rr(rrUr^r_run_quick_setup RETURNING_USER_MENU_SECTION_KEYSrrrM_run_first_time_quick_setuprPrQ PROJECT_ROOTrrcrrrr_offer_launch_chat)argsrRrSreset_requestedr rrUrVrrfuncractive_provider is_existing migration_ran menu_choicesrr setup_moders @rrun_setup_wizardrr s]<;;;;;;;z|| ()))74%8899O:DM.112228999 ]]F!##Kd$5u==O #7#9#9+ I    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  M9 _%%%;<<<     ;\1MM Q;; V[ 1 1 1 F q[[  q[[ F G G G F &    A     ;6A:FKMMMM~MMMtTTG :!(5$V F###$V[999 F 2+>>  # ]]F"#I G 1L   ?? ' [ I I I F)***3 1 1334440 00111- --.... ../// GGGNOOO: :;;;\]]]8999 %6vwHZ[[%V$$$ '6vzK]^^'v&&& %6vwHXYY%V$$$ 6vyJ_``f ;6vwPP;Fk/::::---rctjd}|r|dgS tjdt jdddgSn#t$rYnwxYwdS)z>Resolve argv for launching ``hermes chat`` in a fresh process.rchat hermes_cliNrtzhermes_cli.main)rgrhrrrrfr{ri) hermes_bins r_resolve_hermes_chat_argvrw s}h''J$F## > # #L 1 1 =ND*;VD D >       4s.A AActtddsdSt}|stddSt j|d|dS)z7Prompt the user to jump straight into chat after setup.zLaunch hermes chat now?TNzDCould not relaunch Hermes automatically. Run 'hermes chat' manually.r)r[rrwr`rexecvp) chat_argvs rriri sf GGG 2D 9 9)++I YZZZIilI&&&&&rrnc8t|dt||diddt|t t dddgd }|d krt |t|t td t td |d krtd t t||td S)uStreamlined first-time setup: provider + model only. Applies sensible defaults for TTS (Edge), terminal (local), agent settings, and tools — the user can customize later via ``hermes setup
``. Trrrrz7Connect a messaging platform? (Telegram, Discord, etc.)z"Set up messaging now (recommended)u1Skip — set up later with 'hermes setup gateway'rz#Setup complete! You're ready to go.z) Configure all settings: hermes setupz1 Connect Telegram/Discord: hermes setup gatewayN) rcrr rSr[rrrar`rri)r rrngateway_choices rrgrg s&t,,,,"&))) j"%%00GDDD GGG"A 0 ?  NfF GGG7888 GGG:;;;FGGG GGG---rc  ddlm}m}m}t t dd|dD}d|dD}|}|\}} |p |p|p|| k} | s=t dt td td d S|rt tt|d |D]} t d | dt |D]N} t t td| dtj td| dd| drtd| d| dr/td| d| dd} n,td| d| d} | r0t| d| t d| d6td| dPd|D} d|D}| rt t dg}| D]o} | dg}|r dd|d d nd}|| d| d|pt%d!|}|D]}| |} t'| |rJt t d"td#td$g}i}|D]b} | d}d%|vrd&}nd'|vrd(}nd)|vrd*}n ||vr||||g| cd+|D}t%d,|}|D]}||}||}d-d.d/d0 |d}t t td1|d2|d3tj t |D] } td| dd| drtd| d| dr/td| d| dd} n,td| d| d} | r&t| d| t d4ntd5t  |rht td6t|d7|D]#}t d8|d9d:|d;$| |d<<t+|t-||d S)=u6Quick setup — only configure items that are missing.r)get_missing_env_varsget_missing_config_fieldscheck_config_versionu"Quick Setup — Missing Items Onlyc<g|]}|d|S is_requiredrrvs rrz$_run_quick_setup.. s9m@T@T rF) required_onlyc<g|]}|d|Srrrs 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 • rrrrGrz Get key at: ror}Trz Saved z Skipped cDg|]}|ddk|S)categorytoolrrs rrz$_run_quick_setup..> s.PPP1AEE*4E4E4O4OQ4O4O4Orcng|]2}|ddk|d0|3S)r messagingadvancedrrs rrz$_run_quick_setup..? sJ 55   + +AEE*4E4E + + + +rz Tool API Keysrr"rr1z(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'.TELEGRAMrDISCORDr4SLACKrEcBg|]}dddd||S)u 📱 Telegramu 💬 Discordu 💼 Slackrr4rErrs rrz$_run_quick_setup..q sI    ,)%  c!Qii    rz)Which platforms would you like to set up?u📱u💬u💼rrrrrz SkippedzAdding z& new config option(s) with defaults...z Added rz = r_config_version)r;r~rrr[r^rar`rrXrWr\rr}rTrbrrrrr rSr)r rr~rrmissing_requiredmissing_optionalmissing_config current_ver latest_verhas_anything_missingrr| missing_toolsmissing_messagingchecklist_labelsrrselected_indicesrplatform_orderrrrplatform_labels vars_listemojifields rrere 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-----rrX)NFr_)T)F)p__doc__rrloggingrrgrfrapathlibrtypingrrrhermes_cli.nous_subscriptionrrrrr getLogger__name__r?__file__parentrBrhr<rrrr!rgr+_DEFAULT_PROVIDER_MODELSrJrMr;rNrOrPrQrRrSrTrUrVhermes_cli.colorsrWrXr^hermes_cli.cli_outputr_r`rarbrjrmr}listrrrrrrrrrrcrir~rFrrrrr2r;r9rKr]rerirkrprsrwrzr}rrrrrrrrrrrr r#r0rMrcrfrrrwrirgrerrrrs    &&&&&&&&&&GGGGGGAAAAAA444444  8 $ $tH~~$+3355 9 tCH~$sCx.DDcNDtCH~DDDD 6$sCx.6C6SV6[_6666 A A A A A A"   G F FMMMPPP P P PMMMPPPwww___}}}sssG((Vd38n+$sCx.+#+$++++                      ,+++++++;;;;; d  d  d    &S3#*mmCm$mmWZ]aWammpmmmm((C($((sUYz(eh((((V//C/$/$////0CDD:IIIII8b b b b b J' ' ' ' ' h9>X$X$X$X$X$X$X$X$@W$WWWW /d////deUeUeUeUeUP d    OB4OBOBOBOBn A$AAAA2bbbbbTDBDBDBN3=3=3=l      2N2N2NjS:S:S:l(@(@(@VCCC$        -(-(-(`>V>V>VB...+E+E+E`%7#^4 .  -0 o|,):6 $m4%'89#_5%7o}5 .,?&(@BWX+];79KL {L)&(9?K#*o$oooon > > >T > > > >(VV3V8C=VVVVr O  O" O+. O  O O O O*L+<<== @nW TT^] ]ZP  =T====@B4BDBBBBT  "67 i(#%;</? g{#  45 $$$ SSSl 8DI#6     ' ' '))))))Xc.Tc.c.c.c.c.c.r