vektor
Vektor est un assistant personnel auto-hébergé en Python (FastAPI) qui répond sur Telegram et Alexa, avec un LLM local Ollama Qwen 2.5-14B, RAG sur documentation et mémoire conversationnelle PostgreSQL.
Ficha actualizada 23 sept 2026, 12:36 · upstream 23 sept 2026, 12:36 · release v1.0.0
Qué es vektor
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Vektor est un assistant personnel auto-hébergé capable de fournir l'état réel d'une infrastructure en moins d'une seconde sans jamais passer par le LLM pour les données chiffrées. Il répond aux questions générales avec un modèle local enrichi de documentation indexée (RAG) et conserve une mémoire conversationnelle persistante via PostgreSQL. Contrairement à Jarvis, il n'est pas capable d'agir en agent autonome — toutes actions d'écriture nécessitent une double confirmation explicite. Le canal Alexa est développé mais non opérationnel sur l'appareil physique.
- Fournir un état réel de l'infrastructure (CPU, RAM, stockages, conteneurs) en moins d'une seconde
- Répondre aux questions générales avec une mémoire conversationnelle persistante
- Exécuter des actions administratives (redémarrage Jellyfin, rescan Sonarr/Radarr, pause qBittorrent) après double confirmation
- Accéder à la documentation technique via RAG pour répondre à des questions précises sur l'infrastructure
- Architecture en deux chemins : données live (routeur/API Proxmox/SSH) sans LLM, ou réponse par Ollama Qwen 2.5-14B
- Mémoire conversationnelle persistante via PostgreSQL avec contexte enrichi par RAG sur la documentation
- Whitelist stricte de Telegram par user-id et double confirmation pour toutes actions d'écriture
- API Proxmox accessible uniquement en lecture seule (token dédié, rôle PVEAuditor)
- SSH vers l'hyperviseur forcé avec script fermé : aucune commande libre possible
- Vérification cryptographique complète de la requête Alexa avant réponse
- Pas d'agent autonome : le LLM ne choisit ni n'exécute d'outils, le routage est déterministe par mots-clés
- Whitelist fermée : aucune action hors liste autorisée n'est possible
- Pas de voix opérationnelle : Alexa est en développement mais non activé sur l'appareil physique
- Langue française uniquement, mono-utilisateur assumé
- Modèle quantifié à 14B — raisonnement limité sur sujets complexes ou faits récents
- Latence variable pour les questions complexes (15-60s) vs données live (<1s)
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Copiez .env.example vers .env et configurez POSTGRES_PASSWORD, Vektor_API_TOKEN, le modèle Ollama et la whitelist Telegram,Lancez docker compose up -d --build pour construire et démarrer la stack,Vérifiez la santé avec curl http://127.0.0.1:8092/health,Activer le canal Telegram après création du bot via Docker compose --profile telegram,Le token Alexa est cryptographiquement vérifié avant réponse — l'intégration sur appareil physique reste à finaliser,Les secrets sont stockés hors Git dans un dossier secrets monté en lecture seule, avec prompt système interdisant la révélation de secrets
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.