Publish hermes-skills-autonomous-ai-agents via gitea-publish skill

2026-08-09 08:19:10 +08:00
commit 822ce0c312
26 changed files with 4032 additions and 0 deletions
@@ -0,0 +1,89 @@
+# Configuration, Toolsets & Voice
+
+Edit with `hermes config edit` or `hermes config set section.key value`.
+Full reference: https://hermes-agent.nousresearch.com/docs/user-guide/configuration
+
+### Config Sections (most-used keys)
+
+| Section | Key options |
+|---------|-------------|
+| `model` | `default`, `provider`, `base_url`, `api_key`, `context_length`, `aliases` |
+| `agent` | `max_turns` (90), `tool_use_enforcement`, `service_tier`, `verify_on_stop` |
+| `terminal` | `backend` (local/docker/ssh/modal/daytona/singularity), `cwd`, `timeout` (180) |
+| `compression` | `enabled`, `threshold` (0.50), `target_ratio` (0.20) |
+| `display` | `skin`, `interface` (cli/tui), `language`, `show_reasoning`, `show_cost`, `pet` |
+| `approvals` | `mode` (smart/manual/off), `timeout`, `cron_mode` |
+| `stt` | `enabled`, `provider` (local/groq/openai/mistral/elevenlabs/deepinfra) |
+| `tts` | `provider` (edge/elevenlabs/openai/minimax/mistral/neutts/gemini/piper/kittentts/deepinfra/xai) |
+| `memory` | `memory_enabled`, `user_profile_enabled`, `provider`, `write_approval` |
+| `security` | `redact_secrets`, `tirith_enabled`, `website_blocklist` |
+| `delegation` | `model`, `provider`, `max_concurrent_children`, `max_iterations` (50), `max_spawn_depth` |
+| `checkpoints` | `enabled`, `max_snapshots` (50) |
+| `curator` | `enabled`, `consolidate` (false, opt-in aux-model consolidation), `interval_hours`, `stale_after_days` |
+
+`hermes config check` reports sections missing from an older config.
+
+### Toolsets
+
+Enable/disable via `hermes tools` (interactive) or `hermes tools enable/disable NAME`.
+Full enumeration: `TOOLSETS` dict in `toolsets.py` (`_HERMES_CORE_TOOLS` is the default bundle most platforms inherit).
+
+| Toolset | What it provides |
+|---------|-----------------|
+| `web` / `search` | Web search + extraction / search-only subset |
+| `browser` | Browser automation (Browserbase, Camofox, or local Chromium) |
+| `terminal` | Shell commands and process management |
+| `file` | File read/write/search/patch |
+| `code_execution` | Sandboxed Python execution |
+| `coding` | Code-editing helpers (LSP-backed) |
+| `computer_use` | Desktop GUI control (cua-driver) |
+| `vision` | Image analysis |
+| `image_gen` | Image generation and image-to-image editing |
+| `video` / `video_gen` | Video analysis / video generation |
+| `x_search` | X (Twitter) search (X OAuth or API key) |
+| `tts` | Text-to-speech |
+| `skills` | Skill browsing and management |
+| `memory` | Persistent cross-session memory |
+| `session_search` | Search past conversations |
+| `context_engine` | Pluggable context-engine hooks |
+| `project` | Named multi-folder workspace tools |
+| `delegation` | Subagent task delegation |
+| `cronjob` | Scheduled task management |
+| `clarify` | Ask user clarifying questions |
+| `todo` | In-session task planning |
+| `kanban` | Multi-agent work-queue tools (gated to workers) |
+| `debugging` | Extra introspection tools (off by default) |
+| `safe` | Minimal low-risk toolset for locked-down sessions |
+| `spotify`, `homeassistant`, `discord`, `discord_admin`, `feishu_doc`, `feishu_drive`, `yuanbao` | Service integrations (gated on their credentials) |
+
+Tool changes take effect on `/reset` (new session) — never mid-conversation, to preserve prompt caching.
+
+## Voice
+
+### STT (Voice → Text)
+
+Voice messages from messaging platforms are auto-transcribed.
+
+```yaml
+stt:
+  enabled: true
+  provider: local   # local (faster-whisper, free) | groq | openai | mistral | elevenlabs | deepinfra
+  local:
+    model: base     # tiny, base, small, medium, large-v3
+```
+
+Auto-detect priority: local faster-whisper (`pip install faster-whisper`) → Groq (`GROQ_API_KEY`, free tier) → OpenAI (`VOICE_TOOLS_OPENAI_KEY`) → Mistral Voxtral (`MISTRAL_API_KEY`).
+
+### TTS (Text → Voice)
+
+| Provider | Env var | Free? |
+|----------|---------|-------|
+| Edge TTS (default) | None | Yes |
+| ElevenLabs | `ELEVENLABS_API_KEY` | Free tier |
+| OpenAI | `VOICE_TOOLS_OPENAI_KEY` | Paid |
+| MiniMax | `MINIMAX_API_KEY` | Paid |
+| Mistral | `MISTRAL_API_KEY` | Paid |
+| Gemini | `GOOGLE_API_KEY` | Free tier |
+| NeuTTS / Piper / KittenTTS (local) | None | Free |
+
+Voice commands: `/voice on` (voice-to-voice), `/voice tts` (always voice), `/voice off`.