Agent IA Météo Local

Un agent IA modulaire qui utilise Ollama pour fournir des informations météorologiques en langage naturel.

🚀 Fonctionnalités

• Agent IA conversationnel utilisant un modèle Ollama local
• Données météo en temps réel via plusieurs APIs :
  • 🆓 OpenMeteo - Gratuit, sans token
  • 🆓 wttr.in - Gratuit, sans token
  • 💎 OpenWeatherMap - Premium, avec token (optionnel)
• Données horaires mondiales via plusieurs APIs :
  • 🆓 WorldTimeAPI - Gratuit, sans token
  • 🆓 TimeAPI.io - Gratuit, sans token
  • 💎 TimeZoneDB - Premium, avec token (optionnel)
  • 🔧 Fallback local - Calcul approximatif si APIs indisponibles
• Architecture modulaire et extensible
• Interface en ligne de commande simple
• Gestion d'erreurs robuste avec fallback automatique
• Configuration facile - fonctionne immédiatement

📋 Prérequis

• Python 3.8+
• Ollama installé et fonctionnel
• Un modèle Ollama téléchargé (ex: llama2, mistral, etc.)
• Clé API OpenWeatherMap Plus nécessaire ! 🎉

🛠️ Installation

1. Clonez le repository puis :

cd personal_local_AI_agent

2. Installez les dépendances :

pip install -r requirements.txt

3. (Optionnel) Configurez votre environnement :

cp .env.example .env
# Éditez .env avec vos paramètres si désiré

4. Lancez l'agent :

python main.py

⚙️ Configuration

Fonctionne immédiatement sans configuration !

Pour des fonctionnalités avancées, configurez le fichier .env avec :

• OLLAMA_MODEL : Le nom de votre modèle Ollama
• OLLAMA_HOST : L'adresse de votre serveur Ollama
• OPENWEATHER_API_KEY : Votre clé API OpenWeatherMap (optionnel)
• TIMEZONEDB_API_KEY : Votre clé API TimeZoneDB (optionnel)

📖 Utilisation

python main.py
> Quelle est la météo à Paris ?
> Quelle heure est-il à Tokyo ?
> Comment sera le temps demain à Lyon ?
> Il va pleuvoir aujourd'hui à Marseille ?
> Quel est le décalage horaire entre Paris et New York ?

🏗️ Architecture

├── main.py              # Point d'entrée
├── config/
│   └── settings.py      # Configuration
├── agents/
│   ├── weather_agent.py # Agent météo principal
│   ├── time_agent.py    # Agent horaire
│   ├── master_agent.py  # Agent maître (routage)
│   └── base_agent.py    # Classe de base
├── services/
│   ├── ollama_service.py # Interface Ollama
│   ├── weather_service.py # Service météo
│   └── time_service.py   # Service horaire
├── utils/
│   ├── logger.py        # Logging
│   └── helpers.py       # Fonctions utilitaires
└── tests/               # Tests unitaires

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à ouvrir une issue ou une pull request.

📄 Licence

MIT License