IuVe AI for Developers
Production workspace API, Desktop Agent pairing, and Avatar local execution — integrate IuVe into your workflows with honest capability boundaries.
🖥️ Desktop Agent & Avatar
Install the desktop agent for your platform, pair via IuVe Connect, and grant capabilities. Avatar turns natural language into plans executed locally under policy.
Execution pipeline: Intent → Planner → Executor → Verifier (cloud Orchestra assists routing; execution stays on your device).
Linux
- Current stable release: 0.2.2.79
- Package size: ~30 MB
- Download: iuve-connect-desktop-agent_0.2.2.79_all.deb
- SHA256:
48fc10382b717f49c3a894891b7634563ff02c12057feefc095de55d97b94a7b - Install:
curl -LO https://www.iuve.eu/releases/desktop-agent/linux/iuve-connect-desktop-agent_0.2.2.79_all.deb && sudo apt install ./iuve-connect-desktop-agent_0.2.2.79_all.deb - Release manifest: /releases/desktop-agent/linux/latest.json
Windows
- Current stable release: 0.2.2.79
- Package size: ~56 MB
- Download: iuve-connect-windows-agent-0.2.2.79-amd64.exe
- SHA256:
84d4ef16da7aa56944eb8f7d632be6a9c0f2c2bcd1f29023c2c93a6833ff1bf8 - Release manifest: /releases/desktop-agent/windows/latest.windows.json
macOS
- Current stable release: 0.2.2.79
- Package size: ~65 MB
- Download: iuve-connect-macos-agent-0.2.2.79-universal.tar.gz
- SHA256:
80f26bd2145b56efc0023c2f1fc60d2590ce52bc4f74ba4584a0bfc68f862c7a - Release manifest: /releases/desktop-agent/macos/latest.macos.json
After install, open IuVe Connect from your app menu and complete device pairing with capability grants.
⚡ Avatar capabilities (0.2.2.79)
- Capability Resolver v1 — XDG paths, routing modes (safe / balanced / trusted), app aliases
- Goal Memory — session goal, files, selected window, browser tab
- Local Search — natural language to structured folder search
- FOLDER_ANALYSIS — analyze folder contents on device
- WEB_RESEARCH — browser Google search with honest ToS limits
- Plan Visualizer — Intent → Planner → Policy → Executor → Vision → Verifier pipeline chip
⚠️ Honest limits
- Workspace policy: Desktop writes may remap to ~/IuVeWorkspace; reads use real XDG paths
- Screen vision requires an explicit grant; cloud verify assists but local policy gates capture
- Linux has the most mature GTK console and desktop automation; Windows and macOS ship full agent packages (~30 MB) but some Linux-specific automation paths may differ.
- Job-site scraping (Indeed / LinkedIn) remains ToS-limited; Google SERP extract is MVP only
🔌 REST API Overview
IuVe exposes a REST API for chat, batch operations, usage, API keys, and device endpoints.
Site base URL: https://www.iuve.eu
API base URL: https://www.iuve.eu/api
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /api/chat | Single message chat |
| POST | /api/chat/stream | SSE streaming response |
| POST | /api/chat/batch | Batch multiple requests |
| GET | /api/usage | Usage statistics |
| GET | /releases/desktop-agent/linux/latest.json | Desktop Agent release manifest (public) |
| GET | /api/desktop-agent/releases/{platform}/latest | Latest release metadata (auth required) |
| GET | /api/desktop-agent/download/{platform} | Authenticated artifact download |
| GET | /api/desktop-agent/releases/recommended | OS auto-detect for recommended platform |
🔑 Authentication
Generate API keys from your dashboard. Include the key in the Authorization header:
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}'
🛒 Marketplace
Self-hosted ecosystem apps pair with your IuVe API key and deploy on your infrastructure.
- Genesis CMS lines: Travel, Recruit, Auto Service, Construction, Candidate Intelligence — each with Pairing, Identity, and Update Center.
- Keep keys separate: mp_live_* = Marketplace license/domain entitlement; kai_live_* = IuVe AI/API traffic.
- Semantic Marketing (Scan → Optimize → Apply) is available inside supported CMS products for SEO gap analysis.
❓ Frequently asked
Are Desktop Agents publicly available? Yes — full agents for Linux (.deb), Windows (.exe), and macOS 15+ (.tar.gz) at /releases/desktop-agent/{platform}/. Version 0.2.2.79. Pair via IuVe Connect after install. Packages are unsigned; platform certification remains NO-GO until manual EV PASS.
Does Avatar run actions in the cloud? No — Orchestra routes intent and vision verify; plan execution and policy enforcement stay on your paired device.
Where do I manage device grants? In IuVe Connect after pairing — each capability scope requires explicit owner approval.
Are Marketplace license keys the same as AI API keys? No. mp_live_* unlocks product/domain entitlement; kai_live_* authorizes AI/API calls. They are not interchangeable.
Need integration help? Use Team for project access or contact hello@iuve.eu.