Imperal Docs
Getting Started

What is Imperal Cloud?

The world's first AI Cloud OS. Webbee ๐Ÿ is its native agent โ€” cloud-modular, life-and-work spanning, Web 3.0-native. First of its kind.

If you're brand new, this page tells you the whole story in plain language. No jargon yet.

The one-sentence pitch

Imperal Cloud is the world's first AI Cloud OS. Webbee ๐Ÿ is its agent.

Not a chatbot. Not "an AI assistant for business." An operating system for the AI era โ€” where the user lives in natural language and the OS runs the rest of the user's work and life through a cloud-modular agent. First of its kind โ€” there is no precedent.

You write "send the Q3 report to Sarah" โ€” Webbee sends it. You say "what was our biggest customer last month?" โ€” Webbee answers from your real data. You ask "book me a flight to Berlin Friday morning, cheapest under $400, aisle" โ€” Webbee books it across mail, calendar, payment, and travel APIs in one move.

It works because of three things: the agent (Webbee โ€” Web 3.0-native, cloud-modular, persistent across surfaces), the web-kernel (the OS layer that orchestrates intent, action, audit, and recovery), and extensions โ€” Python packages that hand Webbee new superpowers.

What's an extension?

An extension is a Python package that does one job well. Some examples:

๐Ÿ“ง

mail

Read inbox, send messages, search threads, draft replies.

๐Ÿ“

notes

Create notes, organize folders, search content.

๐Ÿ“…

calendar

See your schedule, book meetings, find free slots.

๐Ÿ“Š

sql-db

Run queries against the user's database, return rows.

๐ŸŒ

web-tools

Lookup DNS, scan websites, fetch URLs.

๐ŸŽต

spotify

Play music, queue tracks, control playback.

Each extension declares what it can do (in a manifest), and how to do it (in Python handlers). When a user types something, Webbee figures out which extension(s) to call, with which arguments, and runs them.

Where do extensions run?

You type:
  "send the report to sarah"
       โ†“
  Imperal Panel UI (panel.imperal.io)
       โ†“ HTTPS
  Auth Gateway (auth.imperal.io) โ€” checks who you are
       โ†“
  Webbee web-kernel โ€” the brain
       โ†“ runs your extension
  mail extension โ†’ sends the email
       โ†“
  Webbee replies to you in chat: "Sent. โœ…"

You don't manage any of this โ€” you write the extension code, publish it, and Webbee picks it up.

Who's "Imperal Cloud"?

Imperal, Inc. builds Webbee. Imperal Cloud is the platform where Webbee runs and where extensions get installed. As a developer, you interact with Imperal Cloud through three surfaces:

SurfaceWhat it's for
panel.imperal.ioEnd-user app. Where users chat with Webbee, manage settings, install extensions.
panel.imperal.io/developerDeveloper Portal. Submit your extension, see usage, get paid.
docs.imperal.ioThis site. Where you learn how to build.
auth.imperal.ioOAuth + federation. You'll use this when your extension needs to talk to third-party APIs (Google, Spotify, etc).

What about "ICNLI"?

You'll see this acronym in some docs. ICNLI = Infrastructure Contextual Natural Language Interface โ€” the open protocol behind Webbee that maps natural-language intent to context-aware infrastructure actions. Published at icnli.org under CC BY-SA 4.0. (Some earlier writings expand it as "Intelligent Cloud Natural Language Interface" โ€” same protocol, different framing.)

You don't need to know ICNLI to build extensions. It matters when you want to understand the deep architecture or build a Webbee-compatible client of your own.

What does "federal-grade" mean here?

You'll see this phrase a lot. It means the platform takes guarantees seriously:

๐Ÿ”’

Tenant isolation

One user's data never leaks to another. Enforced at the web-kernel layer, not just by convention.

๐Ÿ“

Audit chokepoint

Every action that touches user data is recorded with a federal retention class.

โœ…

Runtime invariants

There are 117+ named invariants (I-* identifiers). PRs that weaken them get blocked.

๐Ÿ›ก๏ธ

Anti-hallucination

Six federal invariants protect chat from fabricated IDs, ungrounded data claims, fake tool calls.

For you as an extension author, this means: the platform handles security, multi-tenancy, and audit for free. Your job is to write the business logic.

What you'll do next

On this page