xenevis 0.1.0a1

Deterministic Python Runtime SDK for event-driven bots, automations, and runtime-backed applications.

Xenevis SDK

Xenevis SDK is a deterministic Python Runtime SDK for building event-driven bots, automations, workflows, and runtime-backed application surfaces.

Xenevis is Telegram-first, but not Telegram-only.

It is not an AI runtime by default, not a Telegram API wrapper, and not a hidden-agent framework.

Status

Xenevis SDK is currently in alpha-stage Runtime foundation development.

This package is intended for early testing, development, and validation. Do not treat this alpha release as stable production infrastructure yet.

Install

pip install xenevis

Minimal Telegram bot

import xenevis
from xenevis.telegram import button

xenevis.configure(
    observer=xenevis.observer.console(format="native")
)

@xenevis.telegram.command("start")
async def start(ctx):
    return xenevis.telegram.ui(
        screen="Start",
        text="Welcome to Xenevis.",
        inline=[
            button.callback("Run demo", "demo.run"),
        ],
    )

@xenevis.telegram.callback("demo.run")
async def demo(ctx):
    return xenevis.telegram.ui(
        screen="Demo",
        text="Runtime executed this callback.",
    )

if __name__ == "__main__":
    xenevis.telegram.polling().run()

Core model

Event -> Entry -> Context -> Execution Primitive -> Components -> Signals -> Diagnostics -> Trace -> Surface Delivery

Xenevis Runtime executes the flow. Signals describe what happened. Diagnostics explain problems. Surfaces deliver outputs.

Public primitives

Xenevis exposes four public execution primitives:

xenevis.direct(...)
xenevis.chain(...)
xenevis.trigger(...)
xenevis.stream(...)

There is no public root xenevis.run(...) API.

Privacy

Xenevis SDK does not start background telemetry, automated crash reporting, phone-home behavior, or silent external diagnostics by default.

Diagnostics and observer output are local by default.

License

Xenevis SDK is licensed under the Apache License 2.0.

The Xenevis name, logo, visual identity, and project branding are separate from the software code licensed under Apache-2.0. See BRAND.md.