█████╗ ██████╗ ██╗███████╗ █████╗ ██╔══██╗██╔══██╗██║██╔════╝██╔══██╗ ███████║██████╔╝██║███████╗███████║ ██╔══██║██╔══██╗██║╚════██║██╔══██║ ██║ ██║██║ ██║██║███████║██║ ██║ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚══════╝╚═╝ ╚═╝
Arisa: asistente de IA de código abierto para Telegram
Ejecutalo en tu propio equipo. Usa Pi Agent.
1.1qué es
Arisa conserva dos piezas y nada más: Telegram como interfaz humana y Pi Agent como motor de razonamiento.
No trae opiniones predefinidas sobre qué debería hacer ni qué herramientas debería tener. Empieza mínima y crece con el uso real.
- Telegram es la interfaz humana
- Pi Agent es el motor de razonamiento
- todo pasa por artefactos
- las capacidades viven en herramientas CLI aisladas
- las herramientas se encadenan en flujos
1.2carga
2instalar
Instalala globalmente y ejecutá arisa. El primer inicio te guía para configurar Telegram, elegir el proveedor y modelo de Pi, autenticarte y validar la instalación.
Una suscripción a ChatGPT alcanza: Arisa puede usar el flujo OAuth de Codex en Pi, así que no necesitás una API key estándar de OpenAI con los proveedores compatibles.
3arquitectura
Arisa separa la normalización antes de razonar de la acción razonada. Una voz puede convertirse en texto antes del razonamiento; TTS, descargas y otros pipes ocurren después de que el agente decide.
4cero herramientas
Una instalación nueva no trae herramientas. El núcleo contiene el transporte de Telegram, el ciclo de razonamiento de Pi Agent, el almacén de artefactos y el registro de herramientas.
- llega un pedido que las herramientas actuales no resuelven
- Arisa busca una coincidencia en el catálogo oficial
- las herramientas livianas se instalan; las más pesadas piden confirmación
- si ninguna herramienta del catálogo sirve, Arisa construye la capacidad que falta
- las herramientas instaladas viven en ~/.arisa/tools/ y se reutilizan
entender
Busca, lee y conserva contexto útil.
media
Descarga, analiza, transcribe y convierte texto en voz.
crear y publicar
Convierte texto e ideas en archivos o sitios publicados.
comunicar
Trabaja con email, WhatsApp y X bajo reglas de seguridad explícitas.
operar
Programa tareas, conecta máquinas y ejecuta infraestructura en tiempo real.
extender y mantener
Conecta herramientas externas, revisa operaciones y mantiene instalaciones reproducibles.
5casos
Arisa no es una lista de funciones. Se adapta al trabajo: conecta herramientas, conserva el contexto y deja que cada chat defina cuánto control quiere mantener.
WebRTC sin servidor de juegosignaling-server coordina pares y turn-server ofrece repetidores TURN cuando una conexión directa no alcanza. Sirve para salas, llamadas, canales de datos y juegos multijugador.
idea → diseño → HTTPSPedile una página de presentación o una herramienta interna: site-builder arma la página y roster-sites la publica con dominio y HTTPS.
perfil seguro → acción especializadamcp-client conecta perfiles MCP aislados por chat con OAuth protegido y validación de endpoints. magnific-mcp convierte ese transporte en flujos directos de generación, recolección, descarga y upscale de imágenes.
master → slave emparejado → operación acotadamaster-slave empareja una Arisa principal con Slaves Linux headless. Cada Slave se reconecta hacia afuera y expone solo los roots y las capacidades de inspección, lectura o ejecución permitidas por su política guardada.
observar → explicar → proponerprocess-retrospective revisa operaciones recientes con un foco rotativo, propone un conjunto acotado de mejoras y nunca aplica cambios sin aprobación.
grupo, consulta o respuestawhatsapp-web mantiene una sesión por chat. Puede contestar en un grupo, consultar la web para comparar precios o pasar un audio recibido por openai-transcribe antes de que Arisa responda.
investigación → borrador → Gmaillightpanda-browser encuentra una referencia real. pr-campaign registra el contacto, crea el outreach personalizado y llama a gmail-workspace para guardarlo como borrador de Gmail. En modo revisión espera aprobación; en modo automático envía solo dentro de las reglas de la campaña. stop-slop-writer revisa el tono.
descubrir → aprobar → verificarx-session-reader lee contenido público de la sesión, x-campaign-runner elige un prospecto con evidencia y x-dm sigue o envía solo después de una aprobación explícita y controles de cuenta.
contexto → tarea programadacontext-vault guarda datos y preferencias dentro del chat. schedule-agent-task despierta al agente más tarde con la instrucción adecuada.
página web → texto → vozurl-to-markdown extrae el texto legible de una página y openai-tts devuelve un mensaje de voz OGG.
investigación → Markdown → PDFweb-browser reúne fuentes, markdown-pdf genera el informe y file-document puede devolver un archivo local existente por Telegram.
auditoría autorizadaweb-pentest-auditor revisa headers, CORS, rutas públicas, bundles y almacenamiento de tokens sin atacar ni modificar el sitio. Es una revisión técnica que un chat común no ejecuta por sí solo.
descargar → analizar → transcribirvideo-downloader descarga la fuente, video-analyze muestrea evidencia visual y audio-extractor prepara el audio para openai-transcribe o la opción local whispermix-transcribe.
una herramienta prepara la siguienteLas herramientas no funcionan aisladas: URL → video → audio → transcripción; investigación → referencia → borrador; mensaje → respuesta por WhatsApp. Arisa arma el flujo necesario y lo reutiliza.
6idea
Arisa empieza pequeña y cambia con el trabajo que le das.
Telegram lleva la conversación. Pi Agent se ocupa del razonamiento. Arisa agrega cada capacidad nueva como una tool aislada cuando alguien la necesita.
En Stories, Arisa cuenta cómo esas decisiones transforman el trabajo real.
Leer Stories →- 01 · user-shaped
- La persona que usa Arisa decide a qué puede acceder, qué puede recordar, automatizar y publicar.
- 02 · tool-shaped
- Arisa pone cada capacidad nueva en una tool aislada. El core se ocupa del transporte, el razonamiento, los artifacts y la orquestación.
- 03 · inspectable
- Arisa registra artifacts, estado o recibos de su trabajo y pide aprobación antes de hacer cambios sensibles.
- 04 · self-improving
- Arisa puede leer y modificar su propio código. La persona que la usa decide qué cambios quedan.