Installation
Ce guide vous accompagne dans l'installation de JARVIS en environnement de développement.
Prérequis
Système
| Ressource | Minimum | Recommandé |
| OS | macOS 12+ / Ubuntu 22.04+ | macOS 14+ |
| RAM | 8 GB | 16 GB |
| Stockage | 20 GB libre | 50 GB SSD |
| CPU | 4 cores | 8 cores |
Logiciels Requis
| Logiciel | Version | Installation Mac |
| Python | 3.11+ | brew install python@3.11 |
| Git | 2.30+ | brew install git |
| Docker | 24.0+ | docker.com |
Installation Rapide
# 1. Cloner le repository
git clone https://github.com/macsampro/jarvis.git
cd jarvis
# 2. Copier la configuration
cd src/infra
cp .env.example .env
# 3. Éditer .env avec vos clés API
nano .env
# 4. Démarrer l'infrastructure
docker-compose up -d
# 5. Installer le backend Python
cd ../backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# 6. Lancer l'API
uvicorn app.main:app --reload --port 8000
# 7. Vérifier
open http://localhost:8000/docs
Option A: Docker Compose
Services et Ports
| Service | Port | Description |
| PostgreSQL | 5432 | Base de données |
| Redis | 6379 | Cache/sessions |
| MinIO API | 9000 | Stockage S3 |
| MinIO Console | 9001 | Interface MinIO |
| Ollama | 11434 | LLM local |
| Prometheus | 9090 | Métriques |
| Grafana | 3000 | Dashboards |
Commandes Docker
# Démarrer tous les services
docker-compose up -d
# Vérifier le status
docker-compose ps
# Voir les logs
docker-compose logs -f backend
# Arrêter
docker-compose down
Premier Démarrage Ollama
# Télécharger le modèle Llama 3
docker exec -it jarvis-ollama ollama pull llama3
# Vérifier
docker exec -it jarvis-ollama ollama list
Option B: OrbStack (Recommandé Mac)
OrbStack est une alternative légère à Docker pour macOS.
Avantages
- Léger: ~1.3 GB vs ~4+ GB Docker Desktop
- Rapide: Démarrage instantané
- Intégré: Accès via
*.orb.local
Installation
# Installer OrbStack
brew install orbstack
# Créer la machine dev-services
orb create ubuntu:noble dev-services
# Se connecter
ssh dev-services@orb
Configuration .env pour OrbStack
DATABASE_URL=postgresql://dev:dev_password@dev-services.orb.local:5432/jarvis_db
REDIS_URL=redis://dev-services.orb.local:6379/0
MINIO_ENDPOINT=dev-services.orb.local:9000
Vérification
Tester les Services
# PostgreSQL
PGPASSWORD=dev_password psql -h localhost -U jarvis_user -d jarvis -c "SELECT 1;"
# Redis
docker exec -it jarvis-redis redis-cli ping
# API
curl http://localhost:8000/health
Prochaines Étapes