Installation

Choisissez la voie qui vous parle le plus. Les trois donnent la même expérience.

Pré-requis

Avant d’installer mini-claude, il faut un serveur d’inférence. Le plus simple est Ollama :

# macOS
brew install ollama
ollama serve &

# Linux
curl -fsSL https://ollama.com/install.sh | sh

# Téléchargez un petit modèle
ollama pull llama3.2:3b

Tout serveur compatible OpenAI fonctionne (llama.cpp, LM Studio, vLLM…). Il suffit d’un endpoint HTTP qui expose /v1/chat/completions et /v1/models.

Depuis les sources (recommandé)

Il vous faut Go 1.23 ou plus récent.

git clone https://github.com/hugostarte/Mini-Claude.git
cd Mini-Claude
go run ./cmd/tui

Pour produire un binaire autonome :

go build -o mini-claude ./cmd/tui
./mini-claude

Docker Compose

Le dépôt fournit un docker-compose.yml qui orchestre Ollama et le TUI. Comme une TUI a besoin d’un vrai terminal :

docker compose run --rm tui

Pas docker compose up — la TUI a besoin d’un TTY que up ne fournit pas. Le compose file met tty: true et stdin_open: true sur le service tui.

Binaire prêt à l’emploi

Dès que la première release sera coupée, des binaires précompilés pour macOS, Linux et Windows seront attachés à la page release GitHub.

# Exemple macOS arm64 (bientôt)
curl -L https://github.com/hugostarte/Mini-Claude/releases/latest/download/mini-claude-darwin-arm64 -o mini-claude
chmod +x mini-claude
./mini-claude

Vérifier que ça tourne

Au lancement, mini-claude affiche l’écran de bienvenue avec l’ASCII art, le modèle courant, l’URL du serveur et les commandes disponibles. Si vous voyez “upstream 404” en bas, c’est probablement qu’Ollama n’est pas démarré ou que le nom du modèle ne correspond pas — voir Dépannage.

Configuration