jh1dZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z mZmZddlmZddlmZddlmZddlmZej0eZe ej8j8j;Zd Zd ee efd ee effd Z!d ee efd ee e ffd Z"d ee efde de d dfdZ#de d e$fdZ%dggdgdgdgdgdddggdgdgdgdgdgdgdgdd Z&d ee efd e fd!Z'd ee efd"e d dfd#Z(dd$l)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4dd%l5m6Z6m7Z7d&e fd'Z8dd(l9m:Z:m;Z;md*e d e fd+Z?e:Z@e;ZAeZMdd4e d5e$d e$fd?ZNdd&e d@eJdAeJd eJfdBZOdCePfdDZQd ePfdEZRd ePfdFZSd ePfdGZTddHe dzd ePe e ffdIZUd3dJd ePdKe$fdLZVd e$fdMZWd e$fdNZXd e$fdOZYd ePfdPZZd ePfdQZ[d ePfdRZ\d ePfdSZ]d ePfdTZ^dUZ_dVZ`dWe d eJfdXZadYZbdZZcd[Zdd\Zed]Zfd^Zgd_Zhd ePfd`Zidd ePdae$fdbZjd ePd e$fdcZkdde d e fdeZld ePdfe d e e fdgZmd ePdfe dde d e$fdhZneediz djz dkz dlz dmz ZodnZpdodpdqdrdsdtdudvdwdx ZqdyePfdzZrd{e d e$fd|Zsd}d~eVfdde[fdde\fddeifddejfdde^fgZtdZud ePde$fdZvd ePfdZwy)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|jd}t|tr t|St|tr"|j rd|j iSiS)Nmodeldefault)get isinstancedictstrstrip)r current_models 5/home/ubuntu/.hermes/hermes-agent/hermes_cli/setup.py_model_config_dictr%sSJJw'M-&M""-%-*=*=*?=..011 Ic^|jd}t|tr t|SiSNcredential_pool_strategiesrrr)r strategiess r_get_credential_pool_strategiesr.s*89J)*d;4 CCrproviderstrategyc4|syt|}|||<||d<yr)r)r rr rs r_set_credential_pool_strategyr"3s' 08J#Jx+5F '(rcn|r|dk(ry|dk(ryddlm}|j|}|sy|jdvS)NcustomF openrouterTrPROVIDER_REGISTRY>api_keyoauth_device_code)hermes_cli.authr'r auth_type)rr'pconfigs r"_supports_same_provider_pool_setupr-;sE x8+<1##H-G     @ @@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.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)anthropic/claude-opus-4.6anthropic/claude-sonnet-4.6z openai/gpt-5zgoogle/gemini-3-flash)r8r9zopenai/gpt-5.4zgoogle/gemini-3-pro-previewzgoogle/gemini-3-flash-preview)r/r0zclaude-sonnet-4-6zgemini-3-flashr5r7 minimax-m2.7) r6r7r4r5z mimo-v2.5-proz mimo-v2.5z mimo-v2-proz mimo-v2-omnir:z minimax-m2.5z 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.copilotgeminizai kimi-codingkimi-coding-cnstepfunarceeminimax minimax-cn ai-gatewaykilocodez opencode-zenz opencode-go huggingfacec|jd}t|tr:t|jdxsdj j Sy)Nagentreasoning_effort)rrrrrlower)r agent_cfgs r_current_reasoning_effortrMtsI 7#I)T"9==!34:;AACIIKK reffortc^|jd}t|tsi}||d<||d<y)NrHrIr)r rNrLs r_set_reasoning_effortrP{s3 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|tjtjy)zPrint a section header.u◆ N)printr]r\CYANBOLD)r^s r print_headerrcs& G %$ug V[[ 9:r) print_error print_info print_success print_warning))u%Hermes Setup — Non-interactive modeu*Hermes 配置向导 —— 非交互模式)z+The interactive wizard cannot be used here.0当前环境无法使用交互式配置向导。)z@Configure Hermes using environment variables or config commands:=你可以通过环境变量或配置命令来设置 Hermes：)z?Or set OPENROUTER_API_KEY / OPENAI_API_KEY in your environment.E或者在环境变量中设置 OPENROUTER_API_KEY / OPENAI_API_KEY。)zERun 'hermes setup' in an interactive terminal to use the full wizard.B如需完整向导，请在交互式终端中运行：hermes setup) Skipped (keeping current)u# 已跳过（保留当前设置）)z Enter for defaultu 直接回车使用默认项)zCtrl+C to exitu Ctrl+C 退出)z Select [u 请选择 [)zPlease enter a number betweenu!请输入一个数字，范围：)Please enter a numberu请输入数字)Please enter 'y' or 'n'u请输入 y 或 n)zLaunch hermes chat now?u&现在立即启动 hermes 聊天吗？)7Connect a messaging platform? (Telegram, Discord, etc.)u:现在连接消息平台吗？（Telegram、Discord 等）)"Set up messaging now (recommended)u$现在配置消息平台（推荐）)1Skip — set up later with 'hermes setup gateway'u9先跳过，之后可通过 'hermes setup gateway' 配置textcnt|ts|S|}tD]\}}|j||}|SN)rr_SETUP_TRANSLATIONSreplace)rr translatedoldnews r_translate_setup_textrzsA dC  J'2S''S1 2 rc,tt|yrt)_orig_print_errorrzmessages rrdrds+G45rc,tt|yrt)_orig_print_inforzr}s rreres*734rc,tt|yrt)_orig_print_successrzr}s rrfrf-g67rc,tt|yrt)_orig_print_warningrzr}s rrgrgrrc|ttdd}|y t|jS#t$rYywxYw)z;Return True when stdin looks like a usable interactive TTY.stdinNF)getattrsysboolisatty Exception)rs ris_interactive_stdinrs@ C$ 'E }ELLN## s / ;;reasonctttdtjtjt|r t |t dtt dt dt dt dtt dt dty ) z8Print guidance for headless/non-interactive setup flows.u.⚕ Hermes 配置向导 —— 非交互模式rhriz) hermes config set model.provider customz; hermes config set model.base_url http://localhost:8080/v1z1 hermes config set model.default your-model-namerjrkN)r`r]r\rarbre)rs r#print_noninteractive_setup_guidancers G %@&++v{{ [\ G 6AB GNO:;LMBC GVWST GrFquestionrpasswordct|}|r |d|d}n|d} |r.ddl}|jt|tj}n#t t|tj}t |}|jxs|xsdS#ttf$r"ttjdYywxYw)z'Prompt for input with optional default. []: : rNrJ) rzgetpassr]r\YELLOWinput_sanitize_pasted_inputrKeyboardInterruptEOFErrorr`rexit)rrrdisplayrvaluecleaneds rpromptrs$X.HJb -Jb/   OOE'6==$ABE%78E(/}}/'/R/ x (   sA5B.CCz\x1b\[\s*200~|\x1b\[\s*201~rcVt|tr|s|Stjd|S)z@Strip terminal bracketed-paste control markers from pasted text.rJ)rr_BRACKETED_PASTE_PATTERNsub)rs rrr s& eS ! # ' 'E 22rchoices descriptionc(ddlm}||||d|S)z?Single-select menu using curses. Delegates to curses_radiolist.r)curses_radiolist)selectedcancel_returnsr)hermes_cli.curses_uir)rrrrrs r_curses_prompt_choicers5 HgPR`k llrc  t||||}|dk\r(||k(rtdt|St|Stt|tj t |D]N\}}||k(rdnd}||k(r*ttd|d|tj>td|d|Ptd|d zd  ttd t|d |d zd tj}|s|St|d z }d|cxkrt|kr|Stdt|x#t$rtdYttf$r"tt!j"d YFwxYw)zPrompt for a choice from a list with arrow key navigation. Escape keeps the current default (skips the question). Ctrl+C exits the wizard. )rrrlu●u○  z Enter for default (rz) Ctrl+C to exitz Select [1-z] (z): z$Please enter a number between 1 and rm)rrer`r]r\r enumerateGREENrlenDIMintrd ValueErrorrrrr) rrrridxichoicemarkerrs r prompt_choicers '7 TC ax '> 4 5 GN   %&-- ()w'* 6w,E < %"VHAfX. = > Bvhax( ) *&w{m3DEF   S\N#gk]#F SEe*q.CC&#g,& ' >s7|nM N  1 / 0!8,  G HHQK s$9E #E.EF -F  F cNt|}|rdnd} tt|d|dtjj j }s|S|dvry|dvry td `#ttf$r"ttjdYJwxYw) z=Prompt for yes/no. Ctrl+C exits, empty input returns default.uY/n（回车默认是）uy/N（回车默认否）Trrr>yyes>nnoFrn) rzrr]r\rrrKrrr`rrrd)rr default_strrs r prompt_yes_norCs$X.H07,=WK  exj;-s;V]]KL N L  K -.# "8,  G HHQK sAA33.B$#B$items pre_selectedch|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). r)curses_checklist)r)rrsetsorted)r^rrrchosens rprompt_checklistr\s> 5    L<( F &>rvarc |jdg}dj|dd}t|dkDr|dt|dz dz }ttt d|jd|d d t j t|rtd ||jd rtd |d t|jdr$td|jd|d d}n!td|jd|d }|rt|d |tdytdy)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: rrrTr ✓ Savedz/ Skipped (configure later with 'hermes setup')) rjoinrr`r]r\rarerrXrfrg)rr tools_strrs r_prompt_api_keyrys. GGGR E %)$I 5zA~s3u:>*%00  G %,sww}c&kBC:NPVP[P[ \] G[ ,- wwu~(U 56 G wwzCGGHc&k:;k(rH ddl}|j0j3d>du}|r|j d?n#|j d@n|j dA|j6jr|j dBnqt-|dCdDdEk(r:|j6j8r|j dFn9|j dGn't;r|j<r|j dHtdIrtdJr|j dKn.tdIr|j dLn|j dMtdNr|j dO ddPlm }|dQxsi}|jCdRs|jCdSr|j dTtdUr|j dVn|j dW|j dX|j dY|j dZtEd[|D}tG|}tI|d\|d]t|D]z\}}}|r*td^tKd_tLjNd`|3td^tKdatLjPd`|d`tKdb|d tLjR|t|Dcgc] \}}}|r ||f}}}}|r/tUdcdddl+m,}tUde|dfttttKdgtLjNttKdhtLjNttKditLjNtdddl+m,}ttKdj|dktLjZtLj\ttd^tKdltLj^dmtatd^tKdntLj^dmtctd^tKdotLj^dp|dqtttKdrtLjRtttKdstLjZtLj\ttd^tKdttLjNdutd^tKdvtLjNdwtd^tKdxtLjNdytd^tKdztLjNd{td^tKd|tLjNd}ttd^tKd~tLjNdtd^tKdtLjNdtd^tKdtLjNtdttdtd^tKdtatLjRtd^tKdtctLjRtttKdrtLjRtttKdtLjZtLj\ttd^tKdtLjNdtd^tKdtLjNdtd^tKdtLjNdty#t $rg}Y wxYw#t $rY wxYw#t $rY wxYw#t $rY ZwxYw#t $rd}Y HwxYw#t $rd}Y#wxYw#t $rd}YwxYw#t $rYpwxYwcc}}}w)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)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 browserznpm install -g agent-browserF)z$Image Generation (Nous subscription)TN)Image GenerationTN)list_providers)_ensure_plugins_discoveredfalzImage Generation ()rFzFAL_KEY or OPENAI_API_KEYzVideo 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)TNrBMINIMAX_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)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)TNTINKER_API_KEY WANDB_API_KEY)RL Training (Tinker)TN)rFr)rFr 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|] \}}}|s dyw)rN).0_avails r z'_print_setup_summary..`sD 5!e!Ds /z tool categories available:z u✓ru✗z (missing zDSome 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)2r`rcragent.auxiliary_clientrrappendrZwebmanaged_by_nous availablecurrent_providerbrowser image_genagent.image_gen_registryrhermes_cli.pluginsrr is_available display_nameagent.video_gen_registryrQrutil find_specimportlib.utilrdirect_overridernous_auth_presentr*rrsumrrer]r\rREDrrghermes_constantsrrarbrrTrU) r hermes_home tool_statussubscription_featuresr_vision_backendslabelbrowser_providermissing_browser_hint _img_backendrr_p_list_video_providers_ensure_plugins_video_backend_vp tts_provider importlib neutts_ok kittentts_okr_spotify_stateavailable_count total_countrr missing_varr rdisabled_tools_dhhs r_print_setup_summaryr?s  G,-K:6BH8:BC`a)*<=MN  00ST  " " , ,& $ $ 5 5,-B-F-F-W-W,XXYZEE4./a b-44EE$$44PQ  & & 0 0$ *+;*EE4./w } ,= ! .J ! *#0  0#A  !5*> ? &&66OP  ( ( 2 2;<   ? E & ($& 77e#(') )      "4\N! DdDQ R   W X TT(* C ##%%(%5%5N& 00@BD$OP65*fEL  00XY  %-8L*MFG  !./=AQ3RBC  "}5F'GCD  "}5F'GKL  !}5E'F-XhJiIJ  ! !00:$FI    L M   m n  $ ! !$>>33K@LL    O P   p qDE""22NO Y /7 : & & 6 6   M N   X Y # %*?*Q*Q[\%&=+I?@ ' (KLLM\"FG ;0;Ar   n -1C1CO1T   C D ^$>?IJ89;<BCD{DDOk"K/"!K=0KLM G(3$i  CeV\\231TF; < eE6::./qa +VW>XZ`ZdZd8e7fg   G:ESS&6dE3UtSkSNS R  A(STU  G   @BHBNBN    OQWQ]Q]     @BHBNBN   G= %-dfXR8&++v{{ ST G Ck6==12"_5F4G HI Ck6==12"\^4D EF eGV]]+ ,F;-?WX G % FJJ '( G %2FKK MN G Cnfll344T UV C*FLL9::S TU C-v||<==U VW C,fll;<? @A Cln-. ;< => G % FJJ '( G %#V[[&++ >? G Ch -..J KL C& 566S TU Cov||455L MN Gc V!   (   0 I  ! L !J    FTs o-o*oo*p 0o: p *p3!p.Aq qq oo o'#o*&o''o** o76o7: pp pp pp p+*p+. p=<p= q  q c|jdi}ttd|jdd}|rdnd}tdtdt d |}|j d v|d<|jd d }t d t |} t||d <|jdd}t dt |} t||d<|jdd} t dt | } t| |d<y#t$rYxwxYw#t$rYQwxYw#t$rYywxYw)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_cpur CPU corescontainer_memory Memory in MB (5120 = 5GB)container_diskz Disk in MB (51200 = 50GB)N) setdefaultr`rerrrKrfloatrr) r rcurrent_persist persist_label persist_str current_cpucpu_str current_memmem_str current_diskdisk_strs r_prompt_container_resourcesrVs]  R0H G-.ll#94@O,E$MFGLM8-K(3'8'8':>W'WH #$,,2K]C $45G $)'N! ,,148K2C 4DEG '*7|#$ << 0%8L3S5FGH %(]!"            s6DD) D8 D&%D&) D54D58 EEc|jdi}ttdtdtdddlm}|j dxsd}d j |}td |d |jxs|}||vrtd |d |d||vr|nd}||d<td||j dd}|rdnd}td|jdv|d<|j dd}tdt|} t| |d<|j dd} tdt| } t| |d<|j dddvr tdd|d<ttd td!t!} | r td"t#d#td$t%d%xsd&d'} td(t%d)xs| j d*d&}td+t%d,xs| j d-d&}| r td%| |r td)||r td,|y.y.#t$rYAwxYw#t$rYwxYw)/zLPrompt for Vercel Sandbox settings without exposing unsupported disk sizing.rzVercel Sandbox settings:z/ Filesystem persistence uses Vercel snapshots.zX Snapshots restore files only; live processes do not continue after sandbox recreation.r)_SUPPORTED_VERCEL_RUNTIMESvercel_runtimenode24rz Runtime (rzUnsupported Vercel runtime 'z ', keeping .TERMINAL_VERCEL_RUNTIMErATrrz- Persist filesystem with snapshots? (yes/no)>rBrrrCrDrrErFrGrHrIrJ>rrJzVVercel Sandbox does not support custom disk sizing; resetting container_disk to 51200.zVercel authentication:z= Use a long-lived Vercel access token plus project/team IDs.z1 Found defaults in nearest .vercel/project.json.VERCEL_OIDC_TOKENz Vercel access token VERCEL_TOKENrJrz Vercel project IDVERCEL_PROJECT_ID projectIdz Vercel team IDVERCEL_TEAM_IDorgIdN)rKr`retools.terminal_toolrXrrrrrgrXrKrrLrr_read_nearest_vercel_projectrYrZ)r rrXcurrent_runtimesupported_labelruntimerMrNrPrQrRrSlinked_projecttokenprojectteams r_prompt_vercel_sandbox_settingsrls  R0H G)*@Aij>ll#34@Oii :;O{?"315GMMObSbG004WI[HYYZ[\%48R%R/X`!(H ,g6ll#94@O,E$M'-7( eg*(+H #$,,2K]C $45G $)'N!,,148K2C 4DEG '*7|#$||$e,J>no!&H  G'(NO13NFG() ,mN.K.Qr\` aE)*Qn.@.@b.QG &'J>+=+=gr+J D ~u-*G4 '. G        s$II- I*)I*- I:9I:startc x|xstjj}|jr |j}|g|j D]}|dz dz }|j s tj|jd}t|tsicS|jd|jddjDcic](\}}t|t r|j#r||*c}}cSiS#ttjf$ricYcSwxYwcc}}w)z=Read project/team defaults from the nearest Vercel link file.z.vercelz project.jsonutf-8encodingr`rb)r`rb)rcwdresolveis_fileparentparentsexistsjsonloads read_textOSErrorJSONDecodeErrorrrrrrr)rmcurrent directory project_filedatakeyrs rrdrd&s!" ++-G..00  9,~= ""$  ::l44g4FGD$%I"XXk2'*eg  U%%%++- J   $ I--. I  s0%D-D6D32D3quickrcd ddlm}m}tdt dt dt dt ddlm} ||}|jd |jd |d <d|vr |d|d<n|j!dd d }|jd }t#|t$r|jd}|st'|r ddlm} ddlm} ddlm} | |} | j5} t7| }t9d| D}||z }t tdt dt dt dt |dkDrt d|d|d|d|d nt d|d|t;ddrX| | |dd d d d d d dd dd d!" | |} t7| j5}t d#|d$t;ddrX|d%kDrggd&}t=|j|d'}dd%d(d)j|d}t?d*||}gd)|}tA|||tCd+|d,||rd}n) dd.l"m#}tI|}tK| }||vrd}|rd/d0d1d2d3d4d5d6d7d8d9d:d; }|j||xsd<}t td=t d>|t d?t d@t gdA}t?dB|d(}|dk(rCtMdCdDEjO}|rtQdF|tCdGnt dHn |d%k(rtMdIjOxsdJ}dK}tS|dLk(} | rdM}tM|dDEjO}!|!rtQdN|!|jUdOijUdPi}"||"dQ<| r-gdR}#|#dSgz}$t?dT|$d}%|%t7|#kr|#|%ndU}&ntMdVjO}&|&r tQdW|&tCdX||&rd|&dYndznt dHn t dZ|||s|d[k7r tW|y y y #ttf$rt t dY\t$r:}tjd |td |t d Yd }~d }~wwxYw#t$r!}tjd-|Yd }~d }~wwxYw#t$rtI}YwxYw)\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)rVrWzInference 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 modelNrcustom_providersr)SimpleNamespace) load_pool)auth_add_commandc3lK|],}tt|ddjds)d.yw)sourcerJmanualrN)rr startswith)rentrys rr z'setup_model_provider..s-pUWUHVX=Y9Z9e9efn9oqps*44z!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 rz (z manual, z$ auto-detected from env/shared auth)z2Add another credential for same-provider fallback?FrJg.@,) rr+r,r( portal_url inference_url client_idscope no_browsertimeoutinsecure ca_bundlemin_key_ttl_secondszProvider pool now has z credential(s).r)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)r 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)zStepFun Step PlanMiniMaxz MiniMax CN AnthropiczVercel AI Gatewayzyour custom endpoint) znous-apir;r.r=r>r?r@rBrC anthropicrDr$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)r2r3r1z gpt-4.1-miniz gpt-4.1-nanozUse default (gpt-4o-mini)zSelect vision model:r3z0 Vision model (blank = use main/custom default)AUXILIARY_VISION_MODELzVision configured with ruRSkipped — add later with 'hermes setup' or configure AUXILIARY_VISION_* settingsnous),hermes_cli.configrVrWrcre _DOCS_BASEr`hermes_cli.mainr SystemExitrrloggerdebugrgrpoprrr-typesragent.credential_poolrhermes_cli.auth_commandsrentriesrr%rrrr"rfrrrrrrrXr rK_setup_tts_provider)'r rrVrWrexc _refreshedselected_provider_mrrrpoolr 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_is_native_openai_oai_key_vaux_oai_vision_models _vm_choices_vm_idx_selected_vision_models' rsetup_model_providerrKs;%&?@J<'>?@ G:A!#J nnWfjj.ABF7OZ'%/0B%C!" %t, G B"dFF:. 78IJI Y - 7 A./DllnGg,KpgppL$|3J G < = Z  U  W  GA~56G5H;-X$~Yzl:^` <=N?EEGfKfI(N 1) <@P P  !3nt<BBDH/:))+r:EEhPRS$-j!$)m&"48S7T"TK+,BKQRSG#S);%<<+73*+ .44f-g-m-m-o*)"#;=ST-i[99O2315UWY BC k l &&0F#15C ) *. ,- A GM=cUCD?@@A@ Y LLRTW X X Y %"u  %sPQ?DS+7A,S+)T?$S(&S(./S##S(+ T4TTT/.T/cbtjdduxstjdduS)z Check if espeak-ng is installed. espeak-ngNespeak)shutilwhichrrr_check_espeak_ngr,s* << $D 0 VFLL4JRV4VVrc ddl}ddl}tstt d|j dk(r t dn&|j dk(r t dn t dttd d rl |j dk(r|jgd d n:|j dk(r|jgd d n|jgdd tdn t dtt dt dt |j|jddddddgd dtdy #|jtf$r#}t d|t dYd}~yd}~wwxYw#|j|jf$r#}td|t d Yd}~yd}~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)chocorr-y)sudoaptrrrzespeak-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  14 8 <<8+NN#C4NP\\W,NN#JRVNWNN#PX\N]34 f g G45MN G  ^^T5)T=) T   56%113DE  KA3OPIJ &  ) ):+D+D E045GHs1A*E!0F F 'FF  G (GG c Dddl}ddl}d}ttdt |j |j dddd|d d gd d t dy #|j|jf$r'}td|td|dYd}~yd}~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)...rrrr soundfilerTrrz kittentts installed successfullyzFailed to install kittentts: z(Try manually: python -m pip install -U 'z ' soundfileF) rrr`rerrrfrrrd)rr wheel_urlrs r_install_kittentts_depsrcs 1 G`a G  ^^T5)T9kS\ ]   89  ) ):+D+D E3A378=i[ TUs1AB8BBc  |jdi}|jdd}t|}dddddd d d d d }|j||}ttdt d|tg}g}t r.|j r"|jd|jd|jgd|jgd |jd|dt|dz }td||} | |k(ry|| } | dk(} | dk(r.d} t dtds tdr td| dk(r  jjddu} | r t!dntt d t d!t d"tt#d#d$rt%sTtd%d} nEt d&d} n6| d'k(rOtd(}|s#tt'd)d$*}|rt)d(|t!d+ntd,d} n| dk(r^| s\tdxs td}|stt'd-d$*}|rt)d|t!d.ntd,d} n| d/k(rtd0}|sMtt'd1d$*}|rt)d0|t!d2nd3d4lm}td5|d6d} | d/k(rtt'd7}|r|j/r|j/|j1dij1d/id8<t!d9|j/n| d:k(rOtd;}|stt'dk(rNtd?}|s9tt'd@d$*}|rt)d?|t!dAntd,d} n| dBk(rdtdCxs tdD}|stt dEt'dFd$*}|rt)dC|t!dGntd,d} n| dHk(r d3dl} | jjdHdu} | r t!dIn[tt dJt dKtt#dLd$rt5stdMd} n t dNd} d|vri|d<| |dd<t7|t!dO|j| | y#t$rd} YwxYw#t$rd} YwxYw)Pz@Interactive TTS provider selection with install flow for NeuTTS.rrrzEdge TTS ElevenLabsz OpenAI TTSzxAI TTSz MiniMax TTSzMistral Voxtral TTSzGoogle Gemini TTSNeuTTS KittenTTS) rrrxairBrr<rrz"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)zrs rrr|sYE2&J!~~j&9:6B" (%  O$''(8:JKM G56=/*+ GGI!#(=(O(O\]' NN  st NN^M?!457|a' .9I JC ~H M1= `a 1 2mDT6U { 8 & ) 8 8 B$ N   7 8 G ) * a b E F G?F+-!"]^%Hfg! \ ! !56 G1DAG3W=89NO! X &7 !9:]mL\>] G5EG7A89NO! U  / G2TBG}g656H--1VH500 " u  GZ[HHNN,QYQ_Q_Qa!!%,77rB:N 5hnn6F5GHI Y  !23 G6FG0':9:NO! Y  !23 G6FG0':9:NO! X  !12UmDT6U G U V5EG/989NO! [  & ! ) 8 8 ET Q   : ; G \ ] S T G5t<.0!"`a%Hij! Fu (F5M*)/*=*=h*Q)RSTI & %  &Z & %  &s$U!U/ U,+U,/ U=<U=ct|y)z.Standalone TTS setup (for 'hermes setup tts').N)rr s r setup_ttsrCs rc ddl}tdtdtdtdtdt t |dd d }|j d k(}gd }d dddddd}ddddddd}d}|r |jdd||<||d<|dz }|}|jd|d|||<td||} |j| } | |k(rtd |y| |jdid <| d k(rtd!td"t td#td$td%t |dd&d' } td(| xsttj} | r| |dd&<t t!d)} | r td*n,t#d+d,rtd-d./}|rt%d)|td0n| dk(rtd1t'j(d}|st+d2td3ntd4|t |dd5d6 }td7|}||dd5<t%d8|t-|nn| dk(rtd9t'j(d:xst'j(d}|st+d;td<ntd=|t |dd>d? }td@|}||dd><t%dA|t-|n| dk(rtdBtdCddDlm}ddElm}t7t9xrt;|j<xr|d}|t |ddF}d,}|r5dGdHg}|dIk(rd}n|dJk(rd}nt!dKrdnd}tdL||}|dk(}|r5dI|ddF<tdMt!dKs t!dNrtdOndJ|ddF<tdP t?dt tdZtd[t!dK}|rNtd\t#d]d,rmtd^d./}td_d./} |r t%dK|| rCt%dN| n6td^d./}td_d./} |r t%dK|| r t%dN| t-|n| dk(rtd`tdatdbtdc t?dt t!di}!|!r>tdjt#dkd,rMtdld./}"|"r>t%di|"tdmn&tdld./}"|"rt%di|"tdnt |ddod6 }tdp|}||ddo<t%dq|t-|n| dk(r:tdrtdstdt t?dutS|n| dk(rtdytdzt!d{xsd'}#td||#}$|$r t%d{|$t!d}xsd'}%td~|%xstUjVdd'}&|&r t%d}|&t!dxsd}'td|'}(|(r|(dk7r t%d|(t!dxsd'})ttjdz dz }*td|)xs|*}+|+r t%d|+|$rt#dd.rtdddl!}gd},|+r|,jYd|+g|(r|(dk7r|,jYd|(g|,j|&r|&d|$n|$|,jd|jE|,d.d.d}|jJdk(r tdn1t+d|jLjOtdt%d| | dk(rt%d|djdFd| dk(rt%d|djddt[|t td| y#t@$rtdQddl!}t'j(dR}|r)|jE|dSdTdUtFjHdgd.d.V}n'|jEtFjHdWdSdTdgd.d.V}|jJdk(r tdXn t+dYYwxYw#t@$rtddddl!}t'j(dR}|r)|jE|dSdTdUtFjHdgd.d.V}n'|jEtFjHdWdSdTdgd.d.V}|jJdk(r tdenNt+df|jLr7tdg|jLjOjQdhYwxYw#t@$rtdvddl!}t'j(dR}|r)|jE|dSdTdUtFjHdugd.d.V}n'|jEtFjHdWdSdTdugd.d.V}|jJdk(r tdwnNt+dx|jLr7tdg|jLjOjQdhYwxYw)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/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 environmentzCVercel Sandbox - cloud microVM with snapshot filesystem persistencedockerrsshdaytonavercel_sandbox)rrrrrrrr r)rr rr r r z.Singularity/Apptainer - HPC-friendly container singularityrrzSelect terminal backend:zKeeping current backend: zTerminal backend: Localz&Commands run directly on this machine.zGateway working directory:z) Used by Telegram/Discord/cron sessions.z4 CLI/TUI always uses your launch directory instead.rrrJz Gateway working directory SUDO_PASSWORDzSudo password: configuredz?IJfj%D 2K4S3tyy{CST (+F: u % %o6  2 3  JE 04@I :34 X %01\\(+  5 6 L M  |4 5  NLxy '7-2z>*.6#F+ ] *?@<< ,K ]0K D E R   + , 4GRGH *M:27z./3U;#F+ W $/0UVLC"& & ( 7 *6 2 D D 7.g6 #  *'&*l*ST ! "**MY&$%!x'$%!)67G)HAa!*>!N !/! 3  /8F: | , i j-.-@T2Up08F: | , D E X7#> G . / H I*+;? !>F%&:TJH#)*BT#RL&'7B#&';\J!"6F%&>N "#3X>"#7F#F+ Y &12?@WX34 U y !4 $%67  > ?0%8 !6F"#4g>!-02TBG0':./  OMyz (-8.3z?+/7#F+ - -89YZRS U x 2 (/ U "-.>?%%89?R 3\B  . 5%%89?R lL$IBIIfb4IJ  . 5%%89AT lL1 DDL . 5$$67=2 $))+.9: 1;3M+N  -w 7 M":DA 0 1 NGg/ d|, NNtdV1TF+ > NN9 %^^GDtUW^XF  A%<= 9&--:M:M:O9PQRDE>#347",fZ.@.D.D\SY.Z[++0&2D2H2HIY[c2de G-.>-?@AQ X45!d+'^^"!%&NN# (,!, F(^^uiI'+!,F $$)!"78!"VW7 X| U 2 3 \\$'F#UIz3>>9U#'( $^^T5)YG#'(   A%56TU==6==+>+>+@+K+K+Mb+Q*RST- Un U 1 2 \\$'F#UIz3>>8T#'( $^^T5)XF#'(   A%45cd==6==+>+>+@+K+K+Mb+Q*RST- Us9 a; d$ g/B%c=<c=C(g,+g,/C(kkcd|jdid<tdd|jdid<d|jd id <d |d d <|jd ijddddt|t dt dt dt dt dt dy)zDApply recommended defaults for all agent settings without prompting.ZrH max_turnsHERMES_MAX_ITERATIONSallr 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)rKrYupdaterWrfrers r_apply_default_agent_settingsrvs24Fgr";/ ,-8=Fi$_56:FmR(3)-F=+& or*113 12%&%&./FG?@rc X tdtdtdtt t |ddd}tdtd td |d t d |} t|}|d kDr@||jdid<|jddtdtd|tdtdtdtdtdtdtdt |ddd}t d|}|jdvrGd|vri|d<|j|dd<t|td|jntd|d |d!td"td#td$d%|jd&id'<t |d&d(d)}t d*t |} t!|}d)|cxkrd+kr nn||d&d(<td,|d&j#d(d)td-td.td/tdtd0td1td2tdtd3tdgd4} |j#d5i} | j#d6d7}| j#d8d9} | j#d:d;} d dd?j#|d } t%d@| | }|jd5i|d k(rd7|d5d6<t dAt | } t|}|d kDr||d5d8<t dBt | } t|}d |cxkrdCkr nn||d5d:<tdD|d5j#d8d9dE|d5j#d:d;dFn|dk(rdK|d5d6<tdLtdMt|y#t$rtdYwxYw#t$rYwxYw#t$rYwxYw#t$rYtwxYw#t$rYwxYw#t$rYwxYw)NzSConfigure agent behavior: iterations, progress display, compression, session reset.Agent Settingsrz/user-guide/configurationrHrgrfrz1Maximum 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 iterationsrNrhzMax iterations set to z%Invalid number, keeping current valuerJzTool 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 logsrrjrizTool progress mode>riryoffverbosezTool 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.Trkrlrnrmz 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 settingsrorrrprsrqrtr rrr)rpidledailynonezSession 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.)rcrerr`rrQrrrKrrYrfrrgrKrWrLrr)r current_max max_iter_strmax_iter current_moderrcurrent_threshold threshold_strrn reset_choicescurrent_policy current_idle current_hour default_reset reset_idxidle_stridle_valhour_strhour_vals rsetup_agent_settingsrs!"J<'@AB G gfg{BGHKBCDE {m+`a*K8L ?|$ a< ;CF  gr *; 7 JJ{D ) 4 5 28*= > rN&'NO>?OPHIAB69ouML & 5D zz|77 F " "F9 -1ZZ\y/*F.tzz|n=>tfLaHI&'RSX7;FmR(3 {DQ=sCT?UVM -( ) #t #1:F= !+ . /}0E0I0I+W[0\/]^ '(TWrNWV\rNNOrNMZZ4N!%%ff5L!%%nd;L!%%i3LAqAEElTUVM3]MRI or*A~*0':C 'B'B9a'P&QQT U  a*0' U   T W ?=>?L    n            sm3AS1!SS-4!S=1T !TSS S*)S*- S:9S:= T  T  TT T)(T)cPtdtd}|rytdtddsbtdsVtdtdd r?td t d }|r't d|j d d tdytdddl} t dd }|sy|jd|s td0 t d|tdttdtdtdtdtt d}|r(t d|j d d tdn tdttdtdtd |r"|jd!djnd }|rFtd"|d#d rt d$|td%|yt d&}|r t d$|yytd't d(}|r t d$|yy))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)rrJzTelegram 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))rcrZrerrrXrvrfrematchrdr`splitr)r allowed_usersrri first_user_id home_channels r_setup_telegramrs 12H124e< !9:^_ !94@WX$*+O$PM$&'?AVAVWZ\^A_`%&EF 89 +d; rxx3U; @   '/() G=>2378KL GIM/1F1FsB1OPYZUV GKL?@KL;HM'',Q/557bM -m_@UV%&DE LM & 6E &.'( G=>12@A89 GST GVM-m< .0EF45[\ GKL?@RSABYZUVL-|<rrawcjg}|jddjdD]}|j}|jdr1|j dr |j dj d}|jjdr|dd }|s||j||S) zGStrip common Discord mention prefixes from a comma-separated ID string.rrJrz<@>z<@!zuser:rN) rvrrrendswithlstriprstriprKr)rruids rrrsG{{3#))#. iik >>$ CLL$5**U#**3/C 99; ! !' *ab'C  NN3   Nrctdtd}|r.tdtddstddr t ytd td td td td tdtdt tdt t t t dd}|sytd|t dd}|r td|tdt tdtdt t d}|r(td|jddtdntdtdt tdtd td!td"td#t d$}|rtd%|jyy)&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 savedru\ 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_USERSrrJzSlack 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.rrzC 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.rSLACK_HOME_CHANNEL) rcrZrer"_write_slack_manifest_and_instructr`rrXrfrvrgr)r bot_token app_tokenrrs r _setup_slackrs./H./159< 34 -.JKXYNOSTEFUV Gfg G '( G3dCI $i03dCI()4&' G=>mn G^M,m.C.CC.LM23bcM N GKL?@TU_`WXUVL+\-?-?-ABrc ddlm}ddlm}|dd}t |dz }|j j dd dd l}|j|j|d d dzdtd|tdtdy #t$r#}td|tdYd }~y d }~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)rSHermeszYour Hermes agent on Slack)bot_namebot_descriptionzslack-manifest.jsonT)rvexist_okNrF)indent ensure_ascii rorpzSlack 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_clirr'rSrrumkdirrx write_textdumpsrfrerrg)rrSmanifesttarget_jsonrs rrrZs =4'8 o'(+@@ D48 KKK ?$ F   7x@A =  (   7u=> ,   sBB C"CCc <tdtdxs td}|rtdtddsytdtd td t t d }|rt d |jd t tdt dd}|r1t d|t d}|r t d|tdn?t d}|r t d|t dd}|rt d|td|s tdrt tdd}|rt ddtd|rdnd} tdt td,td-t t d.} | r(t d/| j-d0d1td2n td3t td4td5td6t d7} | r t d8| yyy#t$rtd|dd dl }tjd!}|r)|j|d"d#d$tj |gdd%} n'|jtj d&d"d#|gdd%} | j"d k(rt|d'nRt%d(|d)| j&r7td*| j&j)j+d+YwxYw)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_HOMESERVERr zCAuth: 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_ENCRYPTIONrCz E2EE enabledzmautrix[encryption]mautrixz Installing z...rrrrrr rz installedu.Install failed — run manually: pip install 'r{r"rrz- Matrix user IDs look like @username:serverrMATRIX_ALLOWED_USERSrrJzMatrix 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)rcrZrerr`rrXrrfr8r9rrrrrrr:rgr;rr<rv) r homeserverriuser_idr want_e2ee matrix_pkgrrTrUr home_rooms r _setup_matrixrs23W}EV7WH/02E: ^_TUVW GJKJ*J,=,=c,BC GTU BT RE ,e4TU  +W 51201  +W 5*t4  ,h 7 4 5 /0 !"H%P  . 7 . ).7*Y  U y !, ABBC `a  1=3H3Hb3Q R 7 8 ^ _ ^_Z[YZST  -y 9 _1 U ZL4 5 \\$'F#UIz3>>:V#'d( $^^T5)ZH#'d(  A% J78 NzlZ[\]==6==+>+>+@+K+K+Mb+Q*RST' Us( H$$C3LLctdtd}|rtdtddsytdtdtd t t d }|rt d |jd t d d}|syt d|tdt tdtdtdt t d}|r(t d|jddtdn tdt tdtdtdt d}|r t d|tdy) 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_URLr z Bot tokenTrzMattermost token savedru6 To find your user ID: click your avatar → Profilez' or use the API: GET /api/v4/users/merMATTERMOST_ALLOWED_USERSrrJzMattermost allowlist configuredruL📬 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.rMATTERMOST_HOME_CHANNEL2 Open config in your editor: hermes config edit) rcrZrerr`rrXrrfrv)rmm_urlrirrs r_setup_mattermostrs6/0H346> @AWX)* G I JF 's);< ; .E %u-*+ G=>GH89 G\]M1=3H3Hb3QR78Z[ G]^YZ\]UVL0,?CDrcLtdtd}|rtdtddsytdtdtd td t td t t d }|s t d ytd|jdt dd}|s t dytd|tdt tdtdt t d}|r(td|jddtdn tdt tdtdt d}|r td |t td!td"dr:t d#}|r- td$tt|td%|t td'td(td)y#t$rt d&YBwxYw)*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 setupr zBlueBubbles 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_USERSrrJz 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)rcrZrerr`rrgrXrrfrvrrr)r server_urlrrr webhook_ports r_setup_bluebubblesr s)*56H457? TUBCEF67 G_` GPQJ MN+Z->->s-CD3dCH KL)8412 GAB[\ GfgM2M4I4I#r4RS89^_ G[\UVKLL1<@ GGH;UCEF  I93sz Route configuration guide:z_ https://hermes-agent.nousresearch.com/docs/user-guide/messaging/webhooks/#configuring-routesr)rcrZrerr`rgrrXrrrfrr'r)rr_secretr>s r_setup_webhooksrN sS./H124e<  GXYYZVW Gij G / 0D  E >3s4y> : 07 8Cd SF '0,-]^$f- G12<0 EFDEDE G./pq GCDCD- E C D Es ,E99FFc Z ./ddlm}m/m}t dt dt dt |}g}g}t|D]D\}}/|}|j|dd|dd |d |d k(s4|j|Ftd ||} | s t d y| D] } ||| dtdtfd.t./fd|D} | rt t dtdg} tdrtds| jdtdrtds| jdtdrtds| jdtdrtds| jd td!r'td"std#s| jd$| rlt td%d&j!| t d't d(t d)| D]}t d*|j#d+!ddl} | j'd,k(}| j'd-k(}| j'd.k(}dd/lm}m}m}m}m}m}m}m}m}m}m}m}m }m!}m"}m#} m$}!|}"|}#|}$|$xs|xs|}%t |$r|r|t |$r|r|t |#rO|$r| r |!d0ntKd1d2r |$r|n"|r|n|rdd3l&m'}&|&jQnm|"rO|$r| r |!d7nXtKd8d2rK |$r|n"|r|n|rdd3l&m'}&|&jYn|%r|$rd;})n|rd<})nd=})tKd>|)d?d2rt d}*d@}+d@},|$r |d@A\}*}+n*|r |d@Ad2}+ndd3l&m'}&|&j[d@Ad2}+d2},t |+r'|,s%tKdBd2r |$r ||*dCk(Dn |r|nt dG|$r t dHt dInfddJl.m/}-|-rCt dKt dLt dMt dNt dOt dPnt dKt dQt dyy#|$rA}'tSd4t|'jUD]}(t d5|(Yd}'~'Nd}'~'w|$r }'tSd6|'|!d0Yd}'~'qd}'~'wtV$r}'tSd6|'Yd}'~'d}'~'wwxYw#|$rA}'tSd9t|'jUD]}(t d5|(Yd}'~'d}'~'w|$r }'tSd:|'|!d7Yd}'~'d}'~'wtV$r}'tSd:|'Yd}'~'d}'~'wwxYw#|$rB}'tSd9t|'jUD]}(t d5|(Yd}'~'d}'~'w|$r!}'tSd:|'|!d7Yd}'~'d}'~'wtV$r}'tSd:|'Yd}'~'5d}'~'wwxYw#tV$r$}'tSdE|'t dFYd}'~'d}'~'wwxYw)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.emojirr,z (r configuredzSelect platforms to configure:zENo platforms selected. Run 'hermes setup gateway' later to configure.Nstatusr cz|j}|dk(xs$|jdxs|jd S)Nnot configured partiallyzplugin disabled)rKr)rss r _is_progressz#setup_gateway.._is_progress sC LLN ! ! /||K( /||-.  rc3:K|]}|ywrtr)rpr rs rr z setup_gateway.. s!./ %a()su━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━zMessaging platforms configured!rrrrrrrrrrr 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: rmz 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?r4)r4z 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 processrJz4For automatic restarts, use a Docker restart policy:z* docker run --restart unless-stopped ...z/ docker restart # Manual restartz2 hermes gateway # Run in foreground)0rrrrrcrer`rrrrranyrfrZrgrupperrr4rrrrrrrrrrrrr r!r"r#r$r hermes_clir&r%rdr<rrmrr'r*)0r rr platformsrrrplatrrr any_messaging missing_homer? _is_linux _is_macos _is_windowsrrrrrrrrrrrrr r!r"r#r$service_installedservice_runningsupports_systemdsupports_service_managerr&rlinesvc_nameinstalled_scope did_installstarted_inliner*r rs0 @@r setup_gatewayr>} swXX&'RS78 G I ELY'#4!$' W aW c&CD \ !    " #  @%VH Z[,IcN+, S T 3A3CM :78 - .} #8     + , -m "7     * * +MBV4W    ( 1 2=Ic;d    .  % . /=AR3S    (  G 5dii 6M5NO P P Q K L J K$ -djjl^;UV  %$$&'1 $$&(2 &&(I5      (23-/46#3#Oy#OK    = ? 0 2 G  7 9 % ' G $H$J/ :JDQ:'')"')$>'//1$H$J/8=tD8'%"%$>'--/&$$+-hZ7ef$Q&*O"'K%*N'7W^c7d4"'e4&* ?'//e/<&* )-G">mLfhl>m @/ -_5P Q!* -LM#bcDE 5~IJ[\2QRGHLMIJOP:yp3+ RS #A 1 1 3+4&k*+3?  "4QC 893I>> :"4QC 899:3+ PQ #A 1 1 3+4&k*+3="21# 673G<< 8"21# 6778L ;3'(XY(+A(9(9(;3 %4&k 23;E'*:1#(>?;GDD(@'*:1#(>??@ Q"4QC 89OPPQs0,S,U#AY=(W/U 7TU !T<< U UU #W,(7V$$W,,W W,W''W,/Y:47X1+Y=1Y:9YY= Y:!Y5/Y=5Y::Y== Z*Z%%Z* first_installc$ddlm}|||y)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)r?r N)hermes_cli.tools_configrA)r r?rAs r setup_toolsrCm s6 f=rc ddlm}|ry ddlm}dtfd}t |t r|jdnd}t |t rZ|jd xsd jj}||vr |||ry|d k(rd D]}t|syd D]}t|sy|jD]\}}|d k(r ||syy#t$rYwxYw#t$ri}YwxYw)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]}|dk(r t|syy)NCLAUDE_CODE_OAUTH_TOKENTF)api_key_env_varsrZ)r,env_vars r_has_keyz0_model_section_has_credentials.._has_key s5// G33W%  rrNrrJr%)rrr;F) r*rFrr'rrrrrrKrZr) r rFr'rK model_cfg provider_idrJpidr,s r_model_section_has_credentialsrO s4 7   ! 5T(2&$'? 7#TI)T" }}Z06B==?EEG + +)+67 , &C  ) <  !*//1 W )   G   Y    s" C,C;, C87C8; D D r,cT|jdddj}|xs|S)zFStrip trailing parenthetical qualifiers from a gateway platform label.(rr)rr)r,bases r_gateway_platform_short_labelrS s* ;;sA q ! ' ' )D =5r section_keyc |dk(rt|sy|jd}t|tr |j r|j St|t r1t|jdxs|jdxsdSy|dk(rt |ddd}d |S|d k(rt |d d d }d |S|dk(rOddlm}m }|Dcgc]#}||r||dk7rt|d%}}|rdj|Sy|dk(rjg} tdr| jdtdr| jdtdr| jd| rdj| Syycc}w)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: rHrgrfz max turns: gatewayr)rrrr,rrrzTTS/ElevenLabsBROWSERBASE_API_KEYBrowserFIRECRAWL_API_KEY Firecrawl)rOrrrrrrQrrrrSrrZr) r rTrrrgrrr/rrs r_get_section_config_summaryr[ sg-f5 7# eS !ekkm;;= eT "uyy+Quyy/AQ\R R  "&*iI7)$$  FG["E YK((  !G'( %*:4*@DT*T *$w- 8  99Z( (   - . LL) * . / LL # , - LL % 99U# # + s(F ct||}|syttd|d|td|j 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. Frrz Reconfigure ?r)r[r`rfrrK)r rTr,summarys r_skip_configured_sectionr_ sO*&+>G  GBugRy)*~ekkm_A>N NNrzoptional-skills migrationzopenclaw-migrationscriptszopenclaw_to_hermes.pyctjsytjj dt}| |j ytjj |}ddl}||j|j< |j j||S#t$r(|jj|jdwxYw)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_SCRIPTrwr6r spec_from_file_locationloadermodule_from_specrmodulesr exec_modulerr)specmod_syss r_load_openclaw_migration_modulerm s  " " $ >> 1 1. D |t{{* .. ) )$ /C!DLL $ J  D) s B##1Cu\⚠ 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) rVtelegramslackdiscordwhatsappr soulmemorycontextreportc|jdg}|s tdy|Dcgc]}|jddk(s|}}|Dcgc]}|jddk(s|}}|Dcgc]}|jddk(s|}}t}|rtt dt j |D]}|jd d }|jd d } | rIt| jttjd } td|dd| ntd||j} t| j} tjD]\} }| | vs| | vs|j|!t|rjtt dt j|D]8}|jd d }|jdd}td|dd|:t|rjtt dt j |D]8}|jd d }|jdd }td|dd|:t|rtt dt jt#|D](}tt d|t j*ttt dt jtt dt jtt dt jtyycc}wcc}wcc}w)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.Nrmigratedconflictskippedz Would import:kindunknown destinationrJ~rz<22s → z: Would overwrite (conflicts with existing Hermes config):rzalready 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.)rrerr`r]r\rrrvrr5rK_HIGH_IMPACT_KIND_KEYWORDSraddrrr)rurrmigrated_itemsconflict_items skipped_itemswarnings_shownitemrzdest dest_short kind_lower dest_lowerkeywordwarningrs r_print_migration_previewrE s JJw #E ()!&HA!%%/Z*GaHNH!&HA!%%/Z*GaHNH %F1xI)EQFMFUN e%v||45" 0D88FI.D88M2.D Y..s499;/?E tDkzl;<tfo&JT*J$>$D$D$F 0 j(Gz,A"&&w/ 0 0  ePRXR_R_`a" 2D88FI.DXXh(89F F4+Rx0 1 2  eOVZZ01! 2D88FI.DXXh+F F4+Rx0 1 2  e. >?n- :G %$wi(&--8 9 :  e\^d^k^klm eegmgtgtuv ebdjdqdqrs UIHFs"MM M!#M!-M&M&r(c 2tjdz }|jsytj syt t dtd|tdt tdds td yt}|j stt t}| td y |j#d d d}|j%|j'|j'dd ddd |d }|j)}|j+di}|j+dd} | dk(rt tdyt t d| dtdt t-|tddstdtdy |j%|j'|j'dd ddd |d } | j)} | j+di} | j+dd} | j+d d}| j+d!d}| j+d"d}t | rt/d#| d$|rtd%|d&|rtd%|d'|rt|d(| j+d)}|rtd*|t/d+y#t$r/}td |tj!d dYd }~yd }~wwxYw#t$r/}td|tj!ddYd }~yd }~wwxYw#t$r/}td|tj!ddYd }~yd }~wwxYw),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 errorr^rwrz 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 errorryrxerrorz 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.rzFull report saved to: z,Migration complete! Continuing with setup...)rr5is_dirrdrwr`rcrerrTrWrVrmrgrrrresolve_selected_optionsMigratorrsmigraterrrf)r( openclaw_dir config_pathrkrr dry_migratorpreview_reportpreview_summary preview_countmigratorrur^rwry conflictserrorsrs r_offer_openclaw_migrationr s99;,L      " " $ G12(78UV G FPT U Z "#K    KM"-/ ; < = //d6/J||$,,.#++-! %$  &--/%((B7O#'' A6M 56 G)-8RSTFG G^, 2E B Q   W <<$,,.#++-! %  !!#jjB'G{{:q)Hkk)Q'G J*I [[! $F G (+BCDXi[(}~XgY&HIJ  STUL)J+J<89@A y 9!=> ;d K( 21#67 7$ GZ *1#./ /$ ?sJ=K(AL#AM( L 1%LL # M,%MM N'%NNrModel & ProviderrzText-to-SpeechrrrVzMessaging Platforms (Gateway)rToolsrHrxc@ ddlm}m}|r |dytt t |dd}|r-t tjttdt t |dd}t t |d d}t}t}t}|jrPdd lm} |j!d | j#j%d } ddl} | j(|| nd} t |d d} | s t-sd} | r t/dyt |dd} | rt0D]\}}}|| k(s t3t3t5dt6j8t3t5d|ddt6j8t3t5dt6j8||t |t3t|dyt;d| t=ddj?dt0Dyddl m!}|}t tEdxst tEdxs|du}t3t3t5dt6j8t3t5dt6j8t3t5dt6j8t3t5d t6j8t3t5d!t6j8t3t5dt6j8d}|rg|r tG||yt3tId"td#t=d$t=d%t=d&t=d't=d(n\t3|s|rt=d)t3tK|}|r t}tMd*d+d,gd}|dk(rtO|||ytId-t=d.tt=d/tQt=d0|t=d1tRt3t=d2|r+t3t=d3t=d4t=d5|r tU|d6d7s tW||r tU|d8d9s tY||r tU|d:d;s t[||r tU|dd?st_|| @t || r:| jr*t=dA| t=dBt=dC| dD|ta||y#t*$rd} YwxYw)EuRun 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).sectionru│ ⚕ Hermes Setup — z<34su │rz configuration complete!zUnknown setup section: zAvailable sections: rc3(K|] \}}}| ywrtr)rkr s rr z#run_setup_wizard..i s3T'!QA3TsrErOPENAI_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.rJzBTip: 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?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.rrrrrHrxrVrrr)r?zPrevious config backed up to: z9If setup changed a value you customized, restore it with:z cp r)1rrrr[rrrWcopydeepcopyrRrfrVrSrTrwr with_suffixnowstrftimercopy2rrrSETUP_SECTIONSr`r]r\MAGENTArdrerr*rFrZ_run_quick_setuprcrr_run_first_time_quick_setuprU PROJECT_ROOTr_rrdrr>rCr?)argsrrreset_requestedreconfigure_requestedquick_requestedr r(r_dt _backup_pathrrrrr,funcrFactive_provider is_existing migration_ran setup_modes rrun_setup_wizardr s.<|()74%89ODMM.1289 }e!DE74%89O ]F!#K"#K,"..++O<= >   FLLl 3 d$5u=O #7#9+ I  dIt,G .  Cg~L e;E$  ]F"#I G 1L   ? ' [ I )* 1234 /01 }-. ~./ GNO :;\]89 6vwHZ[V$ 6vzK]^v& 6vwHXYV$ 6vyJ_`f 6vwPFk/: ++-3L>BCNOU<.+78-e L s:V VVrcht|dt|t|t|t t dddgd}|dk(rt |t|t tdt td|dk7r td t t||y ) uStreamlined first-time setup: provider, model, terminal & messaging. Applies sensible defaults for TTS (Edge), agent settings, and tools — the user can customize later via ``hermes setup
``. Trrorprqrz#Setup complete! You're ready to go.z) Configure all settings: hermes setupz1 Connect Telegram/Discord: hermes setup gatewayN) rrdrvrWr`rr>rfrer?)r r(rgateway_choices rrr st,6""&) G"A 0 ?  NfF G78 G:;FG G-rc  ddlm}m}m}t t d|dDcgc]}|j ds|}}|dDcgc]}|j dr|}}|}|\} } |xs |xs |xs| | k} | s,tdt tdtd y |rIt tt|d |D]} t d | d t |D]} t t td| d tjtd| j dd| j drtd| d| j dr$td| j d| d d} n!td| j d| d } | r!t| d | td| d td| d |Dcgc]}|j ddk(s|}}|Dcgc])}|j ddk(r|j ds|+}}|rt t dg}|D]W} | j dg}|rdd j!|d d!nd}|j#| j d| d |Yt%d"|}|D]}||} t'| |rt t d#td$td%g}i}|D]S} | d }d&|vrd'}nd(|vrd)}nd*|vrd+}n||vr|j#||j)|gj#| U|Dcgc]}d,d-d.d/j ||}}t%d0|}|D]0}||}||}d1d2d3d/j |d}t t td4|d5|d6tjt |D]} td| j dd| j drtd| d| j dr$td| j d| d d} n!td| j d| d } | rt| d | td7n td8t 3|rPt td9t|d:|D]}td;|d<d=|d>| |d?<t+|t-||y cc}wcc}wcc}wcc}wcc}w)@u6Quick setup — only configure items that are missing.r)get_missing_env_varsget_missing_config_fieldscheck_config_versionu"Quick Setup — Missing Items OnlyF) required_only is_requiredz(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 • rrrrJrz Get key at: rrTrz Saved z Skipped categorytool messagingadvancedz Tool API Keysrr~rrz(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'.TELEGRAMrDISCORDrSLACKru 📱 Telegramu 💬 Discordu 💼 Slack)rrrz)Which platforms would you like to set up?u📱u💬u💼rrrrz SkippedzAdding z& new config option(s) with defaults...z Added rz = r_config_version)rrrrr`rcrrfrerr]r\rarrXrgrrrrrKrWr?)r r(rrrvmissing_requiredmissing_optionalmissing_config current_ver latest_verhas_anything_missingrr missing_toolsmissing_messagingchecklist_labelsrrselected_indicesrplatform_orderr.rr/r platform_labels vars_listrfields rrr s  G56(e<m@T(e<AEE-DX/0N24K  $  $  $  #  @A OP>? c*+,,IJK# -C Ic&k]+ , - # :C G %"S[M*FKK8 9 CGGM2678 9wwu~^CJ<89wwz"CGGHc&k$B#CDtTCGGHc&k$B#CDEs6{E2V 67 3v;-89! :&!1P1AEE*4E4OQPMP" 55  +AEE*4E  _%  YCGGGR(E:?% %) 456RI  # #sww}c&k'J&KI;$W X Y , 6   $ !C$C C  !  *+LMOP $ 7Cv;DT!!d" D9$%%d+  r * 1 1# 6 7($   ,)% c!Qi    , 7   $ C!#&D!$I!'FVLPPQUWYZE G %,ugQtfJ?M N G R r :;<=775>CJ<0177:&"R#f+(F'G#HSWXE"R#f+(F'G#HIE"3v;6!-0!+.  . c.)**P Q $ JE HU5\N#eI6F5GH I J%/ !F-o^Qd s/U U U*UU*U4.U Urt)NF)rN)T)F)x__doc__r"r6rxloggingr=rrrrpathlibrtypingrrrhermes_cli.nous_subscriptionrr7rutilsr r'r getLogger__name__r__file__rursrrrrrr"rr-_DEFAULT_PROVIDER_MODELSrMrPrrQrRrSrTrUrVrWrXrYrZr[hermes_cli.colorsr\r]rchermes_cli.cli_outputrdrerfrgrurzr|rrrrrrcompilerrlistrrrrrrrr?rVrlrdrrrrrrrdrvrrrrrrrrrrrr>rCrOrSr[r_rdrmrrrrrrrrrrrs   &&GA#4   8 $H~$$++335 9 tCH~$sCx.DDcNDtCH~D 6$sCx.6C6SV6[_6 A A A"  GZ] "78 PMPw_}E'Td38n+$sCx.+#+$+    ,;; & ##6588d d  d &S3#.&2::&DE3#3#3mCm$mmWZ]aWammpm(C($((sUYz(eh(V/C/$/$/2CDD:II8_ _ D ' ' TB/DB/Jt tCH~J9>Y$Y$Y$BW$W /d/d2DUDUN d hB4hB` A$A:iibDBN3=l   ACH( VS:l)EX>VB ,E^h$h` > >T >(;4;D;| 44348C=4n O  O" O+. O  O*L+<<= @nW TT^] ]ZP =T=@B4BDBT  "67 i(#%;</? g{#  45 Y.x(.(.(.Vc.Tc.r