Journal Morpheus : un agent de programmation en français, en un seul fichier Python, pour les modèles locaux

Bonjour,

Je te présente Morpheus AI Agent, un petit projet que je viens de publier sous licence MIT : un assistant de programmation dans le terminal, à la manière de Claude Code, mais pensé d'abord pour les modèles locaux (Ollama, llama.cpp) et entièrement en français.

Dépôt : https://github.com/JIMMYASH/morpheus-ai-agent

L'idée de départ

J'ai une machine avec pas mal de mémoire unifiée et je voulais un agent de code qui tourne chez moi, sans envoyer mon code ailleurs. Les outils existants sont souvent en anglais, lourds à installer, ou supposent un modèle aussi fiable que les gros modèles commerciaux. Or un modèle local, même bon, invente des noms d'outils, oublie des paramètres, écrit ses appels d'outils en texte au lieu de les appeler, ou affirme avoir fini sans rien avoir modifié.

Morpheus compense tout cela dans le code plutôt que dans le prompt : alias de noms d'outils et de paramètres, lecture des appels écrits en XML, en JSON ou en pseudo-code, relance quand le modèle dit « c'est fait » sans avoir touché un fichier, blocage des appels répétés en boucle.

Ce qu'il fait

• Il lit les fichiers, les modifie, lance des commandes, cherche sur le web, tient une liste de tâches.
• Chaque action est montrée avant d'être faite : un diff pour une modification, la commande complète pour bash, avec une validation oui / non / toujours. /annuler défait la dernière demande.
• Plusieurs modes : Chat (lecture seule, par défaut), Développeur (modifications validées), Plan (explorer et proposer sans toucher), Auto (activé à la main, il laisse passer les modifications dans le projet et les commandes jugées sûres).
• Une interface web (morpheus --web) : chat en direct, volet de code et de diff, projets et conversations, invités ayant chacun leur espace.
• Un bot Telegram personnel, avec des boutons de validation, pour lancer une tâche depuis son téléphone.
• Il peut aussi piloter Claude Code ou les modèles cloud d'Ollama, en gardant ses propres règles de validation.

Les choix techniques

• Un seul fichier, zéro dépendance : morpheus.py (environ 6 000 lignes), uniquement la bibliothèque standard de Python 3.10+. Pas de pip install, pas d'environnement virtuel : un git clone et un alias suffisent.
• La sécurité d'abord : sudo, su, mkfs, rm -rf /… sont toujours refusés. L'écriture de fichier par bash (cat >, sed -i, heredoc) est refusée pour obliger le modèle à passer par les outils d'édition, avec aperçu et possibilité d'annuler. Chaque morceau d'une commande chaînée est vérifié séparément, pour qu'un « toujours » accordé à cd ne couvre pas un rm qui suit. Une commande arrêtée l'est avec tout son groupe de processus.
• Des tests sans vrai modèle : un faux serveur rejoue des réponses écrites à l'avance. On peut donc vérifier le comportement face à un modèle qui se trompe, sans GPU.

Installation

git clone https://github.com/JIMMYASH/morpheus-ai-agent.git ~/outils/morpheus
echo "alias morpheus='python3 ~/outils/morpheus/morpheus.py'" >> ~/.bashrc
source ~/.bashrc
cd ~/projets/mon-projet && morpheus

Il faut Linux, Python 3.10 ou plus, et Ollama avec un modèle de code (par exemple kimi-k2.7-code:cloud ou qwen3-coder ou n'importe quel autre modèle agentique).

Avertissement honnête

Morpheus agit avec les droits de ton compte : ce n'est pas un bac à sable, relis ce qu'il propose avant de valider. L'interface web est en HTTP simple, protégée par un jeton : à réserver à un réseau de confiance.

Je ne suis pas développeur de métier, et une bonne partie du code a été écrite avec l'aide d'une IA : je le dis franchement. Tous les retours m'intéressent, les critiques comprises : essais avec d'autres modèles locaux, bugs, idées, ou avis sur les règles de sécurité.

Merci de m'avoir lu !