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 📋
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.
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.
Gestión de Prompts 🛠️
Crea, edita y elimina prompts personalizados.
Asocia documentos a cada prompt para enriquecer el contexto.
Historial de Conversaciones 🕒
Guarda automáticamente todas las conversaciones.
Busca y filtra conversaciones anteriores por palabras clave.
Cambio de Modelos 🔄
Elige entre modelos locales (GGUF) o en la nube (DeepSeek, OpenRouter).
Configura el proveedor de IA según tus preferencias.
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
Abre una terminal.
Ejecuta el siguiente comando para clonar el repositorio:
https://github.com/Enginer-2023/Genius-Assistant.git
Paso 2: Instalar Dependencias
Crea un entorno virtual (opcional pero recomendado):
python -m venv venv source venv/bin/activate # En Windows: venv\Scripts\activate
Instala las dependencias:
pip install -r requirements.txt
Paso 3: Configuración
Archivo
config.json
:Crea un archivo
config.json
en la raíz del proyecto con el siguiente contenido:{ "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
ytu_api_key_openrouter
con tus claves API.
Modelos Locales (GGUF):
Descarga modelos GGUF desde Hugging Face o TheBloke.
Coloca los archivos
.gguf
en la carpetamodelos
.
Paso 4: Ejecutar la Aplicación
Inicia el servidor Flask:
python app.py
Abre tu navegador y visita:
http://localhost:4867
Obtener Modelos 🧩
Modelos en la Nube ☁️
DeepSeek: Regístrate en DeepSeek para obtener una API key.
OpenRouter: Regístrate en OpenRouter para obtener una API key.
Modelos Locales 🖥️
Descarga modelos GGUF desde:
Coloca los archivos
.gguf
en la carpetamodelos
.
Uso Básico 🎯
Iniciar un Nuevo Chat:
Haz clic en "Nuevo Chat" para comenzar una conversación.
Cargar Documentos:
Usa el botón "Cargar Archivo" para subir documentos.
Cambiar Modelo:
Selecciona un modelo desde el menú desplegable.
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 📋
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.
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.
Prompt Management 🛠️
Create, edit, and delete custom prompts.
Associate documents with each prompt to enrich the context.
Conversation History 🕒
Automatically saves all conversations.
Search and filter previous conversations by keywords.
Model Switching 🔄
Choose between local (GGUF) or cloud-based models (DeepSeek, OpenRouter).
Configure the AI provider according to your preferences.
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
Open a terminal.
Run the following command to clone the repository:
https://github.com/Enginer-2023/Genius-Assistant.git
Step 2: Install Dependencies
Create a virtual environment (optional but recommended):
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
Install dependencies:
pip install -r requirements.txt
Step 3: Configuration
config.json
File:Create a
config.json
file in the project root with the following content:{ "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
andyour_openrouter_api_key
with your API keys.
Local Models (GGUF):
Download GGUF models from Hugging Face or TheBloke.
Place the
.gguf
files in themodelos
folder.
Step 4: Run the Application
Start the Flask server:
python app.py
Open your browser and visit:
http://localhost:4867
Obtaining Models 🧩
Cloud Models ☁️
DeepSeek: Sign up at DeepSeek to get an API key.
OpenRouter: Sign up at OpenRouter to get an API key.
Local Models 🖥️
Download GGUF models from:
Place the
.gguf
files in themodelos
folder.
Basic Usage 🎯
Start a New Chat:
Click "New Chat" to start a conversation.
Upload Documents:
Use the "Upload File" button to upload documents.
Switch Models:
Select a model from the dropdown menu.
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! 🚀