Los asistentes listos guardan tu vida en el servidor de alguien, y los agentes que usan la computadora pueden leer tus contraseñas y borrar archivos. INTELECTO v2 es gratis, funciona en tu máquina, piensa con una IA local gratuita, recuerda lo que le contaste y solo hace lo peligroso después de que lo apruebes.
Quieres un asistente de IA solo para ti, que recuerde tus cosas, pero no quieres entregar tus datos ni dejar una IA suelta en la computadora. INTELECTO v2 es un asistente personal gratis que instalas en tu computadora y con el que conversas por la terminal o por Telegram. Piensa con una IA que funciona en tu máquina (Ollama, sin costo) o en la nube, guarda recuerdos, solo accede a una carpeta de trabajo y pide tu aprobación antes de ejecutar cualquier comando que no sea solo de lectura. Necesitas Python 3.10 o más reciente; no hace falta nada más.
Puedes tener las dos cosas: un asistente que de verdad ayuda y que no te pone en riesgo.
Con los asistentes listos, todo lo que cuentas queda guardado en la empresa. En INTELECTO, la memoria es un archivo en tu computadora y, con la IA local, nada sale de la máquina.
Un agente que ejecuta comandos por su cuenta puede acceder a tus contraseñas, internet y archivos. Basta un error o un texto malicioso oculto en un sitio web.
Los frameworks de agentes tienen miles de archivos. INTELECTO tiene 1.500 líneas, separadas en 8 piezas, que puedes leer en una tarde.
Cada pieza está en su propia carpeta. Puedes entenderlo todo sin programar.
Por donde hablas: la terminal o Telegram. En Telegram solo te responde a ti.
Piensa, usa una herramienta, revisa el resultado y responde. Da un máximo de 5 vueltas para que no siga funcionando sin fin.
Cuatro archivos de texto: quién es, cómo trabaja, quién eres y qué sabe. Los cambias escribiendo.
La IA que piensa: una en tu computadora (Ollama, gratis) o una en la nube (OpenRouter, servicio de pago que necesita cuenta).
Guarda lo que le cuentas y lo vuelve a encontrar por las palabras, incluso sin tildes. Sigue ahí mañana.
Guardar y buscar recuerdos, leer, escribir y listar archivos (solo en su carpeta) y ejecutar comandos.
Decide si un comando puede ejecutarse y guarda contraseñas cifradas. Todo lo que hace queda registrado.
Si la activas, cada comando se ejecuta en una caja desechable, sin internet ni tus contraseñas.
Atención: ya existen en el código y pasan las pruebas, pero todavía no están conectadas a la conversación ni a Telegram. Por ahora, solo puedes verlas en funcionamiento en la demostración de abajo. Conectar cada una requiere trabajo de programación, para quien programe o para Claude Code/Codex.
Una página de internet puede contener un texto escrito para darle órdenes a la IA. La regla: el agente (la parte que trabaja por su cuenta) que pueda leer la web no puede ver lo que el asistente sabe sobre ti. La regla ya está lista; la lectura de la web todavía no existe en INTELECTO.
Para futuras investigaciones en internet: cada afirmación conserva la frase exacta de la página, y el código verifica que la frase esté ahí. Si es inventada, queda afuera; un número de fuente que no existe se convierte en [?].
Un trabajo de 10 minutos que no bloquea la conversación. Cada paso se guarda: si se apaga la computadora, continúa desde donde quedó. Cuando se acaba el tiempo, entrega lo que tiene.
Si la hora pasó con la computadora apagada, todavía se ejecuta hasta: un recordatorio, 2 horas; algo que el asistente hace por su cuenta (como un «buen día»), 45 minutos; una tarea larga, 6 horas. Después de eso, se omite y se registra. El horario de silencio solo detiene lo que no pediste.
El cerebro es la IA que responde. Si hay varios en fila y uno falla, responde el siguiente, mientras el que falló descansa: 5 minutos si se agotó la cuota (el límite de uso), 30 si está fuera de servicio, 6 horas si el modelo no existe en tu cuenta.
¿Guardó, movió o borró un archivo por error? «Deshacer» lo revierte. Al borrar, el archivo va a la papelera. Sobrescribir un archivo de más de 1 MB no se puede deshacer, y el sistema avisa. Si no sabe cómo era antes, no finge saberlo.
Prueba las seis en tu computadora, sin internet ni IA instalada, en la carpeta donde descargaste el proyecto (la misma del git clone):
git pull && python3 -m intelecto avancado
Para quienes programan: la guía técnica para conectar cada una está en docs/RECURSOS-AVANCADOS.md (en portugués). Son 35 pruebas más (105 en total).
Antes de ejecutar cualquier comando, el bloqueo revisa lo que hace. La opción predeterminada es preguntar: solo deja pasar directamente lo que se limita a leer.
Comandos que solo consultan: listar archivos, leer un texto, ver la fecha o revisar el espacio en disco.
Cualquier otro: escribir, mover o borrar un archivo, instalar algo o acceder a internet. Te pregunta en la terminal o te manda "/sim o /nao" por Telegram.
Lo que destruye: borrar el disco o tu carpeta personal, formatear, apagar la máquina, descargar y ejecutar un script. Ni siquiera con tu aprobación.
La v1 solo tenía una lista de palabras prohibidas: "rm -rf /" se bloqueaba, pero "rm -r -f /" pasaba. La v2 entiende ambas formas y otras 19 variantes probadas, y cualquier comando que no esté en la lista de lectura necesita tu aprobación. La lista no es la única protección: activa la caja para ejecutar un comando que no conoces.
Ejemplo real: le mandas "lembre que meu nome é Ana" (recuerda que mi nombre es Ana) y, al día siguiente, "qual meu nome?" (¿cómo me llamo?). Esto es lo que sucede dentro de INTELECTO.
El mensaje entra por la terminal o por Telegram. En Telegram, comprueba que quien lo envió eres tú (lista de propietarios); los mensajes de otras personas se ignoran y se registran.
Las frases que empiezan con "lembre que" (recuerda que), "guarde" (guarda) o "anote" (anota) se guardan de inmediato, sin depender de que la IA lo decida. Por eso, hasta un modelo pequeño las recuerda. Una pregunta (con "?") nunca se convierte en memoria.
Reúne los archivos de identidad (quién es, cómo trabaja, quién eres tú), los recuerdos relacionados con la pregunta ("nome" (nombre) encuentra "meu nome é Ana" (mi nombre es Ana)) y las conversaciones más recientes.
Todo esto va a la IA (en tu computadora o en la nube). Responde o solicita una herramienta: guardar, buscar, leer un archivo, ejecutar un comando.
Si es un comando, el control decide: lo ejecuta, te pregunta o lo rechaza. Una vez aprobado, se ejecuta en la carpeta de trabajo o en la caja sin internet, si la activaste. El resultado vuelve a la IA, hasta un máximo de 5 vueltas.
Recibes la respuesta, y todo lo que hizo (comando, herramienta, memoria, error) queda registrado en una línea de auditoría para que puedas revisarlo después.
INTELECTO v2 es la base que ya funciona. Para ir más allá (WhatsApp, calendario, casa inteligente, voz…), abre el almacén: son 144 ingredientes de 12 proyectos de agentes, en 8 pasillos. Eliges, y se genera el archivo meu-assistente.md; Claude Code o Codex construye sobre INTELECTO siguiendo ese archivo.
Haz clic en los ingredientes de los pasillos o carga uno de los 5 ejemplos listos que aparecen abajo.
Cada elemento viene marcado: ✅ ya existe en INTELECTO, 🟡 existe en parte, ➕ falta (y en qué pieza encaja). Al final están las reglas para el agente: un elemento a la vez, con una prueba.
Copia el archivo en la carpeta de INTELECTO, abre Claude Code o Codex allí y pídele que lo implemente. Para más seguridad: dentro de la caixa-do-agente.
Los ingredientes marcados con ➕ todavía no existen en INTELECTO: el agente los construye siguiendo el archivo. Antes de usar lo que haga, compruébalo con las pruebas.
Probado el 12/11/2026 en una computadora Linux. Lo que no se probó en vivo está indicado.
| Parte | Cómo se probó |
|---|---|
| Ciclo, memoria, herramientas, bloqueo, aprobación, bóveda y auditoría | 105 pruebas automáticas; todas pasan |
| IA local (Ollama) | En vivo con el modelo qwen3.6: guardó "mi nombre es Nei y vivo en Porto Alegre" y, en una conversación nueva, respondió "Tu nombre es Nei y vives en Porto Alegre". Con llama3.2 (modelo pequeño) casi no usa las herramientas por sí solo, pero desde la versión 2.0.1 todo lo que empieza con "lembre que" (recuerda que) se guarda directamente, y también recordó el nombre y la ciudad. |
| Caja (comando en un contenedor) | En vivo: solo ve la carpeta de trabajo, no ve las variables de tu terminal y no tiene internet |
| OpenRouter y Telegram | Contra servidores de prueba en la misma computadora (formato, clave, filtro de propietario, aprobación por /sim). No se probaron en vivo: dependen de tu clave y de tu bot. |
| macOS | No se probó. El servicio de macOS y la clave de la bóveda basada en el número de la máquina están en el código. |
A partir de aquí viene la parte técnica: instalar, configurar y ejecutar. No necesitas esta parte para entender lo anterior.
Solo usa la biblioteca estándar de Python. El paquete cryptography es opcional (bóveda con Fernet).
Una línea de comandos con 8 subcomandos: conversar, demo, telegram, configurar, cofre, memoria, auditoría y verificar.
Todo el asistente está en una carpeta: config, memoria, identidad, carpeta de trabajo, auditoría y bóveda. Cámbiala con INTELECTO_HOME.
python3 -m pytest -q. Ninguna prueba llama a una API real.
Python ya viene en Linux y en macOS reciente. git (el programa que descarga el proyecto) puede faltar en una máquina nueva.
python3 --version && git --version sudo apt install -y git # Ubuntu, si falta git xcode-select --install # macOS, si falta git
Gratis, en ollama.com. El modelo probado requiere una buena tarjeta gráfica; llama3.2 funciona en una máquina sencilla: casi no usa las herramientas, pero recuerda lo que pides con "lembre que…" (recuerda que…).
ollama pull qwen3.6:35b-a3b ollama pull llama3.2 # más ligero
Opcional. Solo si quieres ejecutar los comandos en una caja sin internet.
docker run --rm hello-worldLa demostración usa un cerebro ficticio: funciona sin internet y sin modelo.
cd ~ && git clone https://github.com/inematds/intelecto-v2 && cd intelecto-v2 python3 -m intelecto demo
Te pregunta el nombre, la personalidad, el cerebro, el modelo, dónde ejecutar comandos (local o caja) y la aprobación. Presiona Enter para mantener el valor sugerido.
llama3.2).perigosos (predeterminado) aplica lo que se explica en "Cómo decide"; sempre pregunta incluso antes de listar archivos; nunca no pregunta nada y solo permite ejecutar lo que se limita a leer.python3 -m intelecto configurar
Edita los 4 archivos de identidad. La primera vez, cada línea que comienza con "- " en MEMORY.md se convierte en un recuerdo.
nano ~/.intelecto2/identidade/USER.md # quién eres nano ~/.intelecto2/identidade/AGENTS.md # reglas de trabajo (memoria, herramientas) nano ~/.intelecto2/identidade/SOUL.md # forma de ser nano ~/.intelecto2/identidade/MEMORY.md # datos iniciales
python3 -m intelecto verificar # → todo está bien python3 -m intelecto # conversa en la terminal; escribe 'sair' para terminar
Si el modelo aparece con [FALTA], descárgalo con ollama pull <modelo> o ejecuta configurar y elige uno que ya tengas.
En Telegram, abre @BotFather, envía /newbot, elige un nombre y copia el token que te responde (el código secreto de tu bot, tipo 123456:ABC…). Guarda ese token en la bóveda. Activa el bot, mándale /id y pon el número que te responda en configurar (cuando te pregunte los ID de Telegram; en las demás preguntas, solo presiona Enter). Si no configuras un propietario, solo responde a /id.
python3 -m intelecto cofre guardar telegram # pega el token; no aparece en pantalla python3 -m intelecto telegram # manda /id al bot y luego presiona Ctrl+C python3 -m intelecto configurar # agrega tu ID python3 -m intelecto telegram
# Linux (systemd del usuario; ajusta la carpeta en el archivo si no lo clonaste en ~/intelecto-v2) mkdir -p ~/.config/systemd/user cp servico/intelecto-telegram.service ~/.config/systemd/user/ systemctl --user daemon-reload && systemctl --user enable --now intelecto-telegram # macOS: reemplaza SEU_USUARIO en servico/club.inema.intelecto.plist y copia el archivo a ~/Library/LaunchAgents/
Con Docker, cada comando aprobado se ejecuta en un contenedor sin red, con acceso solo a la carpeta de trabajo.
docker pull python:3.12-slim python3 -m intelecto conversar --executor caixa # o elige el ejecutor caja en configurar
La clave va en la bóveda, nunca en config. Cada mensaje cuesta según el modelo que elijas.
python3 -m intelecto cofre guardar openrouter python3 -m intelecto conversar --provedor openrouter --modelo anthropic/claude-sonnet-5.5
python3 -m intelecto memoria # últimos recuerdos python3 -m intelecto memoria cachorro # búsqueda python3 -m intelecto auditoria -n 20 # comandos y herramientas, con lo que se ejecutó y lo que no
python3 -m intelecto demo
você> rode: ls
intelecto> Feito. Resultado de rodar_comando: [local, saída 0]
você> rode: echo teste > nota.txt
intelecto> Feito. Resultado de rodar_comando: não rodei: o dono não aprovou
você> rode: rm -rf /
intelecto> Feito. Resultado de rodar_comando: não rodei: bloqueado: apagar pasta do sistema ou a pasta pessoal
você> leia ../../etc/passwd
intelecto> Feito. Resultado de ler_arquivo: fora da pasta de trabalho
El programa responde en portugués. En la demostración nadie aprueba, por eso el comando "echo" no se ejecuta. En una conversación real, te pregunta.
| v1 | v2 | |
|---|---|---|
| Código | el README describía el asistente, pero solo había un ejemplo mínimo con un cerebro ficticio | asistente completo, 1.500 líneas, 105 pruebas (v2.1) |
| Comandos | lista de palabras prohibidas | ejecuta / pregunta / rechaza, y la opción predeterminada es preguntar |
| Telegram | solo la estructura | funciona y solo responde a sus propietarios |
| Aislamiento | prometido en el curso | caja por comando (Docker sin red) |
| Plataforma | solo macOS | probado en Linux; macOS está en el código |
La v1 y el curso de la v1 siguen disponibles. Su método sigue vigente: elegir los ingredientes en la tienda de frameworks y darle el resumen a Claude Code o Codex para armar un asistente a tu manera.
INTELECTO protege lo que hace el asistente. La caixa-do-agente protege el proyecto mientras tú, Claude Code o Codex trabajan en él.
Cuando dejas que un agente de IA use la computadora por su cuenta, puede acceder a tus contraseñas (.env, claves), internet y tus archivos reales. A caixa-do-agente hace el trabajo en una habitación cerrada, en 3 pasos:
Hace una copia del proyecto en una carpeta temporal y deja fuera las contraseñas y las claves.
El comando se ejecuta en la copia, en un contenedor (una caja aislada dentro de tu computadora) sin internet, con límites de memoria, procesador y tiempo.
Muestra lo que cambió en un archivo .patch (la lista de cambios) y borra el contenedor y la copia. El original solo cambia si aplicas esos cambios.
Es como dejar que el albañil trabaje en una maqueta de tu casa, sin la llave de la caja fuerte: al final revisas lo que hizo y decides si lo replicas en la casa real. La segunda herramienta del kit, el auditor, solo lee y da una calificación del 0 al 10 sobre la protección de quienes programan en el proyecto.
El archivo de contraseñas (.env) quedó fuera de la copia, pasaron 67 pruebas y se omitió 1 (la que necesita Docker, que no está disponible ahí) y no cambió ningún archivo. Como la caja no tiene internet, el programa de pruebas (pytest) usa una imagen preparada de antemano (caixa/Dockerfile).
El auditor revisa el proyecto y las herramientas de programación que usas en él (Claude Code, Codex). La calificación subió con dos cambios: sacamos el archivo de contraseñas (.env) del proyecto y agregamos un archivo de reglas para los agentes (CLAUDE.md).
Faltó la capa de la "caja": en la computadora donde probamos, Claude Code y Codex están configurados para ejecutarse sin aislamiento. Esta configuración depende de cada computadora, así que ejecuta el auditor en la tuya para ver tu calificación. Para completar esta capa, ejecuta tu agente desde caixa.sh.
# 1. imagen con pytest (la caja no tiene internet para instalar nada) docker build -t intelecto-v2-testes caixa/ # 2. las pruebas en una copia sin .env ni red, que se borra al final ~/caixa-do-agente/caixa.sh ~/intelecto-v2 --imagem intelecto-v2-testes -- python3 -m pytest -q -p no:cacheprovider # 3. la calificación (solo lee, no cambia nada) python3 ~/caixa-do-agente/auditar.py ~/intelecto-v2
Para tener la caja: git clone https://github.com/inematds/caixa-do-agente ~/caixa-do-agente (necesitas Docker y Python 3).