Skip to content

Commit c452984

Browse files
committed
update v.1.1
nueva version
1 parent ad3510c commit c452984

1 file changed

Lines changed: 20 additions & 28 deletions

File tree

README.md

Lines changed: 20 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,32 @@
1-
# 🤖 JuanitoAI — Asistente de IA Multicanal y Modular
1+
# JuanitoAI — Asistente de IA Multicanal y Modular
22

33
JuanitoAI es un asistente de Inteligencia Artificial ("bot") diseñado inicialmente para Telegram, pero refactorizado con una arquitectura core modular para permitir la futura integración con otros canales.
44

55
El bot combina potentes modelos de lenguaje a través de Ollama, capacidades de visión, reconocimiento de voz usando Whisper, y generación de imágenes mediante modelos libres. Todo gestionado con una base de datos local (SQLite) para mantener el contexto, el humor y la memoria semántica a largo plazo de los usuarios.
66

7-
## 🌟 Características Principales
7+
## Características Principales
88

99
Juanito está diseñado para ser **privado**, **local** y altamente personalizable:
1010

11-
- **💬 Modelos LLM Locales / Cloud (Ollama):** Configura cualquier modelo de texto soportado por Ollama para el razonamiento principal.
12-
- **👁️ Visión Artificial:** Analiza fotos mediante un modelo de visión (como LLaVA) para interpretar imágenes y responder sobre ellas.
13-
- **🎤 Reconocimiento de Voz (Whisper):** Transcripción local de notas de voz. Si el audio es excesivamente largo (+1 minuto), genera un resumen ejecutivo automático.
14-
- **🧠 Memoria y Contexto Persistente:** Utiliza SQLite para el historial de la conversación. Incorpora un sistema de "humor" cambiante y una **memoria semántica** que extrae hechos biográficos del usuario en segundo plano para personalizar futuras respuestas.
15-
- **🎨 Generación de Imágenes Fotorealistas:** Genera imágenes directamente en la conversación apoyándose en la API de HuggingFace Inferencia (FLUX / SDXL).
16-
- **📝 Sistema de Notas y Recordatorios:** Herramientas de productividad para guardar apuntes (`/nota`) y programar avisos temporales asíncronos (`/remind`).
17-
- **🌐 Investigación Web Profunda:** Dos modos operativos: búsqueda rápida (`/search`) e investigación profunda (`/deepsearch`), donde un agente autónomo descarga webs enteras y extrae bibliografía real.
18-
- **📚 Soporte de Documentos:** Lee y contesta sobre archivos de texto planos (`.txt`, `.md`, `.csv`).
19-
- **🛡️ Seguridad y Rate Limiting:** Soporte integrado de "whitelists" de usuarios permitidos, límites de mensajes por minuto para evitar abusos, y roles de administrador.
11+
- **Modelos LLM Locales / Cloud (Ollama):** Configura cualquier modelo de texto soportado por Ollama para el razonamiento principal.
12+
- **Visión Artificial:** Analiza fotos mediante un modelo de visión (como LLaVA) para interpretar imágenes y responder sobre ellas.
13+
- **Reconocimiento de Voz (Whisper):** Transcripción local de notas de voz. Si el audio es excesivamente largo (+1 minuto), genera un resumen ejecutivo automático.
14+
- **Memoria y Contexto Persistente:** Utiliza SQLite para el historial de la conversación. Incorpora un sistema de "humor" cambiante y una **memoria semántica** que extrae hechos biográficos del usuario en segundo plano para personalizar futuras respuestas.
15+
- **Generación de Imágenes Fotorealistas:** Genera imágenes directamente en la conversación apoyándose en la API de HuggingFace Inferencia (FLUX / SDXL).
16+
- **Sistema de Notas y Recordatorios:** Herramientas de productividad para guardar apuntes (`/nota`) y programar avisos temporales asíncronos (`/remind`).
17+
- **Investigación Web Profunda:** Dos modos operativos: búsqueda rápida (`/search`) e investigación profunda (`/deepsearch`), donde un agente autónomo descarga webs enteras y extrae bibliografía real.
18+
- **Soporte de Documentos:** Lee y contesta sobre archivos de texto planos (`.txt`, `.md`, `.csv`).
19+
- **Seguridad y Rate Limiting:** Soporte integrado de "whitelists" de usuarios permitidos, límites de mensajes por minuto para evitar abusos, y roles de administrador.
2020

