aisyah ai

? Aisyah ai?

Aisyah AI ist ein leistungsstarker Telegramm -Bot mit Cloudflare -Mitarbeitern, das mehrere KI -Funktionen kombiniert. Es kann das Web durchsuchen, Erinnerungen festlegen, sprechen, Wetter vorhersagen, Bilder analysieren und Sprachnachrichten verstehen. Der Bot behält den Kontext in Gesprächen durch Redis bei und macht es sowohl für private Chats als auch für Gruppeninteraktionen perfekt.

? Screenshots & Demo

Merkmale

• ? Fortgeschrittene KI -Funktionen

  • Verständnis für natürliche Sprache mit GPT -Modellen
  • Bildanalyse und Objekterkennung
  • Rede-to-Text- und Text-to-Speech-Konvertierung
  • Kontextbewusste Gespräche sowohl in privaten als auch in Gruppen-Chats

• Smart Tools

  • Webbrowsing und Informationsabruf
  • Echtzeit-Wettervorhersagen
  • Aufgabenerinnerungen und Benachrichtigungen
  • Gruppen -Chat -Unterstützung mit Kontextaufbewahrung

• ☁️ Moderne Architektur

  • Aufgebaut auf Cloudflare -Mitarbeitern für hohe Skalierbarkeit
  • Microservices -Architektur für Modularität
  • Redis-betriebene Chat-Geschichte
  • Kostengünstige serverlose Bereitstellung

• ? API -Integrationen

  • OpenAI GPT für die Sprachverarbeitung
  • Google Benutzerdefinierte Suche nach Webstöbern
  • OpenWeathermap für Wetterdaten
  • Telegramm -Bot -API für Nachrichten
  • Supabase für die Dateispeicherung
  • Zusätzliche Dienste für erweiterte Funktionen

? Warum nur öffnen?

Wir haben aus mehreren Gründen aus mehreren Gründen beschlossen, OpenAI-Modelle (insbesondere GPT-3,5-Turbo und GPT-4O-Mini) zu unterstützen:

1. Modellkonsistenz : OpenAI-Modelle bieten die beständigsten und qualitativ hochwertigsten Antworten in verschiedenen Sprachen und Anwendungsfällen.
2. Kosteneffizienz : GPT-4O-Mini bietet ein hervorragendes Gleichgewicht zwischen Produktionsqualität und Preisgestaltung.
3. Mehrsprachige Fähigkeit : Nach umfangreichen Tests zeigten OpenAI -Modelle eine überlegene Leistung bei der Umstellung mehrerer Sprachen auf natürliche Weise.
4. Implementierung Einfachheit : Während Dienste wie OpenRouter Zugriff auf verschiedene Modelle bieten, würde die Unterstützung von zusätzlichen Komplexität in den Modellnamen -Zuordnungen und der Reaktionsbearbeitung eine zusätzliche Komplexität einführen.

Hinweis: Wir verstehen das Interesse an alternativen Modellen und Anbietern (wie OpenRouter, anthropisch usw.). Um jedoch die Einfachheit der Code zu erhalten und ein konsistentes Bot -Verhalten zu gewährleisten, haben wir uns entschlossen, uns auf OpenAIs Angebote zu konzentrieren. Wenn Sie unterschiedliche Modelle verwenden müssen, müssen Sie das Projekt aufgeben und die Modellkonfigurationen entsprechend ändern.

Verwendung

Grundbefehle

• /start - Beginnen Sie mit dem Bot mit der Interaktion
• /settings - BOT -Einstellungen konfigurieren (LLM -Modell, Persona, Stimme usw.)
• /help - Holen Sie sich Hilfe zu verfügbaren Befehlen

Hinweis : Dies ist ein persönliches Projekt für Lern- und Experimentierzwecke.

Projektstruktur

Das Projekt ist in mehrere Microservices organisiert:

• aisyah-ai-telegraph : Hauptorchestrator, der mit Telegramminteraktionen umgeht
• aisyah-ai-agent : Kern-AI-Agent, der Anfragen verarbeitet
• aisyah-ai-explorer : Web-Browsing-Fähigkeit
• aisyah-ai-reminder : Erinnerungsverwaltung
• aisyah-ai-sonata : Text-to-Speech-Service
• aisyah-ai-storm : Wettervorhersage
• aisyah-ai-vision : Bildanalyse
• aisyah-ai-whisper : Speech-to-Text-Dienst

Schneller Start

Voraussetzungen

• Node.js (LTS -Version empfohlen)
• Garn (v4.3.1 oder höher)
• CloudFlare -Konto (kostenlose Stufe funktioniert)
• Telegramm Bot Token
• OpenAI -API -Schlüssel
• Redis -Instanz für den Chat -Historie (Sie können UPStash -kostenlose Tier verwenden)

Installation

1. Klonen Sie das Repository:

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

2. Abhängigkeiten installieren:

   yarn install

