b8369b89e6
Nouvelles fonctionnalités: - Demande interactive des clés API au premier lancement - Commandes pour gérer les clés: key set/remove, setup, keys - Stockage sécurisé des clés dans ~/.neuraterm/keys.json - Support variables d'environnement et rechargement à chaud - Gestion intelligente du provider par défaut selon les clés disponibles Commandes ajoutées: - `keys` - Afficher le statut des clés API - `key set <provider>` - Configurer une clé (openai/mistral) - `key remove <provider>` - Supprimer une clé - `setup` - Configuration interactive complète Plus besoin de configurer manuellement les clés avant le lancement! 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
212 lines
4.4 KiB
Markdown
212 lines
4.4 KiB
Markdown
# 🧠 NeuraTerm
|
|
|
|
Terminal IA professionnel avec support multi-providers et suivi avancé des coûts.
|
|
|
|
## 🚀 Fonctionnalités
|
|
|
|
- **Support multi-providers** : OpenAI (ChatGPT) et Mistral AI
|
|
- **Suivi des coûts en temps réel** : Compteur de tokens et calcul précis des coûts
|
|
- **Statistiques détaillées** : Analyse de l'utilisation par provider
|
|
- **Interface professionnelle** : Terminal optimisé pour un usage professionnel
|
|
- **Configuration flexible** : Support des variables d'environnement et fichiers de configuration
|
|
|
|
## 📦 Installation
|
|
|
|
```bash
|
|
npm install -g neuraterm
|
|
```
|
|
|
|
Ou clonez le repo et compilez :
|
|
|
|
```bash
|
|
git clone <repo-url>
|
|
cd NeuraTerm
|
|
npm install
|
|
npm run build
|
|
npm start
|
|
```
|
|
|
|
## ⚙️ Configuration
|
|
|
|
### 🚀 Configuration automatique (recommandée)
|
|
|
|
Au premier lancement, NeuraTerm vous demandera vos clés API de manière interactive :
|
|
|
|
```bash
|
|
neuraterm
|
|
# Suivez les instructions pour configurer vos clés API
|
|
```
|
|
|
|
### 🔑 Gestion des clés API
|
|
|
|
```bash
|
|
# Afficher le statut des clés
|
|
keys
|
|
|
|
# Configurer une nouvelle clé
|
|
key set openai
|
|
key set mistral
|
|
|
|
# Supprimer une clé
|
|
key remove openai
|
|
|
|
# Reconfiguration complète
|
|
setup
|
|
```
|
|
|
|
### Variables d'environnement (optionnel)
|
|
|
|
```bash
|
|
export OPENAI_API_KEY="votre_clé_openai"
|
|
export MISTRAL_API_KEY="votre_clé_mistral"
|
|
```
|
|
|
|
### Fichier de configuration avancée
|
|
|
|
Créez `~/.neuraterm/config.json` pour une configuration avancée :
|
|
|
|
```json
|
|
{
|
|
"ai": {
|
|
"openai": {
|
|
"model": "gpt-4o-mini"
|
|
},
|
|
"mistral": {
|
|
"model": "mistral-large-latest"
|
|
},
|
|
"defaultProvider": "openai"
|
|
},
|
|
"terminal": {
|
|
"theme": "dark",
|
|
"showTokenCount": true,
|
|
"showCost": true,
|
|
"autoSave": true
|
|
}
|
|
}
|
|
```
|
|
|
|
> **Note**: Les clés API sont stockées séparément dans `~/.neuraterm/keys.json` pour plus de sécurité.
|
|
|
|
## 🎯 Utilisation
|
|
|
|
### Commandes de base
|
|
|
|
```bash
|
|
# Lancer NeuraTerm
|
|
neuraterm
|
|
|
|
# Aide
|
|
help
|
|
|
|
# Gestion des clés API
|
|
keys # Statut des clés
|
|
key set openai # Configurer OpenAI
|
|
key set mistral # Configurer Mistral
|
|
setup # Configuration interactive
|
|
|
|
# Poser une question à l'IA
|
|
Comment optimiser mon code Python ?
|
|
|
|
# Changer de provider
|
|
provider mistral
|
|
provider openai
|
|
|
|
# Voir les statistiques
|
|
stats # Toutes les stats
|
|
stats openai # Stats OpenAI uniquement
|
|
cost # Coût total
|
|
|
|
# Configuration
|
|
config # Voir la configuration
|
|
providers # Lister les providers
|
|
```
|
|
|
|
### Exemples d'usage professionnel
|
|
|
|
```bash
|
|
# Analyse de code
|
|
Peux-tu analyser ce fichier Python et suggérer des améliorations ?
|
|
|
|
# Génération de tests
|
|
Génère des tests unitaires pour cette fonction JavaScript
|
|
|
|
# Optimisation
|
|
Comment réduire la complexité de cet algorithme ?
|
|
|
|
# Documentation
|
|
Écris une documentation technique pour cette API
|
|
```
|
|
|
|
## 📊 Suivi des coûts
|
|
|
|
NeuraTerm affiche automatiquement :
|
|
- Nombre de tokens utilisés (entrée → sortie)
|
|
- Coût par requête
|
|
- Coût total cumulé
|
|
- Temps de réponse moyen
|
|
- Statistiques par provider
|
|
|
|
## 🔧 Développement
|
|
|
|
```bash
|
|
# Installation des dépendances
|
|
npm install
|
|
|
|
# Développement avec rechargement
|
|
npm run dev
|
|
|
|
# Compilation
|
|
npm run build
|
|
|
|
# Tests
|
|
npm test
|
|
|
|
# Linting
|
|
npm run lint
|
|
```
|
|
|
|
## 📝 Modèles supportés
|
|
|
|
### OpenAI
|
|
- gpt-4o-mini (recommandé)
|
|
- gpt-4o
|
|
- gpt-4-turbo
|
|
- gpt-4
|
|
- gpt-3.5-turbo
|
|
|
|
### Mistral AI
|
|
- mistral-large-latest (recommandé)
|
|
- mistral-medium
|
|
- mistral-small
|
|
- codestral-latest
|
|
|
|
## 💰 Tarification (novembre 2024)
|
|
|
|
| Provider | Modèle | Entrée (/1K tokens) | Sortie (/1K tokens) |
|
|
|----------|--------|-------------------|-------------------|
|
|
| OpenAI | gpt-4o-mini | $0.00015 | $0.0006 |
|
|
| OpenAI | gpt-4o | $0.005 | $0.015 |
|
|
| Mistral | mistral-large-latest | $0.004 | $0.012 |
|
|
| Mistral | mistral-small | $0.002 | $0.006 |
|
|
|
|
## 🛠️ Architecture
|
|
|
|
- **TypeScript** : Typage fort et développement moderne
|
|
- **Modular** : Architecture modulaire extensible
|
|
- **Multi-provider** : Support facile de nouveaux providers IA
|
|
- **Professional** : Optimisé pour un usage d'entreprise
|
|
|
|
## 📄 Licence
|
|
|
|
MIT - Voir le fichier [LICENSE](LICENSE) pour plus de détails.
|
|
|
|
## 🤝 Contribution
|
|
|
|
Les contributions sont les bienvenues ! Consultez notre guide de contribution pour commencer.
|
|
|
|
## 📞 Support
|
|
|
|
Pour le support et les questions :
|
|
- Ouvrez une issue sur GitHub
|
|
- Consultez la documentation
|
|
- Contactez l'équipe de développement |