IuVe AI для разработчиков
Production workspace API, pairing Desktop Agent и локальное выполнение Avatar — интегрируйте IuVe в рабочие процессы с честными границами capabilities.
🖥️ Desktop Agent и Avatar
Установите desktop agent для вашей платформы, выполните pairing в IuVe Connect и выдайте capabilities. Avatar превращает естественный язык в планы, выполняемые локально под policy.
Pipeline выполнения: Intent → Planner → Executor → Verifier (облачная Orchestra помогает с маршрутизацией; execution остаётся на устройстве).
Linux
- Текущий стабильный релиз: 0.2.2.83
- Размер пакета: ~30 MB
- Скачать: iuve-connect-desktop-agent_0.2.2.83_all.deb
- SHA256:
79b761fc390ef26febdc928e4d3d50dcd37f84e57db86599ac31b63948517c10 - Установка:
curl -LO https://www.iuve.eu/releases/desktop-agent/linux/iuve-connect-desktop-agent_0.2.2.83_all.deb && sudo apt install ./iuve-connect-desktop-agent_0.2.2.83_all.deb - Манифест релиза: /releases/desktop-agent/linux/latest.json
Windows
- Текущий стабильный релиз: 0.2.2.83
- Размер пакета: ~56 MB
- Скачать: iuve-connect-windows-agent-0.2.2.83-amd64.exe
- SHA256:
6b399a832da9b31714430564e12832c9e03eefe0618c592c3df58760827fe065 - Манифест релиза: /releases/desktop-agent/windows/latest.windows.json
macOS
- Текущий стабильный релиз: 0.2.2.83
- Размер пакета: ~65 MB
- Скачать: iuve-connect-macos-agent-0.2.2.83-universal.tar.gz
- SHA256:
1902d50452170555f432e7cd37911d74f45129c7583d9437cec112056c328629 - Манифест релиза: /releases/desktop-agent/macos/latest.macos.json
После установки откройте IuVe Connect из меню приложений и завершите pairing с выдачей capabilities.
⚡ Возможности Avatar (0.2.2.83)
- 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 требует явного grant; cloud verify помогает, но локальная policy контролирует захват
- На 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 для лицензий, обновлений и опционального AI.
- Линейки Genesis CMS: Travel, Recruit, Auto Service, Construction, Candidate Intelligence — с Pairing, Identity и Update Center.
- Разделяйте ключи: mp_live_* = лицензия/домен Marketplace; kai_live_* = AI/API трафик IuVe.
- Semantic Marketing (Scan → Optimize → Apply) доступен в поддерживаемых CMS для анализа SEO-пробелов.
❓ Частые вопросы
Desktop Agents публично доступны? Да — полные агенты для Linux (.deb), Windows (.exe) и macOS 15+ (.tar.gz) на /releases/desktop-agent/{platform}/. Версия 0.2.2.83. После установки выполните pairing в IuVe Connect.
Avatar выполняет действия в облаке? Нет — Orchestra маршрутизирует intent и vision verify; исполнение плана и policy остаются на paired-устройстве.
Где управлять grants устройства? В IuVe Connect после pairing — каждый capability scope требует явного одобрения владельца.
Лицензионные ключи Marketplace — это те же AI API-ключи? Нет. mp_live_* открывает entitlement продукта/домена; kai_live_* авторизует AI/API вызовы. Они не взаимозаменяемы.
Нужна помощь с интеграцией? Используйте Team или напишите на hello@iuve.eu.