aisyah ai

? Aisyah ai?

Aisyah AI es un poderoso bot de telegrama construido con trabajadores de la nube que combina múltiples capacidades de IA. Puede navegar por la web, establecer recordatorios, hablar, predecir el clima, analizar imágenes y comprender los mensajes de voz. El bot mantiene el contexto en las conversaciones a través de Redis, lo que lo hace perfecto para chats privados e interacciones grupales.

? Capturas de pantalla y demostración

Características

• ? Capacidades avanzadas de IA

  • Comprensión del lenguaje natural con modelos GPT
  • Análisis de imágenes y reconocimiento de objetos
  • Conversión de voz a texto y texto a voz
  • Conversaciones conscientes del contexto en chats privados y grupales

• Herramientas inteligentes

  • Navegación web y recuperación de información
  • Pronósticos meteorológicos en tiempo real
  • Recordatorios y notificaciones de tareas
  • Soporte de chat grupal con retención de contexto

• ☁️ Arquitectura moderna

  • Construido en los trabajadores de la nube para alta escalabilidad
  • Arquitectura de microservicios para modularidad
  • Historia del chat con redis redis
  • Implementación rentable sin servidor

• ? Integraciones de API

  • OpenAI GPT para el procesamiento del lenguaje
  • Búsqueda personalizada de Google para navegación web
  • OpenWeathermap para datos meteorológicos
  • Telegram Bot API para mensajes
  • Supabase para el almacenamiento de archivos
  • Servicios adicionales para capacidades mejoradas

? ¿Por qué solo Openai?

Hemos elegido apoyar exclusivamente modelos Operai (particularmente GPT-3.5-Turbo y GPT-4O-Mini) por varias razones:

1. Consistencia del modelo : los modelos OpenAI proporcionan las respuestas más consistentes y de alta calidad en diferentes idiomas y casos de uso.
2. Rentabilidad : GPT-4O-Mini ofrece un excelente equilibrio entre la calidad de la salida y el precio.
3. Capacidad multilingüe : después de pruebas extensas, los modelos Operai demostraron un rendimiento superior en el manejo de varios idiomas de forma natural.
4. Simplicidad de implementación : si bien los servicios como OpenRouter ofrecen acceso a varios modelos, lo que los respalda introduciría una complejidad adicional en las asignaciones de nombres del modelo y el manejo de respuesta.

Nota: Entendemos el interés en modelos y proveedores alternativos (como OpenRouter, antrópico, etc.). Sin embargo, para mantener la simplicidad del código y garantizar un comportamiento de bot constante, hemos decidido centrarnos en las ofertas de OpenAI. Si necesita usar diferentes modelos, deberá desembolsar el proyecto y modificar las configuraciones del modelo en consecuencia.

Uso

Comandos básicos

• /start : comience la interacción con el bot
• /settings - Configurar configuraciones de bot (modelo LLM, personalidad, voz, etc.)
• /help : obtenga ayuda sobre los comandos disponibles

Nota : Este es un proyecto personal diseñado para fines de aprendizaje y experimentación.

Estructura de proyectos

El proyecto está organizado en varios microservicios:

• aisyah-ai-telegraph : orquestador principal que maneja las interacciones de telegrama
• aisyah-ai-agent : agente de IA central que procesa las solicitudes
• aisyah-ai-explorer : capacidad de navegación web
• aisyah-ai-reminder : gestión de recordatorio
• aisyah-ai-sonata : servicio de texto a voz
• aisyah-ai-storm : predicción meteorológica
• aisyah-ai-vision : análisis de imágenes
• aisyah-ai-whisper : servicio de voz a texto

Comienzo rápido

Requisitos previos

• Node.js (versión LTS recomendada)
• Hilo (v4.3.1 o posterior)
• Cuenta CloudFlare (Free Tier Works)
• TOKEN DE BOT DE TELEGRAM
• Clave de API de OpenAI
• Instancia de Redis para el historial de chat (puede usar el nivel gratuito de arriba)

Instalación

1. Clon el repositorio:

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

2. Instalar dependencias:

   yarn install

