IuVe AI pentru dezvoltatori
API workspace de productie, pairing Desktop Agent si executie Avatar locala — integrati IuVe cu limite oneste de capabilities.
🖥️ Desktop Agent si Avatar
Instalați desktop agent pentru platforma dvs., efectuați pairing prin IuVe Connect și acordați capabilities. Avatar transformă limbajul natural în planuri executate local sub policy.
Pipeline de executie: Intent → Planner → Executor → Verifier (Orchestra cloud asista rutarea; executia ramane pe dispozitiv).
Dupa instalare, deschideti IuVe Connect si finalizati pairing-ul cu grant-uri de capabilities.
⚡ Capabilities Avatar (0.2.2.60)
- Capability Resolver v1 — cai XDG, moduri de rutare (safe / balanced / trusted), alias-uri aplicatii
- Goal Memory — obiectiv sesiune, fisiere, fereastra selectata, tab browser
- Local Search — limbaj natural la cautare structurata in folder
- FOLDER_ANALYSIS — analiza continutului folderului pe dispozitiv
- WEB_RESEARCH — cautare Google in browser cu limite ToS oneste
- Plan Visualizer — chip pipeline Intent → Planner → Policy → Executor → Vision → Verifier
⚠️ Limite oneste
- Policy workspace: scrierile pe Desktop pot fi remapate catre ~/IuVeWorkspace; citirea foloseste cai XDG reale
- Screen vision necesita grant explicit; cloud verify asista dar policy locala controleaza captura
- Linux are cea mai matură consolă GTK și automatizare desktop; Windows și macOS oferă pachete agent complete (~30 MB), unele căi de automatizare specifice Linux pot diferi.
- Scraping site-uri job (Indeed / LinkedIn) limitat de ToS; extractie Google SERP doar MVP
🔌 Prezentare REST API
IuVe expune REST API pentru chat, operatii batch, usage, chei API si endpoint-uri device.
URL de baza site: https://www.iuve.eu
URL de baza API: https://www.iuve.eu/api
| Metoda | Endpoint | Scop |
|---|---|---|
| POST | /api/chat | Chat cu un singur mesaj |
| POST | /api/chat/stream | Raspuns streaming SSE |
| POST | /api/chat/batch | Procesare batch de cereri |
| GET | /api/usage | Statistici de utilizare |
| GET | /releases/desktop-agent/linux/latest.json | Manifest release Desktop Agent (public) |
| GET | /api/desktop-agent/releases/{platform}/latest | Metadate release recente (auth necesară) |
| GET | /api/desktop-agent/download/{platform} | Descărcare artefact autentificată |
| GET | /api/desktop-agent/releases/recommended | Auto-detectare OS pentru platforma recomandată |
🔑 Autentificare
Generati chei API din dashboard. Includeți cheia in header-ul 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}'
🛒 Marketplace
Aplicațiile self-hosted din ecosistem se leagă de cheia API IuVe și rulează pe infrastructura dvs.
❓ Intrebari frecvente
Desktop Agents sunt publici? Da — agenți completi pentru Linux (.deb), Windows (.exe) și macOS 15+ (.tar.gz) la /releases/desktop-agent/{platform}/. Versiunea 0.2.2.60. Pairing prin IuVe Connect după instalare. Pachete nesemnate; certificare platformă NO-GO până la EV PASS manual.
Avatar executa actiuni in cloud? Nu — Orchestra ruteaza intent si vision verify; executia planului si policy raman pe dispozitivul paired.
Unde gestionez grant-urile device? In IuVe Connect dupa pairing — fiecare scope capability necesita aprobare explicita a proprietarului.
Aveti nevoie de ajutor la integrare? Folositi Team sau contactati hello@iuve.eu.