Guía Completa del Programa: Genius Assistant 🤖 / Complete guide of Genius Assistant program 🤖

 Guía Completa del Programa: Genius Assistant 🤖   (ENGLISH VERSION BELOW)


¿Qué es Genius Assistant? 🧠

Genius Assistant es una aplicación de inteligencia artificial que te permite interactuar con diferentes modelos de lenguaje (LLMs) tanto locales como en la nube. Con esta herramienta, puedes:

  • Chatear con modelos de IA como DeepSeek, Gemini 2.0 Flash o modelos locales.

  • Cargar documentos (PDF, TXT, HTML, Python, Excel, Word, imágenes) para que la IA los analice y responda preguntas basadas en su contenido.

  • Crear y gestionar prompts personalizados para guiar el comportamiento de la IA.

  • Guardar y buscar conversaciones anteriores.

  • Cambiar entre modelos de IA según tus necesidades.

Es una herramienta ideal para estudiantes, desarrolladores, investigadores y cualquier persona que necesite asistencia inteligente. 🚀


Funciones Principales 📋

  1. Chat con IA 💬

    • Puedes chatear con la IA en tiempo real.

    • La IA responde basándose en el contexto de la conversación y los documentos cargados.

    • Soporta modelos locales y en la nube.

  2. Carga de Documentos 📂

    • Sube archivos en formatos como PDF, TXT, HTML, Python, Excel, Word e imágenes.

    • La IA analiza el contenido y lo usa para responder preguntas.

  3. Gestión de Prompts 🛠️

    • Crea, edita y elimina prompts personalizados.

    • Asocia documentos a cada prompt para enriquecer el contexto.

  4. Historial de Conversaciones 🕒

    • Guarda automáticamente todas las conversaciones.

    • Busca y filtra conversaciones anteriores por palabras clave.

  5. Cambio de Modelos 🔄

    • Elige entre modelos locales (GGUF) o en la nube (DeepSeek, OpenRouter).

    • Configura el proveedor de IA según tus preferencias.

  6. Interfaz Amigable 🖥️

    • Diseño intuitivo y fácil de usar.

    • Soporta múltiples idiomas y formatos de texto.


Instalación y Configuración 🛠️

Requisitos Previos
  • Python 3.8 o superior.

  • Pip (gestor de paquetes de Python).

  • Git (opcional, para clonar el repositorio).


Paso 1: Clonar el Repositorio
  1. Abre una terminal.

  2. Ejecuta el siguiente comando para clonar el repositorio:

    bash
    Copy
    https://github.com/Enginer-2023/Genius-Assistant.git

Paso 2: Instalar Dependencias
  1. Crea un entorno virtual (opcional pero recomendado):

    bash
    Copy
    python -m venv venv
    source venv/bin/activate  # En Windows: venv\Scripts\activate
  2. Instala las dependencias:

    bash
    Copy
    pip install -r requirements.txt

Paso 3: Configuración
  1. Archivo config.json:

    • Crea un archivo config.json en la raíz del proyecto con el siguiente contenido:

      json
      Copy
      {
        "DEEPSEEK_API_KEY": "tu_api_key_deepseek",
        "OPENROUTER_API_KEY": "tu_api_key_openrouter",
        "CONTRASEÑA_ACCESO": "tu_contraseña",
        "MODELOS": [
          {
            "name": "DeepSeek Chat",
            "value": "deepseek-chat",
            "provider": "deepseek"
          }
        ]
      }
    • Reemplaza tu_api_key_deepseek y tu_api_key_openrouter con tus claves API.

  2. Modelos Locales (GGUF):

    • Descarga modelos GGUF desde Hugging Face o TheBloke.

    • Coloca los archivos .gguf en la carpeta modelos.


Paso 4: Ejecutar la Aplicación
  1. Inicia el servidor Flask:

    bash
    Copy
    python app.py
  2. Abre tu navegador y visita:

    Copy
    http://localhost:4867

Obtener Modelos 🧩

  1. Modelos en la Nube ☁️

    • DeepSeek: Regístrate en DeepSeek para obtener una API key.

    • OpenRouter: Regístrate en OpenRouter para obtener una API key.

  2. Modelos Locales 🖥️


Uso Básico 🎯

  1. Iniciar un Nuevo Chat:

    • Haz clic en "Nuevo Chat" para comenzar una conversación.

  2. Cargar Documentos:

    • Usa el botón "Cargar Archivo" para subir documentos.

  3. Cambiar Modelo:

    • Selecciona un modelo desde el menú desplegable.

  4. Guardar y Buscar Conversaciones:

    • Todas las conversaciones se guardan automáticamente.

    • Usa la barra de búsqueda para encontrar chats anteriores.