2121
---
2222

23-
## 🏗️ Arquitectura (Fila Modular)
23+
## Arquitectura
2424

25-
El proyecto separa de forma estricta la lógica agnóstica de los adaptadores específicos de cada red social.
25+
El proyecto separa de forma estricta la lógica de los adaptadores específicos de cada red social (actualmente solo Telegram).
2626

2727
```text
2828
juanitoAI/
29-
├── core/ # 🧠 Lógica central (Agnóstica a plataformas)
29+
├── core/ # Lógica central (Agnóstica a plataformas)
3030
│ ├── config.py # Variables de entorno y logging
3131
│ ├── database.py # Gestión SQLite (historial, notas, perfiles)
3232
│ ├── llm.py # Wrapper para Ollama AsyncClient
@@ -40,17 +40,17 @@ juanitoAI/
4040
│ ├── semantic_memory.py # Extracción periódica de hechos de usuarios
4141
│ └── monitoring.py # Stats del servidor (RAM, CPU, Disco)
4242
43-
├── channels/ # 🔌 Adaptadores para canales de chat
43+
├── channels/ # Adaptadores para canales de chat
4444
│ ├── telegram/ # Cliente nativo de Telegram
4545
│ │ ├── handlers.py # Controladores de comandos puros
4646
│ │ └── mapper.py # Serializador de Telegram a core.Message
4747
48-
└── Telegram_AI_bot.py # 🚀 Entrypoint principal y orquestador
48+
└── Telegram_AI_bot.py # Entrypoint principal y orquestador
4949
```
5050

5151
---
5252

53-
## 🛠️ Instalación y Requisitos
53+
## Instalación y Requisitos
5454

5555
Para correr Juanito, es recomendable usar un entorno virtual para evitar conflictos de dependencias.
5656

@@ -71,12 +71,6 @@ source venv/bin/activate
7171
pip install -r requirements.txt
7272
```
7373

74-
<<<<<<< Updated upstream
75-
* Creado por David Carreres Gómez.
76-
* Fecha: 19/02/2026
77-
* Versión: 1.0 (Prototipo)
78-
* Licencia: GPL-3.0
79-
=======
8074
### 3. Configuración (`.env`)
8175
Antes de iniciar, debes preparar tus API keys. Copia el archivo de ejemplo:
8276
```bash
@@ -93,7 +87,7 @@ python Telegram_AI_bot.py
9387

9488
---
9589

96-
## ⚙️ Variables de Entorno (`.env`)
90+
## Variables de Entorno (`.env`)
9791

9892
| Variable | Descripción | Ejemplo |
9993
|----------|-------------|---------|
@@ -109,7 +103,7 @@ python Telegram_AI_bot.py
109103

110104
---
111105

112-
## 🤖 Comandos y Capacidades
106+
## Comandos y Capacidades
113107

114108
### Comandos Generales
115109
- `/start` - Despierta al bot y muestra el mensaje inicial literario.
@@ -131,8 +125,6 @@ python Telegram_AI_bot.py
131125
- **Extracción Biográfica (Memoria Semántica):** Juanito captura sentencias factuales sobre el interlocutor en _background_ cada cierto número de turnos. Este compendio se inyecta pasivamente en prompts futuros.
132126
- **Resumidor Transcriptor:** Audios que superen el límite sintáctico de tokens tras pasar por el pipe de Whisper son cortocircuitados hacia un sub-agente dedicado que esquematiza la información del audio, previniendo el desbordamiento conversacional.
133127

134-
## 📝 Desarrollador
128+
## Desarrollador
135129

136130
Creado y diseñado por **David Carreres Gómez**.
137-
Arquitectura Final y Refactor Modular completado en 2026.
138-
>>>>>>> Stashed changes

0 commit comments

Comments
 (0)