swarmauri_tool_githubloader 0.9.0.dev48

Load YAML-defined components directly from GitHub repositories.

---

Swarmauri Tool GithubLoader

Load YAML-defined components directly from GitHub repositories.

Installation

pip install swarmauri_tool_githubloader

Usage

from swarmauri_tool_githubloader import GithubLoadedTool

# Load a tool from GitHub
tool = GithubLoadedTool(
    owner="myorg",
    repo="myrepo",
    path="tools/addition.yaml",
)

# Use like any other tool
result = tool(x=1, y=2)

Options

Customize how the loader fetches your component:

• branch – Branch to read from (defaults to "master").
• commit_ref – Specific commit SHA; overrides branch when provided.
• token – GitHub token for private repositories.
• use_cache – Set to False to reload the component on every call.

Advanced examples

Fetch from a branch and pin a commit:

tool = GithubLoadedTool(
    owner="myorg",
    repo="myrepo",
    path="tools/addition.yaml",
    branch="develop",
    commit_ref="0123456789abcdef",
)

Load from a private repository with caching disabled:

import os

tool = GithubLoadedTool(
    owner="myorg",
    repo="private-repo",
    path="tools/addition.yaml",
    token=os.environ["GITHUB_TOKEN"],
    use_cache=False,
)

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.