better-dsh 0.2.5 → 0.3.0

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-training-unsloth.md

@@ -1,98 +0,0 @@
----
-title: "Unsloth — Unsloth: 2-5x faster LoRA/QLoRA fine-tuning, less VRAM"
-sidebar_label: "Unsloth"
-description: "Unsloth: 2-5x faster LoRA/QLoRA fine-tuning, less VRAM"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Unsloth
-
-Unsloth: 2-5x faster LoRA/QLoRA fine-tuning, less VRAM.
-
-## Skill metadata
-
-| | |
-|---|---|
-| Source | Optional — install with `hermes skills install official/mlops/unsloth` |
-| Path | `optional-skills/mlops\training\unsloth` |
-| Version | `1.0.0` |
-| Author | Orchestra Research |
-| License | MIT |
-| Dependencies | `unsloth`, `torch`, `transformers`, `trl`, `datasets`, `peft` |
-| Platforms | linux, macos |
-| Tags | `Fine-Tuning`, `Unsloth`, `Fast Training`, `LoRA`, `QLoRA`, `Memory-Efficient`, `Optimization`, `Llama`, `Mistral`, `Gemma`, `Qwen` |
-
-## Reference: full SKILL.md
-
-:::info
-The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
-:::
-
-# Unsloth Skill
-
-Assistance with unsloth development, generated from official documentation.
-
-## When to Use This Skill
-
-This skill should be triggered when:
-- Working with unsloth
-- Asking about unsloth features or APIs
-- Implementing unsloth solutions
-- Debugging unsloth code
-- Learning unsloth best practices
-
-## Quick Reference
-
-### Common Patterns
-
-*Quick reference patterns will be added as you use the skill.*
-
-## Reference Files
-
-This skill includes full documentation in `references/`:
-
-- **llms-txt.md** - Llms-Txt documentation
-
-Use `view` to read specific reference files when detailed information is needed.
-
-## Working with This Skill
-
-### For Beginners
-Start with the getting_started or tutorials reference files for foundational concepts.
-
-### For Specific Features
-Use the appropriate category reference file (api, guides, etc.) for detailed information.
-
-### For Code Examples
-The quick reference section above contains common patterns extracted from the official docs.
-
-## Resources
-
-### references/
-Organized documentation extracted from official sources. These files contain:
-- Detailed explanations
-- Code examples with language annotations
-- Links to original documentation
-- Table of contents for quick navigation
-
-### scripts/
-Add helper scripts here for common automation tasks.
-
-### assets/
-Add templates, boilerplate, or example projects here.
-
-## Notes
-
-- This skill was automatically generated from official documentation
-- Reference files preserve the structure and examples from source docs
-- Code examples include language detection for better syntax highlighting
-- Quick reference patterns are extracted from common usage examples in the docs
-
-## Updating
-
-To refresh this skill with updated documentation:
-1. Re-run the scraper with the same configuration
-2. The skill will be rebuilt with the latest information
-
-<!-- Trigger re-upload 1763621536 -->

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-whisper.md

