Documentation

Netral est un assistant IA multimodal accessible via netral.app ou l'extension VS Code. Créez un compte (email ou Google OAuth) pour commencer.

Premiers pas

• Créez un compte sur netral.app/register
• Choisissez votre plan (Free, Pro, ou Enterprise)
• Accédez au chat sur netral.app/chat
• Posez votre première question — l'IA répond avec recherche web, citations et contexte mémorisé

Installation VS Code

Téléchargez l'extension depuis le VS Code Marketplace ou cherchez "Netral" dans l'onglet Extensions (Ctrl+Shift+X).

# Dans VS Code, générez un token API :
# Paramètres → API → Générer un token
# Collez-le dans l'extension VS Code

L'API Netral permet d'intégrer les capacités de l'assistant dans vos applications. Base URL : https://netral.app/api

Authentification

Toutes les requêtes nécessitent un token Bearer dans le header Authorization. Générez votre token dans Paramètres → API.

curl -X POST https://netral.app/api/chat \
  -H "Authorization: Bearer ntrl_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"message": "Explique-moi la récursion en Python", "model": "ntrl-2.0"}'

Endpoints

• POST /api/chat — Envoyer un message à l'IA
• GET /api/conversations — Lister vos conversations
• GET /api/conversations/:id — Récupérer une conversation
• DELETE /api/conversations/:id — Supprimer une conversation
• GET /api/user — Infos du compte
• PATCH /api/user/settings — Modifier les paramètres

Réponse type

{
  "id": "msg_abc123",
  "content": "La récursion est une technique...",
  "sources": [
    { "url": "https://docs.python.org/...", "title": "Python Docs" }
  ],
  "reasoningTime": 1.8,
  "model": "ntrl-2.0",
  "createdAt": "2026-06-06T00:00:00Z"
}

L'extension Netral pour VS Code est un agent IA natif qui lit, écrit et corrige votre code directement dans l'éditeur.

Fonctionnalités

• Chat intégré : posez des questions sans quitter VS Code (Ctrl+Shift+N)
• Inline edit : sélectionnez du code, demandez une modification, acceptez ou refusez le diff
• Multi-fichiers : l'agent peut lire et modifier plusieurs fichiers simultanément
• Terminal : l'IA peut exécuter des commandes shell (avec votre confirmation)
• Contexte automatique : le fichier ouvert et la sélection sont envoyés comme contexte

Raccourcis

• Ctrl+Shift+N — Ouvrir le chat Netral
• Ctrl+Shift+I — Inline edit sur la sélection
• Ctrl+Shift+A — Ajouter le fichier courant au contexte

Netral intègre une recherche web en direct. L'IA décide automatiquement quand chercher, ou vous pouvez forcer la recherche avec le préfixe @web.

Activation

• Automatique : l'IA détecte les questions nécessitant des infos récentes (actualités, docs techniques, prix)
• Manuelle : préfixez votre message par @web (ex: @web dernières news React 19)
• Jamais : utilisez @offline pour désactiver la recherche

Citations

Chaque information sourcée affiche une citation cliquable [1], [2], etc. Les sources sont listées en bas de la réponse avec le titre et le domaine.

Netral retient vos préférences, votre métier, vos projets et vos technologies favorites pour des réponses de plus en plus pertinentes.

Ce que Netral mémorise

• Votre métier / rôle (ex: développeur React senior)
• Langages et frameworks utilisés
• Projets en cours avec leur contexte
• Préférences de style (code comments, langues, format)
• Informations fournies explicitement

Gestion

Gérez la mémoire dans Paramètres → Mémoire. Vous pouvez voir tout ce que Netral sait sur vous, modifier ou supprimer des entrées, ou désactiver complètement la mémoire.

Connectez vos services Google (Gmail, Calendar, Drive) pour permettre à Netral d'interagir avec vos emails, événements et documents.

Connexion

• Allez dans Paramètres → Intégrations
• Cliquez "Connecter Google"
• Autorisez les permissions via OAuth 2.0
• Netral peut maintenant lire vos emails, gérer votre calendrier et accéder à vos Drive

Cas d'usage

• "Résume mes emails non lus depuis ce matin"
• "Crée un événement demain 14h pour la réunion design"
• "Trouve le document avec les specs API dans mon Drive"

Netral utilise plusieurs modèles d'IA. Le modèle utilisé dépend de votre plan et du type de requête.

NTRL 1.3 (Free)

• Basé sur Mistral Medium
• Excellent rapport qualité/vitesse
• Recherche web incluse
• Limité à 1 message/jour

NTRL 1.2 (Pro)

• Basé sur Gemini 2.5 Flash
• Contexte 1M tokens
• Multimodal natif (images, audio)
• Messages illimités

NTRL 2.0 (Pro/Enterprise)

• Basé sur Kimi K2
• Raisonnement avancé
• Tool-calling natif
• Idéal pour le code complexe

Le token API est votre clé d'accès personnelle. Il permet d'utiliser Netral depuis l'extension VS Code ou votre propre code.

Génération

# 1. Allez dans Paramètres → API
# 2. Cliquez "Générer un token"
# 3. Copiez le token (il ne s'affiche qu'une fois)
# Format: ntrl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Bonnes pratiques

• Stockez le token dans .env.local (exclu de git)
• Utilisez process.env.NETRAL_API_TOKEN dans votre code
• Régénérez votre token tous les 90 jours
• Utilisez des tokens différents par environnement (dev/prod)

Quelle est la limite de contexte ?

Le contexte varie selon le modèle : jusqu'à 32K tokens pour NTRL 1.3, 1M tokens pour NTRL 1.2 (Gemini), et 128K tokens pour NTRL 2.0.

Puis-je uploader des fichiers ?

Oui. Formats supportés : PDF, TXT, CSV, JSON, images (PNG, JPG, WebP), code source (.ts, .js, .py, .rs, .go, etc.). Glissez-déposez dans le chat.

Les réponses sont-elles déterministes ?

L'IA générative produit des réponses différentes à chaque requête. Utilisez le paramètre temperature (0 à 1) dans l'API pour contrôler la créativité.

Y a-t-il une limite de rate ?

Plan Free : 1 message/jour. Pro : 500 messages/heure. Enterprise : illimité. L'API a un rate limit de 60 req/min (Pro) et 300 req/min (Enterprise).

Comment signaler un bug ?

Ouvrez une issue sur GitHub ou contactez netral.ai.team@gmail.com.