IuVe AI для разработчиков
Production workspace API, pairing Desktop Agent и локальное выполнение Avatar — интегрируйте IuVe в рабочие процессы с честными границами capabilities.
🖥️ Desktop Agent и Avatar
Установите desktop agent для вашей платформы и выполните pairing в IuVe Connect. С 0.2.2.148 полный локальный доступ выдаётся автоматически после согласия при установке — без Permission Center. Iulia превращает естественный язык в планы на paired-устройстве.
Pipeline выполнения: Intent → Planner → Executor → Verifier (облачная Orchestra помогает с маршрутизацией; execution на устройстве; без UI Stop Zone на каждом шаге).
Linux
- Текущий стабильный релиз: 0.3.2~rc16
- Размер пакета: ~33 MB
- Скачать: iuve-connect-desktop-agent_0.3.2~rc16_all.deb
- SHA256:
a6febfc21c74d25ac201c63a9e3794b663d77d8ebd947798cb9647f5a6936673 - Установка:
curl -LO https://www.iuve.eu/api/desktop-agent/public-download/linux && sudo apt install ./iuve-connect-desktop-agent_0.3.2~rc16_all.deb - Манифест релиза: /releases/desktop-agent/linux/latest.json
Windows
- Текущий стабильный релиз: 0.3.2~rc2
- Размер пакета: ~46 MB
- Скачать: iuve-connect-windows-agent-0.3.2~rc2-amd64.exe
- SHA256:
fc9250f4b771adcdf3b9da0778574b8605a83bfcc55060c2d6cf15e6b5acb74c - Манифест релиза: /releases/desktop-agent/windows/latest.windows.json
macOS
- Текущий стабильный релиз: 0.3.1~rc35
- Размер пакета: ~111 MB
- Скачать: iuve-connect-macos-agent_0.3.1~rc35_full-local-x86_64.zip
- SHA256:
8144ff8426efb27e5116d7f9bee58cbf6b8507e23ac4ffaa745b22a1dfbc5584 - Манифест релиза: /releases/desktop-agent/macos/latest.macos.json
После установки откройте Agent Console и завершите pairing. Полный локальный доступ выдаётся автоматически; облако — по вашему тарифу IuVe.
Доступ к устройству и согласие: Скачивая и устанавливая IuVe Connect Desktop Agent, вы разрешаете полное локальное управление устройством (файлы, приложения, ввод, сеть, ПО, экран и привилегированные операции), чтобы Avatar мог работать без ручных запросов полномочий. Облачный AI по-прежнему ограничен вашим тарифом IuVe (Free, Pro или Business) и лимитами в консоли → Панель и на iuve.eu/billing.
⚡ Возможности Avatar (0.3.2~rc16)
- Capability Resolver v1 — XDG-пути, режимы маршрутизации (safe / balanced / trusted), алиасы приложений
- Goal Memory — цель сессии, файлы, выбранное окно, вкладка браузера
- Local Search — естественный язык → структурированный поиск по папке
- FOLDER_ANALYSIS — анализ содержимого папки на устройстве
- WEB_RESEARCH — поиск в Google через браузер с честными ToS-ограничениями
- Plan Visualizer — чип pipeline Intent → Planner → Policy → Executor → Vision → Verifier
⚠️ Честные ограничения
- Workspace policy: запись на Desktop может перенаправляться в ~/IuVeWorkspace; чтение использует реальные XDG-пути
- Screen vision входит в полный локальный доступ (0.2.2.148+); cloud verify может помогать, когда Orchestra доступна
- На Linux наиболее зрелая GTK-консоль и desktop automation; Windows и macOS поставляют полные пакеты агента (~30 МБ), но часть Linux-специфичных automation-путей может отличаться.
- Скрапинг job-сайтов (Indeed / LinkedIn) ограничен ToS; извлечение из Google SERP — только MVP
🔌 Обзор REST API
IuVe предоставляет REST API для чата, batch-операций, usage, API-ключей и device endpoints.
Базовый URL сайта: https://www.iuve.eu
Базовый URL API: https://www.iuve.eu/api
| Метод | Endpoint | Назначение |
|---|---|---|
| POST | /api/chat | Одиночный chat-запрос |
| POST | /api/chat/stream | SSE streaming-ответ |
| POST | /api/chat/batch | Пакетная обработка запросов |
| GET | /api/usage | Статистика usage |
| GET | /releases/desktop-agent/linux/latest.json | Манифест релиза Desktop Agent (публичный) |
| GET | /api/desktop-agent/releases/{platform}/latest | Метаданные последнего релиза (требуется auth) |
| GET | /api/desktop-agent/download/{platform} | Аутентифицированная загрузка артефакта |
| GET | /api/desktop-agent/releases/recommended | Автоопределение ОС для рекомендуемой платформы |
🔑 Аутентификация
Создайте API-ключ в dashboard. Передайте его в заголовке Authorization:
Authorization: Bearer YOUR_API_KEY
curl -X POST "https://www.iuve.eu/api/chat" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Analyze this error", "developer_mode": true}'
🛒 Маркетплейс
Self-hosted приложения экосистемы подключаются к вашему IuVe API key и разворачиваются на вашей инфраструктуре.
❓ Частые вопросы
Desktop Agents публично доступны? Да — полные агенты для Linux (.deb), Windows (.exe) и macOS 15+ (.tar.gz) на /releases/desktop-agent/{platform}/. Версия 0.3.2~rc16. После установки выполните pairing в IuVe Connect. Пакеты не подписаны; сертификация платформы — NO-GO до ручного EV PASS.
Avatar выполняет действия в облаке? Нет — Orchestra маршрутизирует intent и vision verify; выполнение плана и policy остаются на paired-устройстве.
Где управлять полномочиями устройства? В Agent Console больше нет выбора grants (0.2.2.148+). Согласие — на странице скачивания/установки; после pairing агент стартует с полным локальным доступом. Облачные квоты AI остаются на тарифах Free / Pro / Business (Панель и iuve.eu/billing).
Нужна помощь с интеграцией? Используйте Team или напишите на hello@iuve.eu.