Friday Tools

Tool definitions, registries, schema adapters, and a catalog of native and integration tools. Use it to expose typed Python functions to agents or to select built-in tools for your application.

Distribution: friday-framework-tools · Import: friday_tools Python: 3.13.4+ · Status: alpha · License: MIT

Installation

python -m pip install "friday-framework-tools==0.1.0a4"

Friday distributions use the same release version; keep internal Friday dependencies aligned.

Quick start: define and invoke a tool

import asyncio

from friday_tools import DefaultToolRegistry, FunctionTool

def greet(name: str) -> str:
    """Return a greeting."""
    return f"Hello, {name}!"

async def main() -> None:
    tool = FunctionTool(greet)
    registry = DefaultToolRegistry()
    registry.register(tool)
    print(registry.list_names())
    print(await tool.execute(name="Friday"))

asyncio.run(main())

Expected output includes greet and Hello, Friday!. This invokes a local function directly; it does not call a model or register every built-in tool.

Catalog and integrations

Native categories include filesystem, shell, web, git, text, data, code and memory. get_default_registry() supplies the shared default registry; use a new DefaultToolRegistry when your application needs its own membership.

For example: python -m pip install "friday-framework-tools[documents]==0.1.0a4". Extras install dependencies; applications still configure and admit tools explicitly. FunctionTool and the typed FridayTool/ToolResult surface have different result contracts; choose the one your caller expects.

Execution boundary

A registry and a generated JSON schema do not grant safe execution. Configure filesystem roots, shell restrictions, sandbox choice, tool selection and result sanitization in the owning application. External tools may access networks, incur charges, or mutate files. Read-only tools are the appropriate starting point for a new integration.

Development

Work from the monorepo root after the shared contributor setup. Run the focused suite:

uv run --no-sync pytest packages/friday-tools/tests_tools -q

Documentation and support

Tools guide · Security configuration · Sandbox backends · Source · Issues · Contributing

License

MIT.