3. Configurar Cloudflare: Primero, obtenga su token de la API de CloudFlare:

   1. Vaya a https://dash.cloudflare.com/profile/api-tokens
   2. Localice "Editar trabajadores de CloudFlare", luego "Use la plantilla"
   3. Completar las reglas
   4. Haga clic en "Continuar con resumen" y crear el token
   5. Exportar el token como una variable de entorno:

       export CLOUDFLARE_API_TOKEN=your_api_token_here

   6. Para la configuración persistente, agréguelo a su perfil de shell (~/.zshrc, ~/.bashrc, etc.):

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

   Nota: No use wrangler login , ya que entra en conflicto con el método de autenticación de token API.

4. Configurar archivos de entorno:

    # 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. Configurar configuraciones específicas del paquete:

   Espacios de nombres de KV KV Cloudflare

   Cree los espacios de nombres KV requeridos y tome nota de sus 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

   Configuraciones específicas del paquete

   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-ai-visión (análisis de imágenes)

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

   aisyah-ai-whisper (discurso a texto)

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

   aisyah-ai-sonata (texto a voz)

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

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

   Aisyah-Ai-Explorer (navegador 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-ai-reminder (recordatorios)

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

   Actualizar archivos wrangler.toml

   Actualice wrangler.toml de cada paquete con las ID de espacio de nombres KV correspondientes del paso anterior:

    # 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. Desplegar los trabajadores:

   yarn deploy

7. Configure su bot de telegrama:

   • Crea un nuevo bot con @botfather
   • Establezca la URL de Webhook en su punto final de trabajadores de Cloudflare
   • Configurar la configuración BOT a través de la interfaz de chat de Telegram

Desarrollo

Scripts disponibles

• yarn w : Ejecutar comandos específicos del espacio de trabajo
• yarn deploy : despliegue a todos los trabajadores
• yarn types : generar tipos de mecanografiado
• yarn format : código de formato usando bioma

Agregar nuevas características

1. Cree un nuevo paquete en el directorio packages
2. Implemente su función utilizando los trabajadores de Cloudflare
3. Agregar configuración en wrangler.toml
4. Registre la nueva capacidad en aisyah-ai-agent

? Configuración adicional

Configuración de Redis

1. Configure una instancia de Redis:

   • Cree una base de datos Redis gratuita en Upstash
   • Obtenga su URL de conexión Redis y detalles de autenticación

2. Configurar Redis en su entorno:

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

Llaves API requeridas

Asegúrese de obtener y configurar estas teclas API:

• Clave de API de OpenAI para LLM y capacidades de visión
• Llave de la API de Langchain para el procesamiento de lenguaje mejorado
• Llave de API de OpenWeathermap para pronósticos meteorológicos
• Proyecto Supabase y claves de almacenamiento para el manejo de archivos

Agrégalos a los archivos .dev.vars respectivos en cada paquete.

❗ Solución de problemas

Problemas comunes

1. El despliegue de los trabajadores falla

   • Asegúrese de que el token API de CloudFlare tenga permisos correctos
   • Compruebe si los nombres de los trabajadores en wrangler.toml son únicos
   • Verificar los enlaces del espacio de nombres de KV son correctos

2. Bot no responde

   • Confirmar que la url de webhook se establece correctamente
   • Verifique la validez del token de telegrama de bot
   • Verificar la conexión Redis está funcionando

3. Las características no funcionan

   • Asegúrese de que todas las claves API requeridas sean válidas y se configuren correctamente
   • Verifique los registros de trabajadores correspondientes en el tablero de nubes de nubes
   • Verificar las variables de entorno se establecen correctamente

Modo de depuración

Habilitar el modo de depuración configurando:

 # Add to .dev.vars
DEBUG_MODE=true

Esto proporcionará registros más detallados en la consola de trabajadores.

Obtener ayuda

Si encuentra problemas:

1. Verifique la página de problemas
2. Revisar registros de trabajadores de Cloudflare
3. Habilitar el modo de depuración para un registro más detallado

Licencia

Este proyecto tiene licencia bajo la licencia MIT; consulte el archivo de licencia para obtener más detalles.