Skip to content
Projets

nathaninline/ajean has 113 GitHub stars and 15 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 15:56 UTC. Last push 2026-11-13.

Comment ces chiffres sont mesurés

Progression mesurée des étoiles

in 24h
0
in 7 days
Mise à jour retardée
in 15 days
Mise à jour retardée
in 1 month
Mise à jour retardée

Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.

À propos

Run your AI models at home in one binary: chat, persistent memory, web access, browser control, MCP tools, encryption at rest and end-to-end encrypted remote access. Linux, macOS, Windows. FR/EN docs.

IA

README.fr.md

Original

AJEAN

English · Français

Interface web d'AJEAN

Votre propre IA, chez vous. AJEAN est un programme unique qui transforme un ordinateur équipé d'une carte graphique (ou d'un simple processeur) en assistant IA complet : une interface de discussion, une mémoire, des outils, l'accès au web, des tâches planifiées et l'accès depuis votre téléphone, sans que rien ne quitte votre machine.

AJEAN s'occupe de tout ce qui entoure le modèle. Le modèle lui-même tourne sur llama.cpp, qu'AJEAN installe et tient à jour pour vous.

  • Un seul fichier, aucune dépendance. Ni Docker, ni Python, ni environnement à installer. Linux, Windows et macOS.
  • Un assistant, pas seulement un modèle. Il se souvient, range le travail en projets, exécute des commandes, lit le web, pilote un navigateur et travaille seul selon un planning.
  • Vos données restent chez vous. Tout tourne sur votre machine. La mémoire et les conversations peuvent être chiffrées sur le disque, et l'accès à distance est chiffré de bout en bout.
  • Utilisable de partout. Les mêmes conversations sur l'ordinateur et le téléphone, en direct.
  • Se branche sur vos outils. Un point d'accès compatible OpenAI pour n'importe quelle application tierce.

Sommaire


Installation

Téléchargez le fichier de votre système depuis la dernière version :

Système Fichier
Windows ajean-windows.exe (ajean-windows-arm.exe pour ARM)
macOS ajean-macos-arm.zip (Apple Silicon), ajean-macos.zip (Intel)
Linux ajean-linux (ajean-linux-arm pour ARM)

Windows

Double-cliquez sur ajean-windows.exe. AJEAN s'installe, crée ses raccourcis et s'ouvre dans sa propre fenêtre, avec une icône dans la zone de notification (Ouvrir AJEAN / Quitter). Lancer plus tard un fichier plus récent met à jour la copie installée.