3. Richten Sie CloudFlare ein: Erstens erhalten Sie Ihr Cloudflare -API -Token:

   1. Gehen Sie zu https://dash.cloudflare.com/profile/api-tokens
   2. Suchen Sie "Cloudflare -Mitarbeiter bearbeiten" und dann "Vorlage verwenden".
   3. Füllen Sie die Regeln aus
   4. Klicken Sie auf "Weiter mit Zusammenfassung" und erstellen Sie das Token
   5. Exportieren Sie das Token als Umgebungsvariable:

       export CLOUDFLARE_API_TOKEN=your_api_token_here

   6. Fügen Sie es für eine anhaltende Konfiguration Ihrem Shell -Profil hinzu (~/.ZSHRC, ~/.bashrc usw.):

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

   Hinweis: Verwenden Sie keine wrangler login , da sie mit der API -Token -Authentifizierungsmethode in Konflikt steht.

4. Umgebungsdateien konfigurieren:

    # 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. Paketspezifische Einstellungen konfigurieren:

   Cloudflare KV -Namespaces

   Erstellen Sie die erforderlichen KV -Namespaces und notieren Sie sich ihre IDs:

    # 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

   Paketspezifische Konfigurationen

   Aisyah-ai-telegraph (Hauptbot)

    # 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 (Kern 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-AI-Vision (Bildanalyse)

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

   Aisyah-AI-Whisper (Sprach-zu-Text)

    # 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 (Wetter)

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

   Aisyah-AI-Explorer (Webbrowser)

    # 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-ai-Reminder (Erinnerungen)

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

   Aktualisieren Sie wrangler.toml -Dateien

   Aktualisieren Sie die wrangler.toml jedes Pakets mit den entsprechenden KV -Namespace -IDs aus dem vorherigen Schritt:

    # 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. Die Arbeiter einsetzen:

   yarn deploy

7. Richten Sie Ihren Telegrammbot ein:

   • Erstellen Sie einen neuen Bot mit @BotFather
   • Setzen Sie die Webhook -URL auf Ihren CloudFlare -Worker -Endpunkt
   • Konfigurieren Sie die Bot -Einstellungen über die Telegramm -Chat -Schnittstelle

Entwicklung

Verfügbare Skripte

• yarn w : Arbeitsbereichsspezifische Befehle ausführen
• yarn deploy : Bereitstellung aller Mitarbeiter
• yarn types : Typenkriptypen generieren
• yarn format : Formatcode mit Biome

Neue Funktionen hinzufügen

1. Erstellen Sie ein neues Paket im Verzeichnis packages
2. Implementieren Sie Ihre Funktion mit Cloudflare -Mitarbeitern
3. Fügen Sie die Konfiguration in wrangler.toml hinzu
4. Registrieren Sie die neue Fähigkeit in aisyah-ai-agent

? Zusätzliches Setup

Redis -Konfiguration

1. Richten Sie eine Redis -Instanz ein:

   • Erstellen Sie eine kostenlose Redis -Datenbank bei Upstash
   • Holen Sie sich Ihre Redis -Verbindungs ​​-URL- und Authentifizierungsdetails

2. Konfigurieren Sie Redis in Ihrer Umgebung:

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

Erforderliche API -Schlüssel

Stellen Sie sicher, dass Sie diese API -Schlüssel erhalten und konfigurieren:

• OpenAI -API -Schlüssel für LLM- und Vision -Funktionen
• Langchain -API -Schlüssel für eine verbesserte Sprachverarbeitung
• OpenWeatherMap -API -Schlüssel für Wettervorhersagen
• Supabase -Projekt- und Speichertasten für die Dateibehandlung

Fügen Sie sie in die jeweiligen .dev.vars -Dateien in jedem Paket hinzu.

❗ Fehlerbehebung

Häufige Probleme

1. Der Einsatz der Arbeiter schlägt fehl

   • Stellen Sie sicher
   • Überprüfen Sie, ob Arbeiternamen in wrangler.toml eindeutig sind
   • Überprüfen Sie, ob die KV -Namespace -Bindungen korrekt sind

2. Bot nicht antworten

   • Bestätigen Sie, dass die Webhook -URL korrekt eingestellt ist
   • Überprüfen Sie die Gültigkeit von Telegram Bot Token
   • Überprüfen Sie, ob die Redis -Verbindung funktioniert

3. Funktionen nicht funktionieren

   • Stellen Sie sicher, dass alle erforderlichen API -Schlüssel gültig und ordnungsgemäß konfiguriert sind
   • Überprüfen Sie die entsprechenden Arbeiterprotokolle im Cloudflare -Dashboard
   • Überprüfen Sie die Umgebungsvariablen, die korrekt eingestellt sind

Debug -Modus

Aktivieren Sie den Debug -Modus, indem Sie festlegen:

 # Add to .dev.vars
DEBUG_MODE=true

Dies liefert detailliertere Protokolle in der Arbeiterkonsole.

Hilfe bekommen

Wenn Sie auf Probleme stoßen:

1. Überprüfen Sie die Seite "Ausgaben"
2. Überprüfen Sie CloudFlare -Mitarbeiterprotokolle
3. Aktivieren Sie den Debug -Modus für eine detailliertere Protokollierung

Lizenz

Dieses Projekt ist unter der MIT -Lizenz lizenziert - Einzelheiten finden Sie in der Lizenzdatei.