Consejos y Trucos 💡

  • Optimiza Prompts: Usa prompts claros y específicos para obtener mejores respuestas.

  • Combina Modelos: Prueba diferentes modelos para comparar resultados.

  • Usa Documentos: Carga archivos relevantes para enriquecer el contexto.



Si necesitas ayuda, pídesela a nuevo asistente, pulsa aquí.

 

English Version 🌐


What is Genius Assistant? 🧠

Genius Assistant is an AI-powered application that allows you to interact with various language models (LLMs), both locally and in the cloud. With this tool, you can:

  • Chat with AI models like DeepSeek, Gemini 2.0 Flash or local models.

  • Upload documents (PDF, TXT, HTML, Python, Excel, Word, images) for the AI to analyze and answer questions based on their content.

  • Create and manage custom prompts to guide the AI's behavior.

  • Save and search previous conversations.

  • Switch between AI models based on your needs.

It's an ideal tool for students, developers, researchers, and anyone who needs intelligent assistance. 🚀


Key Features 📋

  1. AI Chat 💬

    • Chat with the AI in real-time.

    • The AI responds based on the conversation context and uploaded documents.

    • Supports local and cloud-based models.

  2. Document Upload 📂

    • Upload files in formats like PDF, TXT, HTML, Python, Excel, Word, and images.

    • The AI analyzes the content and uses it to answer questions.

  3. Prompt Management 🛠️

    • Create, edit, and delete custom prompts.

    • Associate documents with each prompt to enrich the context.

  4. Conversation History 🕒

    • Automatically saves all conversations.

    • Search and filter previous conversations by keywords.

  5. Model Switching 🔄

    • Choose between local (GGUF) or cloud-based models (DeepSeek, OpenRouter).

    • Configure the AI provider according to your preferences.

  6. User-Friendly Interface 🖥️

    • Intuitive and easy-to-use design.

    • Supports multiple languages and text formats.


Installation and Configuration 🛠️

Prerequisites
  • Python 3.8 or higher.

  • Pip (Python package manager).

  • Git (optional, for cloning the repository).


Step 1: Clone the Repository
  1. Open a terminal.

  2. Run the following command to clone the repository:

    bash
    Copy
    https://github.com/Enginer-2023/Genius-Assistant.git

Step 2: Install Dependencies
  1. Create a virtual environment (optional but recommended):

    bash
    Copy
    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
  2. Install dependencies:

    bash
    Copy
    pip install -r requirements.txt

Step 3: Configuration
  1. config.json File:

    • Create a config.json file in the project root with the following content:

      json
      Copy
      {
        "DEEPSEEK_API_KEY": "your_deepseek_api_key",
        "OPENROUTER_API_KEY": "your_openrouter_api_key",
        "CONTRASEÑA_ACCESO": "your_password",
        "MODELOS": [
          {
            "name": "DeepSeek Chat",
            "value": "deepseek-chat",
            "provider": "deepseek"
          }
        ]
      }
    • Replace your_deepseek_api_key and your_openrouter_api_key with your API keys.

  2. Local Models (GGUF):


Step 4: Run the Application
  1. Start the Flask server:

    bash
    Copy
    python app.py
  2. Open your browser and visit:

    Copy
    http://localhost:4867

Obtaining Models 🧩

  1. Cloud Models ☁️

    • DeepSeek: Sign up at DeepSeek to get an API key.

    • OpenRouter: Sign up at OpenRouter to get an API key.

  2. Local Models 🖥️


Basic Usage 🎯

  1. Start a New Chat:

    • Click "New Chat" to start a conversation.

  2. Upload Documents:

    • Use the "Upload File" button to upload documents.

  3. Switch Models:

    • Select a model from the dropdown menu.

  4. Save and Search Conversations:

    • All conversations are automatically saved.

    • Use the search bar to find previous chats.


Tips and Tricks 💡

  • Optimize Prompts: Use clear and specific prompts for better responses.

  • Combine Models: Try different models to compare results.

  • Use Documents: Upload relevant files to enrich the context.


¡Esperamos que disfrutes usando Genius Assistant! 🚀
We hope you enjoy using Genius Assistant! 🚀

If you need some help, ask for it to our assistant, clic here.