@@ -1,336 +0,0 @@
----
-title: "Whisper — Transcribe and translate speech in 99 languages"
-sidebar_label: "Whisper"
-description: "Transcribe and translate speech in 99 languages"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Whisper
-
-Transcribe and translate speech in 99 languages.
-
-## Skill metadata
-
-| | |
-|---|---|
-| Source | Optional — install with `hermes skills install official/mlops/whisper` |
-| Path | `optional-skills/mlops\whisper` |
-| Version | `1.0.0` |
-| Author | Orchestra Research |
-| License | MIT |
-| Dependencies | `openai-whisper`, `transformers`, `torch` |
-| Platforms | linux, macos |
-| Tags | `Whisper`, `Speech Recognition`, `ASR`, `Multimodal`, `Multilingual`, `OpenAI`, `Speech-To-Text`, `Transcription`, `Translation`, `Audio Processing` |
-
-## Reference: full SKILL.md
-
-:::info
-The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
-:::
-
-# Whisper - Robust Speech Recognition
-
-OpenAI's multilingual speech recognition model.
-
-## When to use Whisper
-
-**Use when:**
-- Speech-to-text transcription (99 languages)
-- Podcast/video transcription
-- Meeting notes automation
-- Translation to English
-- Noisy audio transcription
-- Multilingual audio processing
-
-**Metrics**:
-- **72,900+ GitHub stars**
-- 99 languages supported
-- Trained on 680,000 hours of audio
-- MIT License
-
-**Use alternatives instead**:
-- **AssemblyAI**: Managed API, speaker diarization
-- **Deepgram**: Real-time streaming ASR
-- **Google Speech-to-Text**: Cloud-based
-
-## Quick start
-
-### Installation
-
-```bash
-# Requires Python 3.8-3.11
-pip install -U openai-whisper
-
-# Requires ffmpeg
-# macOS: brew install ffmpeg
-# Ubuntu: sudo apt install ffmpeg
-# Windows: choco install ffmpeg
-```
-
-### Basic transcription
-
-```python
-import whisper
-
-# Load model
-model = whisper.load_model("base")
-
-# Transcribe
-result = model.transcribe("audio.mp3")
-
-# Print text
-print(result["text"])
-
-# Access segments
-for segment in result["segments"]:
-    print(f"[{segment['start']:.2f}s - {segment['end']:.2f}s] {segment['text']}")
-```
-
-## Model sizes
-
-```python
-# Available models
-models = ["tiny", "base", "small", "medium", "large", "turbo"]
-
-# Load specific model
-model = whisper.load_model("turbo")  # Fastest, good quality
-```
-
-| Model | Parameters | English-only | Multilingual | Speed | VRAM |
-|-------|------------|--------------|--------------|-------|------|
-| tiny | 39M | ✓ | ✓ | ~32x | ~1 GB |
-| base | 74M | ✓ | ✓ | ~16x | ~1 GB |
-| small | 244M | ✓ | ✓ | ~6x | ~2 GB |
-| medium | 769M | ✓ | ✓ | ~2x | ~5 GB |
-| large | 1550M | ✗ | ✓ | 1x | ~10 GB |
-| turbo | 809M | ✗ | ✓ | ~8x | ~6 GB |
-
-**Recommendation**: Use `turbo` for best speed/quality, `base` for prototyping
-
-## Transcription options
-
-### Language specification
-
-```python
-# Auto-detect language
-result = model.transcribe("audio.mp3")
-
-# Specify language (faster)
-result = model.transcribe("audio.mp3", language="en")
-
-# Supported: en, es, fr, de, it, pt, ru, ja, ko, zh, and 89 more
-```
-
-### Task selection
-
-```python
-# Transcription (default)
-result = model.transcribe("audio.mp3", task="transcribe")
-
-# Translation to English
-result = model.transcribe("spanish.mp3", task="translate")
-# Input: Spanish audio → Output: English text
-```
-
-### Initial prompt
-
-```python
-# Improve accuracy with context
-result = model.transcribe(
-    "audio.mp3",
-    initial_prompt="This is a technical podcast about machine learning and AI."
-)
-
-# Helps with:
-# - Technical terms
-# - Proper nouns
-# - Domain-specific vocabulary
-```
-
-### Timestamps
-
-```python
-# Word-level timestamps
-result = model.transcribe("audio.mp3", word_timestamps=True)
-
-for segment in result["segments"]:
-    for word in segment["words"]:
-        print(f"{word['word']} ({word['start']:.2f}s - {word['end']:.2f}s)")
-```
-
-### Temperature fallback
-
-```python
-# Retry with different temperatures if confidence low
-result = model.transcribe(
-    "audio.mp3",
-    temperature=(0.0, 0.2, 0.4, 0.6, 0.8, 1.0)
-)
-```
-
-## Command line usage
-
-```bash
-# Basic transcription
-whisper audio.mp3
-
-# Specify model
-whisper audio.mp3 --model turbo
-
-# Output formats
-whisper audio.mp3 --output_format txt     # Plain text
-whisper audio.mp3 --output_format srt     # Subtitles
-whisper audio.mp3 --output_format vtt     # WebVTT
-whisper audio.mp3 --output_format json    # JSON with timestamps
-
-# Language
-whisper audio.mp3 --language Spanish
-
-# Translation
-whisper spanish.mp3 --task translate
-```
-
-## Batch processing
-
-```python
-import os
-
-audio_files = ["file1.mp3", "file2.mp3", "file3.mp3"]
-
-for audio_file in audio_files:
-    print(f"Transcribing {audio_file}...")
-    result = model.transcribe(audio_file)
-
-    # Save to file
-    output_file = audio_file.replace(".mp3", ".txt")
-    with open(output_file, "w") as f:
-        f.write(result["text"])
-```
-
-## Real-time transcription
-
-```python
-# For streaming audio, use faster-whisper
-# pip install faster-whisper
-
-from faster_whisper import WhisperModel
-
-model = WhisperModel("base", device="cuda", compute_type="float16")
-
-# Transcribe with streaming
-segments, info = model.transcribe("audio.mp3", beam_size=5)
-
-for segment in segments:
-    print(f"[{segment.start:.2f}s -> {segment.end:.2f}s] {segment.text}")
-```
-
-## GPU acceleration
-
-```python
-import whisper
-
-# Automatically uses GPU if available
-model = whisper.load_model("turbo")
-
-# Force CPU
-model = whisper.load_model("turbo", device="cpu")
-
-# Force GPU
-model = whisper.load_model("turbo", device="cuda")
-
-# 10-20× faster on GPU
-```
-
-## Integration with other tools
-
-### Subtitle generation
-
-```bash
-# Generate SRT subtitles
-whisper video.mp4 --output_format srt --language English
-
-# Output: video.srt
-```
-
-### With LangChain
-
-```python
-from langchain.document_loaders import WhisperTranscriptionLoader
-
-loader = WhisperTranscriptionLoader(file_path="audio.mp3")
-docs = loader.load()
-
-# Use transcription in RAG
-from langchain_chroma import Chroma
-from langchain_openai import OpenAIEmbeddings
-
-vectorstore = Chroma.from_documents(docs, OpenAIEmbeddings())
-```
-
-### Extract audio from video
-
-```bash
-# Use ffmpeg to extract audio
-ffmpeg -i video.mp4 -vn -acodec pcm_s16le audio.wav
-
-# Then transcribe
-whisper audio.wav
-```
-
-## Best practices
-
-1. **Use turbo model** - Best speed/quality for English
-2. **Specify language** - Faster than auto-detect
-3. **Add initial prompt** - Improves technical terms
-4. **Use GPU** - 10-20× faster
-5. **Batch process** - More efficient
-6. **Convert to WAV** - Better compatibility
-7. **Split long audio** - <30 min chunks
-8. **Check language support** - Quality varies by language
-9. **Use faster-whisper** - 4× faster than openai-whisper
-10. **Monitor VRAM** - Scale model size to hardware
-
-## Performance
-
-| Model | Real-time factor (CPU) | Real-time factor (GPU) |
-|-------|------------------------|------------------------|
-| tiny | ~0.32 | ~0.01 |
-| base | ~0.16 | ~0.01 |
-| turbo | ~0.08 | ~0.01 |
-| large | ~1.0 | ~0.05 |
-
-*Real-time factor: 0.1 = 10× faster than real-time*
-
-## Language support
-
-Top-supported languages:
-- English (en)
-- Spanish (es)
-- French (fr)
-- German (de)
-- Italian (it)
-- Portuguese (pt)
-- Russian (ru)
-- Japanese (ja)
-- Korean (ko)
-- Chinese (zh)
-
-Full list: 99 languages total
-
-## Limitations
-
-1. **Hallucinations** - May repeat or invent text
-2. **Long-form accuracy** - Degrades on >30 min audio
-3. **Speaker identification** - No diarization
-4. **Accents** - Quality varies
-5. **Background noise** - Can affect accuracy
-6. **Real-time latency** - Not suitable for live captioning
-
-## Resources
-
-- **GitHub**: https://github.com/openai/whisper ⭐ 72,900+
-- **Paper**: https://arxiv.org/abs/2212.04356
-- **Model Card**: https://github.com/openai/whisper/blob/main/model-card.md
-- **Colab**: Available in repo
-- **License**: MIT

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/payments/payments-mpp-agent.md

