aisyah ai

? Aisyah ai?

Aisyah AI est un puissant bot télégramme construit avec des travailleurs CloudFlare qui combine plusieurs capacités d'IA. Il peut parcourir le Web, définir des rappels, parler, prédire la météo, analyser les images et comprendre les messages vocaux. Le bot maintient le contexte dans les conversations via Redis, ce qui le rend parfait pour les chats privés et les interactions de groupe.

? Captures d'écran et démo

Caractéristiques

• ? Capacités avancées d'IA

  • Compréhension du langage naturel avec les modèles GPT
  • Analyse d'image et reconnaissance d'objets
  • Conversion de la parole et du texte et du texte-parole
  • Conversations de contexte dans les chats privés et en groupe

• Outils intelligents

  • Navigation sur le Web et récupération d'informations
  • Prévisions météorologiques en temps réel
  • Rappels et notifications de la tâche
  • Support de chat de groupe avec rétention de contexte

• ☁️ Architecture moderne

  • Construit sur les travailleurs de CloudFlare pour une grande évolutivité
  • Architecture de microservices pour la modularité
  • Historique de chat propulsé par redis
  • Déploiement sans serveur rentable

• ? Intégrations API

  • Openai GPT pour le traitement des langues
  • Google Recherche personnalisée pour la navigation Web
  • Openweathermap pour les données météorologiques
  • API Télégramme Bot pour la messagerie
  • Supabase pour le stockage de fichiers
  • Services supplémentaires pour les capacités améliorées

? Pourquoi ouvrir uniquement?

Nous avons choisi de soutenir exclusivement les modèles OpenAI (en particulier GPT-3.5-Turbo et GPT-4O-Mini) pour plusieurs raisons:

1. Cohérence du modèle : les modèles OpenAI fournissent les réponses les plus cohérentes et les plus de haute qualité entre différentes langues et les cas d'utilisation.
2. Effectif : GPT-4O-MINI offre un excellent équilibre entre la qualité de la sortie et les prix.
3. Capacité multilingue : après des tests approfondis, les modèles OpenAI ont démontré des performances supérieures dans la gestion de plusieurs langues naturellement.
4. Simplicité de la mise en œuvre : Alors que des services comme OpenRouter offrent un accès à divers modèles, les soutenir introduirait une complexité supplémentaire dans les mappages de noms de modèle et la gestion des réponses.

Remarque: Nous comprenons l'intérêt pour les modèles et les fournisseurs alternatifs (comme OpenRouter, anthropic, etc.). Cependant, pour maintenir la simplicité du code et assurer un comportement de bot cohérent, nous avons décidé de nous concentrer sur les offres d'Openai. Si vous devez utiliser différents modèles, vous devrez déborder le projet et modifier les configurations du modèle en conséquence.

Usage

Commandes de base

• /start - commencer l'interaction avec le bot
• /settings - Configurer les paramètres de bot (modèle LLM, Persona, voix, etc.)
• /help - obtenir de l'aide sur les commandes disponibles

Remarque : Il s'agit d'un projet personnel conçu à des fins d'apprentissage et d'expérimentation.

Structure du projet

Le projet est organisé en plusieurs microservices:

• aisyah-ai-telegraph : Orchestrateur principal qui gère les interactions télégrammes
• aisyah-ai-agent : Agent de base de l'IA qui traite les demandes
• aisyah-ai-explorer : Capacité de navigation sur le Web
• aisyah-ai-reminder : Rappel Management
• aisyah-ai-sonata : service de texte à la disposition
• aisyah-ai-storm : Prédiction météorologique
• aisyah-ai-vision : analyse d'image
• aisyah-ai-whisper : Service de la parole au texte

Démarrage rapide

Condition préalable

• Node.js (version LTS recommandée)
• Fil (v4.3.1 ou version ultérieure)
• Compte CloudFlare (Free Tier Works)
• Jeton de bot télégramme
• Clé API Openai
• Instance redis pour l'historique du chat (vous pouvez utiliser le niveau gratuit Upstash)

Installation

1. Clone le référentiel:

   git clone https://github.com/husniadil/aisyah-ai.git
   cd aisyah-ai

2. Installez les dépendances:

   yarn install

