aioxui 0.0.2

Async Python SDK for XUI panel API

AioxUI

A lightweight async Python SDK for interacting with XUI panel APIs.

Features

• Async client based on aiohttp
• Typed models using Pydantic
• Client management (create, update, delete)
• Traffic management utilities
• Inbound attach/detach support

Installation

pip install aioxui

git clone https://github.com/your-repo/aioxui.git
cd aioxui
pip install -e .

Quick Start

import asyncio

from aioxui import XUI

async def main():
    async with XUI(
        base_url="https://your-panel.com/",
        token="YOUR_TOKEN"
    ) as xui:

        client = await xui.client.get("Javad")
        print(client)

        clients = await xui.client.all()
        print(len(clients))

asyncio.run(main())

Example: Create Client

import asyncio

from aioxui import XUI
from aioxui.models import Client
from aioxui.utils import GB, Timestamp


async def main():
    async with XUI(
        base_url="https://your-panel.com/",
        token="YOUR_TOKEN",
    ) as xui:

        client = Client(
            totalGB=GB.of(10),
            expiryTime=Timestamp.from_days(30),
            limitIp=3,
        )

        add = await xui.client.add(inbound_id=[2, 3], client=client)
        print(add.email)
        print(add.sub_id)


asyncio.run(main())