@@ -1,142 +0,0 @@
----
-title: "Mpp Agent — Pay HTTP 402 APIs via Machine Payments Protocol (MPP)"
-sidebar_label: "Mpp Agent"
-description: "Pay HTTP 402 APIs via Machine Payments Protocol (MPP)"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Mpp Agent
-
-Pay HTTP 402 APIs via Machine Payments Protocol (MPP).
-
-## Skill metadata
-
-| | |
-|---|---|
-| Source | Optional — install with `hermes skills install official/payments/mpp-agent` |
-| Path | `optional-skills/payments\mpp-agent` |
-| Version | `0.1.0` |
-| Author | Teknium (teknium1), Hermes Agent |
-| License | MIT |
-| Platforms | linux, macos |
-| Tags | `Payments`, `MPP`, `HTTP-402`, `Tempo`, `Stripe` |
-| Related skills | [`stripe-link-cli`](/docs/user-guide/skills/optional/payments/payments-stripe-link-cli), [`stripe-projects`](/docs/user-guide/skills/optional/payments/payments-stripe-projects) |
-
-## Reference: full SKILL.md
-
-:::info
-The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
-:::
-
-# MPP Agent Skill
-
-Wraps the Machine Payments Protocol (MPP, https://mpp.dev) clients so Hermes can pay for per-request API access against servers that respond with `HTTP 402 Payment Required`.
-
-Three client options, all distributed via npm. Pick the lightest one that solves the user's need. Gated `[linux, macos]` while the broader payments tooling matures on Windows.
-
-## When to Use
-
-- A merchant API returns `HTTP 402` with a `www-authenticate` header — and the user wants to actually pay it, not just log the response.
-- The user asks to "pay per request", "set up an agent wallet", "use Tempo / Privy / AgentCash", or wants to discover MPP-priced services.
-- A Stripe Link spend has produced a Shared Payment Token (SPT) and the agent needs to attach it to the 402 challenge — in that flow, prefer `link-cli mpp pay` (see the `stripe-link-cli` skill).
-
-## Choosing a client
-
-| Tool | When | Setup |
-|---|---|---|
-| `link-cli` | User already has Stripe Link set up, or the 402 challenge advertises `method="stripe"` | see the `stripe-link-cli` skill |
-| Tempo Wallet | MPP services with spend controls, service discovery | `tempo wallet login` |
-| Privy Agent CLI | Multi-chain wallets, browser-based funding | `privy-agent-wallets login` |
-| AgentCash | 300+ pre-priced APIs via one USDC.e balance | `npx agentcash onboard` |
-| `mppx` | Dev + debugging, smallest dep surface | `npm install -g mppx` then `mppx account create` |
-
-Default: if the user already has Stripe Link configured or the 402 challenge specifies `method="stripe"`, use `link-cli mpp pay` (the `stripe-link-cli` skill). Otherwise `mppx` for one-off paid calls and debugging, and Tempo Wallet when the user wants persistent spend controls.
-
-## Prerequisites
-
-- Node.js 20+ on `PATH`
-- A funded wallet (Tempo / Privy / AgentCash) OR an `mppx` account
-- For Tempo / Privy / AgentCash: follow their respective onboarding skills:
-  - `https://tempo.xyz/SKILL.md`
-  - `https://agents.privy.io/skill.md`
-  - `https://agentcash.dev/skill.md`
-
-Use `web_extract` to fetch any of those SKILL.md files if the user picks one.
-
-## Procedure (mppx, fastest path)
-
-Run all commands through the `terminal` tool.
-
-### 1. Install + create an account
-
-```
-npm install -g mppx
-mppx account create
-```
-
-Store the resulting account credentials wherever the CLI tells you (the CLI writes them under its own config — do not paste them into the agent transcript).
-
-### 2. Inspect the merchant's 402 challenge
-
-If the user gives you a URL, probe it first to confirm it actually speaks MPP:
-
-```
-curl -i <url>
-```
-
-A real MPP 402 looks like:
-
-```
-HTTP/1.1 402 Payment Required
-www-authenticate: tempo amount=0.1 currency=...
-```
-
-### 3. Pay the request
-
-```
-mppx <url>
-```
-
-For non-GET methods or request bodies:
-
-```
-mppx <url> --method POST --data '<json>'
-```
-
-`mppx` handles the 402 challenge/credential dance automatically and prints the merchant's actual response on success.
-
-### 4. Verify the receipt
-
-`mppx` attaches the receipt header automatically. To inspect:
-
-```
-mppx <url> -v
-```
-
-## Procedure (Tempo Wallet)
-
-The Tempo Wallet skill at https://tempo.xyz/SKILL.md is the canonical reference; fetch it with `web_extract` and follow it. Headline:
-
-```
-tempo wallet login
-tempo wallet pay <url>
-```
-
-Spend controls and service discovery live in the wallet UI at https://wallet.tempo.xyz.
-
-## Pitfalls
-
-- **`HTTP 402` without `method="stripe"` cannot be paid by Stripe Link.** If the challenge advertises only Tempo / other methods, use `mppx` (or whichever wallet matches) — Link will reject it. Conversely, if it advertises `method="stripe"`, prefer Link via the `stripe-link-cli` skill so the spend goes through the user's approved card.
-- **Multiple challenges in one header.** `www-authenticate` may list several methods (e.g. `tempo, stripe`). The Link CLI's `mpp decode` will pick the Stripe one; `mppx` will pick Tempo. There's no single "right" client — pick by which wallet the user has funded.
-- **Zero-amount challenges.** Some MPP endpoints charge `$0.00` and just want a proof credential. These work without a funded wallet. Don't refuse them as "broken."
-- **Wallet keys never enter agent context.** All four clients store keys under their own config dirs (or generate per-session ephemeral keypairs, in Privy's case). Do not `cat`/`read_file` them.
-- **Server-side MPP is a different skill.** If the user wants to ADD 402 to their own API, this skill is wrong — point them at https://mpp.dev/quickstart/server and the `mppx/nextjs` / `mppx/hono` / `mppx/express` / `mppx/elysia` middlewares. A dedicated `mpp-server` skill may land later.
-
-## Verification
-
-```
-mppx --version && mppx account list
-```
-
-Exit code 0 means installed and an account exists.