3. Configurez CloudFlare: d'abord, obtenez votre jeton API CloudFlare:

   1. Allez sur https://dash.cloudflare.com/profile/api-tokens
   2. Localiser "Edit CloudFlare Workers", puis "Utiliser le modèle"
   3. Remplissez les règles
   4. Cliquez sur "Continuer au résumé" et créer le jeton
   5. Exporter le jeton comme variable d'environnement:

       export CLOUDFLARE_API_TOKEN=your_api_token_here

   6. Pour une configuration persistante, ajoutez-la à votre profil de shell (~ / .zshrc, ~ / .bashrc, etc.):

       echo ' export CLOUDFLARE_API_TOKEN=your_api_token_here ' >> ~ /.zshrc

   Remarque: N'utilisez pas wrangler login car elle entre en conflit avec la méthode d'authentification du jeton API.

4. Configurer les fichiers environnementaux:

    # Copy Cloudflare configuration files
   cp packages/aisyah-ai-agent/wrangler.toml.example packages/aisyah-ai-agent/wrangler.toml
   cp packages/aisyah-ai-explorer/wrangler.toml.example packages/aisyah-ai-explorer/wrangler.toml
   cp packages/aisyah-ai-reminder/wrangler.toml.example packages/aisyah-ai-reminder/wrangler.toml
   cp packages/aisyah-ai-sonata/wrangler.toml.example packages/aisyah-ai-sonata/wrangler.toml
   cp packages/aisyah-ai-storm/wrangler.toml.example packages/aisyah-ai-storm/wrangler.toml
   cp packages/aisyah-ai-telegraph/wrangler.toml.example packages/aisyah-ai-telegraph/wrangler.toml
   cp packages/aisyah-ai-vision/wrangler.toml.example packages/aisyah-ai-vision/wrangler.toml
   cp packages/aisyah-ai-whisper/wrangler.toml.example packages/aisyah-ai-whisper/wrangler.toml
   
   # Copy environment variables
   cp packages/aisyah-ai-agent/.dev.vars.example packages/aisyah-ai-agent/.dev.vars
   cp packages/aisyah-ai-explorer/.dev.vars.example packages/aisyah-ai-explorer/.dev.vars
   cp packages/aisyah-ai-reminder/.dev.vars.example packages/aisyah-ai-reminder/.dev.vars
   cp packages/aisyah-ai-sonata/.dev.vars.example packages/aisyah-ai-sonata/.dev.vars
   cp packages/aisyah-ai-storm/.dev.vars.example packages/aisyah-ai-storm/.dev.vars
   cp packages/aisyah-ai-telegraph/.dev.vars.example packages/aisyah-ai-telegraph/.dev.vars
   cp packages/aisyah-ai-vision/.dev.vars.example packages/aisyah-ai-vision/.dev.vars
   cp packages/aisyah-ai-whisper/.dev.vars.example packages/aisyah-ai-whisper/.dev.vars