Ensuite, dans l'interface :

  1. Le moteur llama.cpp s'installe tout seul au premier lancement (une à deux minutes selon la carte graphique) : il n'y a rien à choisir.
  2. Section Presets : créez un preset, choisissez ou téléchargez un modèle (n'importe quel lien direct vers un .gguf, par exemple sur Hugging Face).

macOS

Décompressez, glissez AJEAN.app dans Applications, puis faites clic droit, Ouvrir la première fois (l'application n'a qu'une signature ad hoc). AJEAN s'ouvre dans sa propre fenêtre et vit dans la barre de menus. Le moteur s'installe tout seul ; ajoutez ensuite un modèle comme sous Windows.

Pour la ligne de commande, prenez plutôt le binaire nu ajean-macos-arm / ajean-macos.

Linux (serveur)

curl -L -o ajean https://github.com/nathaninline/ajean/releases/latest/download/ajean-linux
chmod +x ajean && sudo mv ajean /usr/local/bin/ajean

sudo ajean install        # services, droits, dossiers
ajean edit                # renseigner MODEL=/chemin/vers/modele.gguf
ajean start               # démarre le modèle
ajean ui start            # interface sur http://<hôte>:8090

Le moteur llama.cpp est téléchargé au premier démarrage, dans la variante adaptée à la machine : seul le pilote de la carte graphique est requis (ni git, ni cmake, ni toolkit CUDA). ajean engine montre ce qui est installé ; pour imposer une variante : ajean engine repair --variant=vulkan (ou cuda, rocm, cpu, auto).

Sous Linux, AJEAN tourne en deux services : ajean-engine fait tourner le modèle, ajean-ui sert l'interface, l'accès à distance et le point d'accès OpenAI. Redémarrer l'interface est instantané et ne recharge jamais le modèle.

Mettre à jour

ajean update

Ou le bouton de mise à jour dans l'interface. Chaque version est vérifiée avec ses sommes de contrôle publiées avant d'être installée.


Utiliser AJEAN

Deux modes de discussion

Choisissez le mode avec le bouton à gauche de la zone de saisie.

Mode Pour Ce dont l'IA dispose
Projet un vrai travail qui s'étale sur plusieurs conversations mémoire, trackers, web, navigateur, MCP, tâches
Jean un assistant personnel qui vous connaît sa propre mémoire, des rappels, une conversation unique et continue

Une conversation garde le mode dans lequel elle a commencé. Les outils reposent sur le mode agent, actif d'office ; ajean agent off le coupe (le modèle répond alors sans outils).

Dictée vocale. Le bouton micro à droite du sélecteur de mode enregistre la voix et insère le texte dans le champ. La transcription passe par une API Whisper compatible OpenAI (Groq par défaut), à régler dans Paramètres > Dictée vocale ; sans clé, la dictée du navigateur est utilisée.

Projets

Un projet est un espace de travail avec sa propre mémoire et ses propres conversations, cloisonnées des autres : un pour l'automatisation de votre boîte mail, un pour un logiciel, un pour vos notes. On change de projet depuis la bulle de la zone de saisie.

Chaque projet a :

  • Une mémoire : des pages Markdown que l'IA lit et écrit d'une conversation à l'autre, avec un index tenu à jour automatiquement.
  • Des trackers : des données datées qui s'accumulent (un nombre d'abonnés relevé chaque semaine, un poids, un chiffre d'affaires). L'IA les parcourt niveau par niveau au lieu de tout charger.
  • Une description, fournie à l'IA au début de chaque conversation (contexte, contraintes, ton).
  • Des options dans son menu ⋯ : nom et description, sa mémoire, ses trackers.

Jean, assistant personnel

Jean est un assistant qui se souvient de vous au fil du temps, dans une seule conversation qui ne se termine jamais. Ouvrez-le depuis le menu des modes : il s'affiche en plein écran avec son avatar.

  • Sa propre mémoire : un profil court (prénom, proches, préférences, habitudes), des fiches (procédures, recettes, guides gardés en entier) et un journal où chaque échange est consigné et peut être recherché. La fenêtre Mémoire de Jean permet de tout consulter, corriger ou supprimer.
  • Rappels et tâches : demandez à Jean de vous rappeler quelque chose, et le rappel arrive comme un message de sa part, avec une notification.
  • Un espace de travail séparé : Jean ne peut pas modifier les scripts, fichiers ni la mémoire de vos projets. Il peut les lire, pour voir comment une chose a été faite, et refaire ce dont il a besoin dans son propre espace.
  • Un nouveau départ après une pause : après 3 heures sans message, le contexte du modèle repart à vide. Le fil affiché et le journal restent. La clé JEAN_IDLE_HOURS règle ce délai (0 = jamais).

Historique

L'icône horloge en haut du menu latéral affiche l'historique. Il suit ce que vous faites : les conversations du projet actif en mode Projet, celle de Jean en mode Jean. La recherche couvre toutes les conversations. Une conversation peut être renommée, mise en favori, déplacée vers un autre projet et exportée en Markdown ou en JSON.

Les conversations vivent sur le serveur : elles sont les mêmes sur tous les appareils, en direct. Posez une question sur l'ordinateur, lisez la réponse sur le téléphone. Fermer le navigateur n'arrête jamais une réponse.

Dans le terminal

ajean chat

Une discussion légère dans le terminal, indépendante de l'interface web, avec trois outils (bash, write, edit) qui agissent dans le dossier où vous la lancez. Pratique pour travailler sur un dossier de projet.


Ce que l'IA sait faire

Ces outils sont fournis au modèle tant que le mode agent est actif (il l'est d'office).

Terminal et fichiers. L'IA exécute des commandes (bash, ou cmd.exe sous Windows) et écrit ou modifie des fichiers. Elle travaille dans un dossier de travail jetable ; les scripts à conserver vont dans un dossier scripts séparé qu'aucun nettoyage ne touche.

Mémoire. Par projet, quatre réglages : injectée (l'index est chargé d'avance), recherche (l'IA cherche quand elle en a besoin, plus léger pour le contexte), sur demande (seulement si vous le demandez) ou désactivée.

Web. web_search, web_open, web_read et web_grep, avec le moteur intégré : rien à installer. Il lit les pages servies en HTML, sans exécuter leur JavaScript.

ajean internet on

Pilotage du navigateur. Avec ajean computer on, l'IA pilote un vrai Chrome, Chromium ou Edge sur la machine : ouvrir une page, cliquer, saisir, faire défiler. Elle cible les éléments par l'arbre d'accessibilité, ce qui marche même avec de petits modèles sans vision. Un aperçu en direct montre ce qu'elle fait.

Images. Joignez une image à un message : un modèle multimodal la voit et peut s'en servir. Les images sont redimensionnées avant l'envoi.

Fichiers. Envoyez des fichiers à l'IA depuis le chat (jusqu'à 1 Go chacun), et téléchargez d'un clic ceux qu'elle crée.

Serveurs MCP. Branchez n'importe quel serveur Model Context Protocol (fichiers, bases de données, mail, API) depuis l'interface, en stdio ou en HTTP. Le format est celui de Claude Desktop : une configuration existante se copie telle quelle. Serveurs et outils s'activent un par un.

Tâches planifiées. L'IA travaille seule, à la fréquence choisie (toutes les N minutes, heures ou jours, ou une expression cron) : surveiller une boîte mail, résumer l'actualité, suivre un chiffre. Une tâche peut aussi être un script seul, lancé sans charger le modèle. Chaque tâche choisit son projet, son preset, et si elle a droit à la mémoire et au web. Un interrupteur général met tout en pause.

Notifications. Soyez prévenu quand une réponse est prête, même application fermée ou téléphone verrouillé. Sur iPhone, ajoutez d'abord AJEAN à l'écran d'accueil.

Longues conversations. Quand le contexte se remplit, les anciens échanges sont résumés automatiquement. Les longs résultats d'outils sont archivés et l'IA peut les rappeler au besoin : rien n'est vraiment perdu.


Modèles et moteur

Presets

Un preset est une configuration complète de modèle : fichier du modèle, taille du contexte, couches sur le GPU, cache KV, échantillonnage, raisonnement, décodage spéculatif, vision. Changer de preset recharge le modèle, depuis l'interface ou avec ajean switch. Les presets se règlent dans l'interface ; les fichiers .gguf peuvent être sur n'importe quel disque.

Un preset tourne de l'une de ces trois façons :

Exécution Fonctionnement
Local le llama.cpp livré avec AJEAN charge un .gguf sur vos GPU (au choix, par preset)
API n'importe quel point d'accès compatible OpenAI
Service une commande de votre choix (vLLM, un autre llama-server, TabbyAPI, un script…) qui expose une API OpenAI sur cette machine. AJEAN la lance dans son service moteur, à la place de llama.cpp (démarrage, arrêt, journal, relance en cas d'échec), et utilise son API. L'adresse est déduite du --port de la commande, le modèle est le premier annoncé par l'API.

Télécharger un modèle. Dans l'éditeur de preset, le champ « Télécharger un modèle » cherche directement sur Hugging Face : tapez un nom (« qwen », « gemma »…), choisissez un dépôt puis une quantification, AJEAN la télécharge. Un lien direct vers un .gguf fonctionne toujours.

Moteur

AJEAN fait tourner llama.cpp, et fonctionne comme Ollama : chaque version d'AJEAN livre une version précise de llama.cpp, testée avec elle. Il n'y a ni moteur à choisir, ni mise à jour du moteur à lancer.

  • Installation automatique : le llama-server officiel de cette version est téléchargé au premier lancement, et vérifié par son empreinte SHA-256 inscrite dans AJEAN.
  • Variante choisie pour la machine : CUDA (NVIDIA), ROCm (AMD sous Linux), Vulkan (AMD, Intel), Metal (Mac) ou CPU. Chaque variante est essayée dans un processus à part ; si elle ne démarre pas ou ne voit aucune carte, AJEAN passe à la suivante, jusqu'au CPU. Les bibliothèques CUDA sont livrées avec le moteur : seul le pilote est requis.
  • Mise à jour avec AJEAN : le moteur ne change que lorsqu'une mise à jour d'AJEAN apporte une nouvelle version de llama.cpp ; il est alors remplacé au démarrage suivant.
  • Dépannage : la section Moteur montre la version et la variante, et propose de le réparer (le retélécharger) ou d'imposer une variante.

Les moteurs des versions précédentes (compilation locale, forks personnalisés, ExLlamaV3, AJEAN MoE) ont été retirés en 0.20. Voir docs/moteur.md.

Moteur tiers (Linux). Un preset API externe peut nommer une unité systemd avec EXTERNAL_SERVICE=ajean-<nom>. AJEAN la démarre quand on bascule sur ce preset, l'arrête quand on en change, et attend que les GPU soient libérés avant de charger le modèle suivant. Donnez à l'unité Conflicts=ajean-engine.service.


Accès de partout

ajean.link

ajean link <jeton> (ou le panneau Accès distant) relie votre serveur au relais ajean.link par une connexion sortante : aucun port à ouvrir, fonctionne derrière n'importe quelle box ou en CGNAT. Vous utilisez ensuite AJEAN depuis app.ajean.link, sur n'importe quel appareil.

C'est un service optionnel et payant (4,80 EUR/mois). Tout le reste d'AJEAN est et restera libre et gratuit.

Le relais est aveugle. Il transporte vos données sans pouvoir les lire :

  • tout (discussion et réglages) est chiffré de bout en bout entre votre navigateur et votre serveur (X25519, AES-GCM) ;
  • la clé est dérivée de votre mot de passe (OPAQUE) et ne quitte jamais le navigateur ;
  • chaque navigateur est appairé une fois avec un code à usage unique (ajean link code), et une requête ne peut être ni forgée ni rejouée ;
  • l'application web est servie depuis une origine indépendante (GitHub Pages) : le relais ne peut pas y injecter de code.

Le relais ne voit que des métadonnées techniques (machine en ligne, modèle chargé, VRAM), jamais vos conversations.

Sauvegardes (abonnés). La mémoire, les presets et les réglages peuvent être sauvegardés sur ajean.link, à la main ou chaque jour. Ils sont d'abord chiffrés sur votre serveur : le relais ne stocke qu'un bloc illisible.

Point d'accès compatible OpenAI

Tout outil qui parle l'API OpenAI peut utiliser votre modèle :

  • sur votre réseau : ajean network on rend le point d'accès joignable sur le réseau local ;
  • sur internet : une adresse publique optionnelle https://<machine>.oai.ajean.link/v1, protégée par votre clé d'API. Le TLS se termine sur votre machine ; le relais ne fait passer que du trafic chiffré.

Vos données

Tout se trouve sous $AJEAN_HOME : /etc/ajean sous Linux, %ProgramData%\ajean sous Windows, /etc/ajean ou ~/Library/Application Support/ajean sous macOS. ajean where affiche les chemins exacts.

ajean.db réglages, conversations, clés (une seule base bbolt)
presets/ un fichier .env par preset
memory/ les pages de mémoire, un dossier par projet
models/ les fichiers .gguf
backends/ le moteur llama.cpp (backends/engine/)
workspace/ le dossier de travail jetable de l'IA
scripts/ les scripts que l'IA conserve

Le chiffrement au repos (optionnel, un interrupteur dans les réglages) chiffre la mémoire et les conversations en AES-256. La clé est votre clé d'accès à l'interface : elle ne vit que dans vos navigateurs, le serveur n'en garde que l'empreinte. Une clé de secours est remise à l'activation. Un instantané est pris avant chaque bascule : rien ne peut se perdre.


Référence

Commandes

Moteur (ajean-engine)
  start | stop | restart        gérer le service
  status | logs                 état / journal en direct
  enable | disable              démarrage au boot
  edit                          éditer la configuration dans $EDITOR
  switch [N]                    changer de preset
  test | bench [N]              vérifier que le modèle répond / mesurer la vitesse
  vram | gpu [index...]         mémoire GPU / choisir les GPU (gpu all = tous)
  set-api-key [clé]             protéger l'API du modèle
  network [on|off|status]       point d'accès OpenAI sur le réseau local

Interface (ajean-ui)
  ui [start|stop|restart|status]
  web [PORT]                    sert l'interface au premier plan (défaut :8090)
  set-web-key [clé]             protéger l'API de pilotage

IA
  chat                          discussion en terminal (outils dans le dossier courant)
  export [options] [fichier]    exporter la conversation (--json, --last N...)
  agent [on|off|status]         donner ses outils à l'IA
  computer [on|off|status]      pilotage du navigateur
  memory [off|ondemand|always|search|status]
  internet [on|off|status]

Accès distant (ajean.link)
  link <jeton> | link code | link status | link logout | link newid

Moteur llama.cpp (livré avec AJEAN)
  engine                  version livrée, variante installée
  engine install | repair [--variant=auto|cuda|rocm|vulkan|cpu]

Installation
  install | uninstall | update [--check] | where | version

Clés de configuration

ajean edit ouvre la configuration active au format clé=valeur :

Clé Rôle Défaut
MODEL nom ou chemin du .gguf aucun
HOST / PORT adresse et port du moteur 0.0.0.0 / 8080
CTX taille du contexte 32768
NGL couches sur le GPU 999
BATCH / UBATCH tailles de lot 2048 / 512
THREADS / THREADS_BATCH threads CPU auto
KV_TYPE (_K / _V) quantification du cache KV aucune
CUDA_VISIBLE_DEVICES GPU utilisés tous
REASONING on / off / auto / deepseek aucun
REASONING_BUDGET plafond de tokens de réflexion (-1 = illimité) -1
REASONING_EFFORT low / medium / high, selon le modèle aucun
COMPACT compactage automatique du contexte (off pour le couper) actif
MEM_MODE mode mémoire par défaut (chaque projet peut le changer) always
JEAN_IDLE_HOURS heures de silence avant que Jean reparte d'un contexte vide (0 = jamais) 3
EXTRA_ARGS ajouté tel quel à la ligne de commande de llama-server aucun

Variables d'environnement

Variable Rôle Défaut
AJEAN_HOME dossier des données voir Vos données
AJEAN_MODEL_DIRS dossiers de modèles en plus (séparés par :, ; sous Windows) aucun
AJEAN_SERVICE nom de l'unité du moteur ajean-engine
AJEAN_CHROME navigateur utilisé pour le pilotage détecté
AJEAN_DL_CONNS connexions parallèles pour télécharger un modèle (16 au plus) 8
HF_TOKEN jeton Hugging Face pour les modèles privés aucun
EDITOR éditeur pour ajean edit nano / notepad

API de pilotage

Le service d'interface expose une API HTTP. Protégez-la avec ajean set-web-key, puis envoyez Authorization: Bearer <clé> avec chaque appel /api/*.

Méthode Point d'accès Rôle
GET /api/ping connexion et vérification de la clé
GET /api/status · /api/vram état du service · GPU
GET /api/presets presets, avec l'actif
POST /api/start · /api/stop · /api/restart piloter le moteur
POST /api/chat {"messages":[...]} discussion (flux SSE)

La clé circule en clair en HTTP : pour une exposition publique, placez un HTTPS devant ou passez par ajean.link.


Compiler depuis les sources

Go 1.25 ou plus. AJEAN est écrit entièrement en Go ; l'interface est intégrée au binaire.

git clone https://github.com/nathaninline/ajean.git
cd ajean
CGO_ENABLED=0 go build -o ajean ./cmd/ajean   # Linux, Windows
go build -o ajean ./cmd/ajean                 # macOS (l'icône de la barre de menus exige CGO)

Organisation

  • cmd/ajean/ : point d'entrée et ressources Windows.
  • internal/ajean/ : tout le code, fichiers regroupés par préfixe (web_*, chat_*, llm_*, backend_*, relay_*, sys_*, mcp_*, jean_*) ; une carte dans doc.go.
  • internal/ajean/ui/ : l'interface web. index.html est généré : modifiez ui/src/, puis lancez go generate ./internal/ajean.
  • tools/ : outils de construction (assemble-ui, gen-icon, verify-i18n).

L'interface existe en anglais et en français ; voir docs/TRANSLATING.md pour ajouter une langue.

Licence

MIT. Le fichier intégré marked.min.js est Marked, lui aussi sous licence MIT.