Imperal SDK

Build extensions for Webbee 🐝 — the agent of Imperal Cloud, the world's first AI Cloud OS.

Write a small Python function. Webbee calls it when a user asks for it — in their own words. Ship it to the Marketplace and get paid.

Documentation · Quickstart · PyPI · imperal.io

</div>

---

Why build here

• Webbee calls your function directly. Typed, structured calls — no LLM guessing your arguments, no silent write failures.
• The platform does the plumbing. Auth, per-user isolation, billing, audit, retries and recovery, multi-tenant safety — handled for you.
• You get paid. Publish to the Imperal Marketplace, price your extension, earn on every use.
• Bring any LLM. Users connect their own model keys — Anthropic, OpenAI, Google, Ollama, any OpenAI-compatible API.

What you can build

• Chat tools — typed @chat.functions Webbee calls straight from natural language.
• Panels — UI surfaces rendered inside the Imperal Panel.
• Skeletons — live data feeds that keep Webbee aware of a user's state.
• Scheduled jobs & webhooks — act on a timer, or react to outside events.
• Typed entities (SDL) — return sdl.Entity objects and the platform reads their meaning (id, title, kind, …) directly instead of guessing field names. Live in production.

Every published extension passes the federal contract — the validators that let Webbee call your code safely. The SDK checks it locally before you ship.

Imperal SDK

A 60-second extension

from imperal_sdk import Extension, ChatExtension, ActionResult
from pydantic import BaseModel, Field

ext = Extension(
    "hello-world",
    version="1.0.0",
    display_name="Hello World",
    description="Greets people by name with a friendly message.",
    icon="icon.svg",
    actions_explicit=True,
)

chat = ChatExtension(ext, tool_name="hello_world", description="Friendly greetings.")


class GreetParams(BaseModel):
    name: str = Field(..., description="Person to greet")


@chat.function("greet", description="Greet someone by name.", action_type="read")
async def greet(ctx, params: GreetParams) -> ActionResult:
    return ActionResult.success(
        data={"message": f"Hello, {params.name}! 🐝"},
        summary=f"Greeted {params.name}",
    )

That's a real, working extension. When a user types "say hi to Alex", Webbee calls greet(name="Alex").

→ Full walkthrough, from zero to published: docs.imperal.io