---
title: Установка
description: Установите Eazy SDK с HTTP-клиентом и библиотекой моделей для первого проекта.
freshness: false
---

Первому JSON SDK нужны ядро, HTTPX и поддержка моделей Pydantic. Установите их командой
`uv add "eazy-sdk-core[httpx,pydantic]"`.

Пакет ядра на PyPI называется `eazy-sdk-core`, а в коде импортируется как `eazy_sdk`. Пока выходят
только альфа-версии, pip требует флаг `--pre`, а uv - параметр `--prerelease allow`.

Команда добавляет синхронный и асинхронный адаптер HTTPX. Само ядро не выбирает HTTP-клиент и
библиотеку моделей за приложение.

В проекте с pip набор зависимостей остаётся тем же:
`python -m pip install "eazy-sdk-core[httpx,pydantic]"`.

## Выберите нужные дополнения

Не устанавливайте полный набор для каждой задачи. Добавьте только транспорт, формат данных или
интеграцию, которые нужны SDK.

| Задача | Дополнение | Команда для uv |
|---|---|---|
| HTTP через HTTPX | `eazy-sdk-core[httpx]` | `uv add "eazy-sdk-core[httpx]"` |
| Синхронный HTTP через Requests | `eazy-sdk-core[requests]` | `uv add "eazy-sdk-core[requests]"` |
| HTTP через curl_cffi | `eazy-sdk-core[curl-cffi]` | `uv add "eazy-sdk-core[curl-cffi]"` |
| Модели Pydantic v2 | `eazy-sdk-core[pydantic]` | `uv add "eazy-sdk-core[pydantic]"` |
| Модели msgspec Struct | `eazy-sdk-core[msgspec]` | `uv add "eazy-sdk-core[msgspec]"` |
| Разбор HTML | `eazy-sdk-core[html]` | `uv add "eazy-sdk-core[html]"` |
| Аккаунты и регистрация | `eazy-sdk-core[accounts]` | `uv add "eazy-sdk-core[accounts]"` |
| Хранилище SQLModel | `eazy-sdk-core[sqlmodel]` | `uv add "eazy-sdk-core[sqlmodel]"` |
| WebSocket | `eazy-sdk-core[websocket]` | `uv add "eazy-sdk-core[websocket]"` |
| Браузерный SDK с Playwright | `eazy-sdk-core[browser,playwright]` | `uv add "eazy-sdk-core[browser,playwright]"` |
| Генератор OpenAPI | `eazy-sdk-core[openapi,yaml]` | `uv add "eazy-sdk-core[openapi,yaml]"` |
| Генератор AsyncAPI | `eazy-sdk-core[asyncapi,yaml]` | `uv add "eazy-sdk-core[asyncapi,yaml]"` |
| Готовые описания защит | `eazy-sdk-core[presets]` | `uv add "eazy-sdk-core[presets]"` |
| XML | `eazy-sdk-core[xml]` | `uv add "eazy-sdk-core[xml]"` |
| Модели Adaptix | `eazy-sdk-core[adaptix]` | `uv add "eazy-sdk-core[adaptix]"` |

Все интеграции входят в один пакет `eazy-sdk-core`. Дополнение ставит только сторонние библиотеки,
которые нужны интеграции, поэтому несколько дополнений перечисляются через запятую в одной
команде.

Дополнение `yaml` у генераторов нужно для файлов YAML. Для спецификации JSON достаточно
`openapi` или `asyncapi`. У браузерной интеграции вместо `playwright` можно выбрать `selenium`,
`camoufox` или `pydoll`.

`eazy-sdk-core[all]` ставит основные HTTP-интеграции, модели и средства работы с данными, но
намеренно не ставит браузерный драйвер. Браузер и его двоичные файлы выбирает приложение.

## Проверьте установку

В проекте с uv запустите
`uv run python -c "import eazy_sdk, httpx, pydantic; print(eazy_sdk.__version__)"`.
В активированном окружении pip уберите префикс `uv run` и начните команду с `python`.

Результат содержит только установленную версию:

```text
0.2.0a15
```

Если вы выбрали другой HTTP-клиент или библиотеку моделей, замените `httpx` и `pydantic` в
строке импорта. Трассировки ошибки быть не должно.

## Требования

- Python 3.13 или новее.
- Менеджер пакетов с поддержкой дополнений Python. Команды выше даны для uv и pip.
- Один поддерживаемый HTTP-клиент для HTTP SDK. Список возможностей клиентов находится в
  {doc}`руководстве по HTTP-интеграциям </integrations/http/index>`.
- Драйвер для браузерного SDK. После установки Playwright загрузите Chromium командой
  `uv run playwright install chromium`. В активированном окружении pip используйте
  `playwright install chromium`.

## Дальше

- {doc}`Соберите первый запрос </start/quickstart>`.
- {doc}`Выберите HTTP-клиент </integrations/http/index>`.
- {doc}`Подключите браузерный драйвер </integrations/browser/index>`.