Skip to content

README.md

Latest commit

 

History

History
73 lines (52 loc) · 2.78 KB

README.md

File metadata and controls

73 lines (52 loc) · 2.78 KB

Musher SDK Examples

Part of the Musher Python SDK.

Examples for the Musher Python SDK, organized by use case.

Prerequisites

Requires Python >=3.13.

pip install musher-sdk

Install example dependencies:

task setup:examples

Environment Variables

Variable Required by Description
MUSHER_API_KEY All examples Musher registry API key
OPENAI_API_KEY openai/*, pydantic_ai/* OpenAI API key for agent execution
ANTHROPIC_API_KEY claude/* Anthropic API key for Claude agent SDK

Set your Musher API key via environment variable (recommended):

export MUSHER_API_KEY="msk_..."

Credentials are auto-discovered in this order:

  1. MUSHER_API_KEY environment variable
  2. OS keyring (musher/<host>)
  3. Credential file (~/.local/share/musher/credentials/<host>/api-key)

To override explicitly in code: musher.configure(token="your-token").

Bundles

Examples use published bundles from hub.musher.dev:

Bundle Version Used by
musher-examples/agent-toolkit 2.0.0 basics/pull_bundle.py, basics/inspect_manifest.py
musher-examples/prompt-library 1.2.0 basics/bundle_resources.py, pydantic_ai/*
musher-examples/code-review-kit 1.2.0 claude/*, openai/local_shell_skill.py
musher-examples/data-workflows 1.0.0 openai/hosted_inline_skill.py

Running

uv run python examples/openai/hosted_inline_skill.py

Examples

Example Description Extra deps Status
basics/pull_bundle.py Pull a bundle and list its files — Working
basics/inspect_manifest.py Resolve and inspect a manifest without pulling — Working
basics/bundle_resources.py Access prompts, toolsets, and agent specs — Working
claude/install_project_skills.py Install skills to a project .claude/skills/ dir claude-agent-sdk Working
claude/export_plugin.py Select skills and export as a Claude plugin claude-agent-sdk Working
openai/local_shell_skill.py Export a skill as a local directory for OpenAI openai-agents Working
openai/hosted_inline_skill.py Export a skill as an inline zip for OpenAI openai-agents Working
pydantic_ai/instructions_from_bundle.py Use bundle prompts as PydanticAI agent instructions pydantic-ai Working
pydantic_ai/structured_output.py Structured output with bundle-managed prompts pydantic-ai Working
pydantic_ai/dynamic_instructions.py Dynamic instructions and tools from bundles pydantic-ai Working