irene-tools 0.1.0

Portable, zero-dependency @tool decorator for authoring agent toolkits — runs in Irene, standalone, or under agno.

irene-tools

A tiny, zero-dependency @tool decorator for authoring agent toolkits. A toolkit authored with irene-tools is portable: it runs inside Irene, runs standalone (python toolkit.py), and is usable by agno and other frameworks — because it depends on nothing.

from irene_tools import tool

@tool(category="weather")
def get_forecast(city: str) -> str:
    """Get the forecast for a city."""
    return f"Sunny in {city}"

Why

A capability you build should be yours to keep and move. irene-tools is the opposite of lock-in: the decorator only stamps metadata and returns your function unchanged, so the same toolkit.py works everywhere. No SDK to install a runtime, no framework coupling.

The toolkit convention

my_toolkit/
  toolkit.py       # @tool-decorated functions
  manifest.json    # derived: {name, description, tools[...], manifest_version}

API

• @tool(category="custom", tags=[], description=None, dangerous=False) — mark a function.
• get_workspace() — the dir to read/write files in (host-injected; cwd standalone).
• get_secret(key, default=None) — the current end-user's per-user secret (host-injected).

MIT licensed.