open source · MIT · v0.1

Un agent de code local,
directement dans votre terminal.

Il lit, écrit, exécute et navigue sur le web, pour vos modèles auto-hébergés. Quatre modes : il code à votre place, explique ses choix, vous guide pas à pas ou relit votre code. Rien ne quitte votre machine.

↳ compatible Ollama ·llama.cpp ·LM Studio ·toute API compatible OpenAI
~/projects/chat · mini-claude
Welcome to mini-claude


Conçu par
Hugo Stawiarski

model    llama3.2:3b
site     miniclaude.fr

Commands
/help     liste toutes les commandes
/model    change ou liste les modèles
/install  installer en local

enter envoyer · /help aide · /clear effacer

↑ Live démo propulsée par Claude · confidentiel et illimité en local.

Pourquoi Mini-claude

Toute la puissance d'un agent, sans quitter votre terminal.

Un agent de code qui lit, écrit, exécute et navigue sur le web, depuis votre machine. Rien ne part dans le cloud.

Un vrai agent, pas juste un chat
Il appelle des outils pour faire le travail : lire vos fichiers, les éditer, lancer des commandes, chercher sur le web. Une boucle agentique, en local.
Quatre modes, à la volée
auto exécute, explain code en justifiant, guided refuse de coder et vous pose les bonnes questions, review relit et pointe ce qui compte. /mode bascule sans relancer.
Il navigue depuis votre machine
Mini-claude ouvre votre propre Chrome, cherche et lit des pages pour vous. Pas de compte à partager, pas de session distante : c’est votre navigateur, votre IP, vos règles.
Local d'abord, par conception
Zéro aller-retour vers le cloud. Vos conversations ne quittent jamais votre machine. Aucune télémétrie. Aucun compte.
Diff avant d'agir, undo après
Toute action qui modifie l’état demande l’autorisation et montre un diff. Dans un repo git, chaque édition est auto-committée, /undo rembobine si le modèle dérape.
Compatible avec tout
Cible l’API HTTP compatible OpenAI. Ollama, llama.cpp, LM Studio, vLLM, plug-and-play.

Installation

Prêt à tourner en 30 secondes.

Assurez-vous qu'Ollama tourne en local, téléchargez un modèle à tool calling, puis lancez Mini-claude.

ollama pull qwen2.5-coder:7b
git clone https://github.com/hugostarte/Mini-Claude.git
cd Mini-Claude && go run ./cmd/tui

Plutôt Docker ? docker compose run tui fonctionne aussi.

Comment ça marche

Trois temps. Une seule boucle.

01 · Demande
Vous parlez, en clair

Vous décrivez la tâche dans votre langue. Le modèle décide quel outil appeler, lire un fichier, éditer, lancer une commande, ouvrir une page.

02 · Outils
L'agent agit

Mini-claude exécute l'outil sur votre machine et renvoie le résultat au modèle. Les actions qui modifient l'état demandent d'abord votre feu vert, diff à l'appui.

03 · Inférence
Ollama (ou toute API OpenAI)

Tourne en local. Mini-claude ne parle que HTTP. Changez de backend, changez de modèle, même client.

Questions fréquentes

Ce qu'on nous demande le plus.

Mes données ou mon code partent-ils sur internet ?
Non. Mini-claude tourne entièrement en local et parle uniquement au modèle que vous hébergez. Vos fichiers, vos prompts et vos conversations ne quittent jamais votre machine. Aucune télémétrie, aucun compte.
Quels modèles et serveurs sont compatibles ?
Tout backend exposant une API HTTP compatible OpenAI : Ollama, llama.cpp, LM Studio, vLLM, ou votre propre serveur. Choisissez un modèle capable d'appeler des outils (tool calling), comme qwen2.5-coder.
Mini-claude est-il gratuit et open source ?
Oui. Le projet est open source sous licence MIT, gratuit, et disponible sur GitHub. Vous pouvez l'utiliser, le modifier et le redistribuer librement.
Sur quels systèmes Mini-claude fonctionne-t-il ?
macOS, Linux et Windows. C'est un binaire Go qui tourne dans votre terminal ; un lancement via Docker est aussi disponible.
En quoi est-ce différent d'un simple chat ?
C'est un agent : il appelle des outils pour lire et éditer vos fichiers, lancer des commandes et naviguer sur le web. Toute action qui modifie l'état affiche un diff et demande votre autorisation, et `/undo` rembobine la dernière édition dans un repo git.

Au blog

Notes de terrain, en clair.

Tutoriels, comparaisons et retours d'XP sur les agents de code locaux.

Tous les articles →

Conçu par Hugo Stawiarski

Open source · MIT · github.com/hugostarte/Mini-Claude