Metadata-Version: 2.4
Name: aetheris-sdk
Version: 0.3.2
Summary: Aetheris SDK: браузер профиля в твоём процессе, наружу — Playwright
Project-URL: Homepage, https://aetheris.h316.online
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: camoufox[geoip]>=0.5.4

# aetheris-sdk

Aetheris SDK: браузер профиля в твоём процессе, наружу — Playwright

```python
import asyncio
from aetheris_client import Aetheris

async def main():
    # Адрес агента, без `/api/v1`: приставку клиент дописывает сам.
    ae = Aetheris("http://127.0.0.1:8766", token=KEY)

    async with ae.open_profile(2, headless=False) as ctx:
        # Вкладка профиля уже открыта; `new_page()` в Firefox открыл бы
        # второе ОКНО, а не вкладку.
        page = ctx.pages[0] if ctx.pages else await ctx.new_page()
        await page.goto("https://example.com")
        print(await page.title())

asyncio.run(main())
```

`open_profile` отдаёт настоящий `BrowserContext` Playwright — работает всё,
что умеет Playwright. Аренда профиля, отпечаток, прокси, выгрузка каталога и
освобождение аренды делаются за тебя; выходить из `async with` обязательно.

Асинхронного контекста у самого `Aetheris` нет: закрывать нечего, каждый
запрос ходит своим соединением. `async with` — только у `open_profile`.

Ключ создаётся в самом Aetheris, на экране «API и MCP», и читается из файла, а
не вписывается в код.

Полное описание установки — `http://127.0.0.1:8766/guide` при запущенном
Aetheris.

Версия 0.3.002, она же версия клиента, к которому эта раздача подходит.
