mirror of https://github.com/remnawave/python-sdk.git synced 2026-05-13 12:16:42 +00:00

feat: Introduce metadata management for users and nodes

- Added MetadataController for handling user and node metadata.
- Implemented models for user and node metadata management.
- Created tests for user and node metadata functionalities.
- Enhanced authentication settings with passkey and OAuth2 configurations.
- Added bulk actions for node updates and responses.
- Refactored existing models to accommodate new features and improve structure.
- Removed obsolete test_imports.py file.
- Updated environment variables for testing.
- Improved error handling in subscription tests.
- Added new node plugin functionalities including cloning and execution commands.

2026-03-11 12:35:42 +01:00

5 KiB

Raw Blame History

Remnawave Python SDK

📢 Repository Migration Notice

This repository has been moved from sm1ky/remnawave-api to remnawave/python-sdk.

PyPI Package Migration:

Legacy versions (≤1.x): Available at remnawave_api (deprecated)

New versions (≥2.x): Available at remnawave

Please update your dependencies to use the new package name for future updates.

A Python SDK client for interacting with the Remnawave API. This library simplifies working with the API by providing convenient controllers, Pydantic models for requests and responses, and fast serialization with orjson.

📦 Installation

New Package (Recommended)

Install the latest version from the new PyPI package:

pip install remnawave

Legacy Package (Deprecated)

If you need older versions (≤1.x), use the legacy package:

pip install remnawave_api  # Deprecated - use 'remnawave' instead

Development Version

If you need the development version:

pip install git+https://github.com/remnawave/python-sdk.git@development

🫥 Compatible versions

Contract Version	Remnawave Panel Version
2.7.0	>=2.7.0
2.6.3	>=2.6.3
2.6.2	>=2.6.2
2.6.1	>=2.6.0
2.4.4	>=2.4.0
2.3.2	>=2.3.0, <2.4.0
2.3.0	>=2.3.0, <2.3.2
2.2.6	==2.2.6
2.2.3	>=2.2.13
2.1.19	>=2.1.19, <2.2.0
2.1.18	>=2.1.18
2.1.17	>=2.1.16, <=2.1.17
2.1.16	>=2.1.16
2.1.13	>=2.1.13, <=2.1.15
2.1.9	>=2.1.9, <=2.1.12
2.1.8	==2.1.8
2.1.7.post1	==2.1.7
2.1.4	>=2.1.4, <2.1.7
2.1.1	>=2.1.1, <2.1.4
2.0.0	>=2.0.0,<2.1.0
1.1.3	>=1.6.12,<2.0.0
1.1.2	>=1.6.3,<=1.6.11
1.1.1	1.6.1, 1.6.2
1.1.0	1.6.0
1.0.8	1.5.7

Dependencies

orjson (>=3.10.15, <4.0.0)
rapid-api-client (==0.6.0)
httpx (>=0.27.2, <0.28.0)

🚀 Usage

Here’s a quick example to get you started:

import os
import asyncio

from remnawave import RemnawaveSDK  # Updated import for new package
from remnawave.models import (  # Updated import path
    UsersResponseDto, 
    UserResponseDto,
    GetAllConfigProfilesResponseDto,
    CreateInternalSquadRequestDto
)

async def main():
    # URL to your panel (ex. https://vpn.com or http://127.0.0.1:3000)
    base_url: str = os.getenv("REMNAWAVE_BASE_URL")
    # Bearer Token from panel (section: API Tokens) 
    token: str = os.getenv("REMNAWAVE_TOKEN")

    # Initialize the SDK
    remnawave = RemnawaveSDK(base_url=base_url, token=token)

    # Fetch all users
    response: UsersResponseDto = await remnawave.users.get_all_users()
    total_users: int = response.total
    users: list[UserResponseDto] = response.users
    print("Total users: ", total_users)
    print("List of users: ", users)

if __name__ == "__main__":
    asyncio.run(main())

❤️ About

This SDK was originally developed by @kesevone for integration with Remnawave's API.

Previously maintained by @sm1ky at sm1ky/remnawave-api.

Now officially maintained by the Remnawave Community at remnawave/python-sdk.

5 KiB Raw Blame History Unescape Escape