You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+20-28Lines changed: 20 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,32 +1,32 @@
1
-
# 🤖 JuanitoAI — Asistente de IA Multicanal y Modular
1
+
# JuanitoAI — Asistente de IA Multicanal y Modular
2
2
3
3
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.
4
4
5
5
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.
6
6
7
-
## 🌟 Características Principales
7
+
## Características Principales
8
8
9
9
Juanito está diseñado para ser **privado**, **local** y altamente personalizable:
10
10
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.
20
20
21
21
---
22
22
23
-
## 🏗️ Arquitectura (Fila Modular)
23
+
## Arquitectura
24
24
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).
26
26
27
27
```text
28
28
juanitoAI/
29
-
├── core/ # 🧠 Lógica central (Agnóstica a plataformas)
29
+
├── core/ # Lógica central (Agnóstica a plataformas)
│ ├── semantic_memory.py # Extracción periódica de hechos de usuarios
41
41
│ └── monitoring.py # Stats del servidor (RAM, CPU, Disco)
42
42
│
43
-
├── channels/ # 🔌 Adaptadores para canales de chat
43
+
├── channels/ # Adaptadores para canales de chat
44
44
│ ├── telegram/ # Cliente nativo de Telegram
45
45
│ │ ├── handlers.py # Controladores de comandos puros
46
46
│ │ └── mapper.py # Serializador de Telegram a core.Message
47
47
│
48
-
└── Telegram_AI_bot.py # 🚀 Entrypoint principal y orquestador
48
+
└── Telegram_AI_bot.py # Entrypoint principal y orquestador
49
49
```
50
50
51
51
---
52
52
53
-
## 🛠️ Instalación y Requisitos
53
+
## Instalación y Requisitos
54
54
55
55
Para correr Juanito, es recomendable usar un entorno virtual para evitar conflictos de dependencias.
56
56
@@ -71,12 +71,6 @@ source venv/bin/activate
71
71
pip install -r requirements.txt
72
72
```
73
73
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
-
=======
80
74
### 3. Configuración (`.env`)
81
75
Antes de iniciar, debes preparar tus API keys. Copia el archivo de ejemplo:
82
76
```bash
@@ -93,7 +87,7 @@ python Telegram_AI_bot.py
93
87
94
88
---
95
89
96
-
## ⚙️ Variables de Entorno (`.env`)
90
+
## Variables de Entorno (`.env`)
97
91
98
92
| Variable | Descripción | Ejemplo |
99
93
|----------|-------------|---------|
@@ -109,7 +103,7 @@ python Telegram_AI_bot.py
109
103
110
104
---
111
105
112
-
## 🤖 Comandos y Capacidades
106
+
## Comandos y Capacidades
113
107
114
108
### Comandos Generales
115
109
-`/start` - Despierta al bot y muestra el mensaje inicial literario.
@@ -131,8 +125,6 @@ python Telegram_AI_bot.py
131
125
-**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.
132
126
-**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.
133
127
134
-
## 📝 Desarrollador
128
+
## Desarrollador
135
129
136
130
Creado y diseñado por **David Carreres Gómez**.
137
-
Arquitectura Final y Refactor Modular completado en 2026.
0 commit comments