IuVe IuVe

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

Windows

macOS

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

MethodEndpointPurpose
POST/api/chatSingle message chat
POST/api/chat/streamSSE streaming response
POST/api/chat/batchBatch multiple requests
GET/api/usageUsage statistics
GET/releases/desktop-agent/linux/latest.jsonDesktop Agent release manifest (public)
GET/api/desktop-agent/releases/{platform}/latestLatest release metadata (auth required)
GET/api/desktop-agent/download/{platform}Authenticated artifact download
GET/api/desktop-agent/releases/recommendedOS 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.

Browse Marketplace

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.