5. Configurer les paramètres spécifiques au package:

   Espaces de noms Cloudflare KV

   Créez les espaces de noms KV requis et notez leurs ID:

    # For settings storage
   yarn w aisyah-ai-agent wrangler kv:namespace create SETTINGS
   
   # For chat history
   yarn w aisyah-ai-telegraph wrangler kv:namespace create CHAT_HISTORY
   
   # For reminders
   yarn w aisyah-ai-reminder wrangler kv:namespace create REMINDERS

   Configurations spécifiques au package

   Aisyah-ai-Telegraph (bot principal)

    # In packages/aisyah-ai-telegraph/.dev.vars
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   TELEGRAM_BOT_TOKEN=your_telegram_bot_token
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

   Aisyah-ai-Agent (Core AI)

    # In packages/aisyah-ai-agent/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   LANGCHAIN_API_KEY=your_langchain_api_key
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   AGENT_PERSONA_AISYAH_DEFAULT=your_system_prompt_for_persona_default
   AGENT_PERSONA_AISYAH_JAWIR=your_system_prompt_for_persona_jawir
   AGENT_PERSONA_PERSONAL_ASSISTANT=your_system_prompt_for_persona_personal_assistant

   Aisyah-Aai-Vision (analyse d'image)

    # In packages/aisyah-ai-vision/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   Aisyah-ai-Whisper (discours au texte)

    # In packages/aisyah-ai-whisper/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   Aisyah-ai-sonata (text-to-speech)

    # In packages/aisyah-ai-sonata/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   # Get from https://supabase.io
   SUPABASE_URL=your_supabase_project_url
   SUPABASE_KEY=your_supabase_storage_key
   # Get from https://elevenlabs.io
   ELEVENLABS_API_KEY=your_elevenlabs_api_key

   Aisyah-ai-storm (temps)

    # In packages/aisyah-ai-storm/.dev.vars
   OPEN_WEATHER_MAP_API_KEY=your_openweathermap_api_key

   Aisyah-ai-explorer (Browser Web)

    # In packages/aisyah-ai-explorer/.dev.vars
   # Get from https://programmablesearchengine.google.com/
   GOOGLE_SEARCH_API_KEY=your_google_api_key
   GOOGLE_SEARCH_ENGINE_ID=your_search_engine_id

   Aisyah-aimider (rappels)

    # In packages/aisyah-ai-reminder/.dev.vars
    REMINDERS_APP_ID=your_reminders_app_id
    REMINDERS_API_KEY=your_reminders_api_key

   Mettre à jour les fichiers wrangler.toml

   Mettez à jour wrangler.toml de chaque package avec les ID d'espace de noms KV correspondant à partir de l'étape précédente:

    # In packages/aisyah-ai-telegraph/wrangler.toml
   kv_namespaces = [
     { binding = " CHAT_HISTORY " , id = " your_chat_history_namespace_id " }
   ]
   
   # In packages/aisyah-ai-agent/wrangler.toml
   kv_namespaces = [
     { binding = " SETTINGS " , id = " your_settings_namespace_id " }
   ]
   
   # In packages/aisyah-ai-reminder/wrangler.toml
   kv_namespaces = [
     { binding = " REMINDERS " , id = " your_reminders_namespace_id " }
   ]

6. Déployer les travailleurs:

   yarn deploy

7. Configurez votre bot télégramme:

   • Créez un nouveau bot avec @botfather
   • Définissez l'URL de Webhook sur votre point de terminaison du travailleur CloudFlare
   • Configurez les paramètres du bot via l'interface de chat télégramme

Développement

Scripts disponibles

• yarn w : Exécuter des commandes spécifiques à l'espace de travail
• yarn deploy : déploie tous les travailleurs
• yarn types : générer des types de dactylographie
• yarn format : code de format utilisant le biome

Ajout de nouvelles fonctionnalités

1. Créer un nouveau package dans le répertoire packages
2. Implémentez votre fonctionnalité à l'aide des travailleurs CloudFlare
3. Ajouter une configuration dans wrangler.toml
4. Enregistrez la nouvelle capacité dans aisyah-ai-agent

? Configuration supplémentaire

Configuration redis

1. Configurez une instance Redis:

   • Créez une base de données Redis gratuite à Upstash
   • Obtenez votre URL de connexion Redis et vos détails d'authentification

2. Configurer Redis dans votre environnement:

    # Add to packages/aisyah-ai-telegraph/.dev.vars
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

Clés API requises

Assurez-vous d'obtenir et de configurer ces touches API:

• Clé API OpenAI pour les capacités LLM et Vision
• Clé API Langchain pour le traitement amélioré du langage
• Clé API Openweathermap pour les prévisions météorologiques
• Supabase Project et Keys de stockage pour la gestion des fichiers

Ajoutez-les aux fichiers .dev.vars respectifs dans chaque package.

❗ Dépannage

Problèmes communs

1. Le déploiement des travailleurs échoue

   • Assurer que le jeton API CloudFlare a des autorisations correctes
   • Vérifiez si les noms de travailleurs dans wrangler.toml sont uniques
   • Vérifiez que les liaisons d'espace de noms KV sont correctes

2. Bot ne répond pas

   • Confirmer que l'URL de la webhook est correctement définie
   • Vérifiez la validité des jetons de bot télégramme
   • Vérifiez que la connexion redis fonctionne

3. Les fonctionnalités ne fonctionnent pas

   • Assurez-vous que toutes les touches API requises sont valides et correctement configurées
   • Vérifiez les journaux des travailleurs correspondants dans le tableau de bord CloudFlare
   • Vérifiez que les variables d'environnement sont définies correctement

Mode de débogage

Activer le mode de débogage en réglant:

 # Add to .dev.vars
DEBUG_MODE=true

Cela fournira des journaux plus détaillés dans la console des travailleurs.

Obtenir de l'aide

Si vous rencontrez des problèmes:

1. Vérifiez la page des problèmes
2. Passez en revue les journaux des travailleurs de Cloudflare
3. Activer le mode de débogage pour une journalisation plus détaillée

Licence

Ce projet est autorisé en vertu de la licence MIT - voir le fichier de licence pour plus de détails.