Introducción. evi-run es un sistema de inteligencia artificial multiagente listo para producción basado en OpenAI Agents SDK y accesible mediante un bot de Telegram. Permite operar en modo privado para uso personal o escalar a escenarios comerciales. En Q2BSTUDIO somos especialistas en desarrollo de software y aplicaciones a medida, ia para empresas, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio con power bi y automatización de procesos. Si buscas potenciar tus productos con agentes IA, descubre cómo impulsamos proyectos con inteligencia artificial para empresas.
Características técnicas clave. Arquitectura multiagente con agente principal, subagentes especializados y herramientas; backend en Python con OpenAI Agents SDK y FastAPI; base de datos PostgreSQL y caché en Redis; interfaz mediante Telegram Bot API; orquestación con Docker Compose; integraciones con MCP servers y Solana RPC.
Requisitos mínimos en DigitalOcean u otros VPS equivalentes. CPU 1 vCPU; RAM 1 GB; almacenamiento 25 GB SSD; sistema operativo Ubuntu 22.04 LTS; transferencia 1 TB. Para cargas más altas incrementa vCPU, RAM y disco.
Claves y parámetros necesarios. Telegram Bot Token desde BotFather; OpenAI API Key desde la plataforma de OpenAI; Telegram User ID desde userinfobot en Telegram. Verifica cuidadosamente el nombre del bot antes de copiar el token.
Paso 1. Crear y configurar el servidor. 1 Accede al panel de DigitalOcean y crea un Droplet. 2 Selecciona Ubuntu 22.04 LTS x64. 3 Elige tamaño básico 1 GB RAM 1 vCPU 25 GB SSD o superior según carga. 4 Configura autenticación mediante contraseña robusta de root o clave SSH. 5 Opcional activa monitorización y copias de seguridad. 6 Define el hostname evi-run-server y crea el Droplet.
Conexión al servidor. Opción consola web de DigitalOcean ideal para principiantes abriendo la consola y entrando como root con la contraseña definida. Opción SSH desde tu terminal con el comando ssh root arroba la IP del servidor. Al pegar la contraseña no se mostrará por seguridad, simplemente presiona Enter.
Configuración inicial del sistema. Ejecuta en el servidor las siguientes órdenes en este orden. apt update && apt upgrade -y. apt install -y curl wget git nano. Espera a que cada comando finalice antes de continuar.
Paso 2. Instalar Docker y Docker Compose. 1 Ve al directorio de trabajo con cd espacio barra opt. 2 Clona el repositorio con sudo espacio git espacio clone espacio https://github.com/pipedude/evi-run.git. 3 Asigna permisos con sudo espacio chown espacio guion R espacio signo de dólar USER dos puntos signo de dólar USER espacio evi-run. 4 Entra con cd espacio evi-run. 5 Da permisos de ejecución con chmod espacio mas x espacio docker_setup_en.sh. 6 Instala Docker ejecutando sudo espacio punto barra docker_setup_en.sh.
Paso 3. Configurar evi-run. Variables de entorno. Copia el archivo de ejemplo con cp espacio punto env punto example espacio punto env. Edita con nano espacio punto env e introduce tus valores sin comillas. TELEGRAM_BOT_TOKEN igual tu token de bot de Telegram. API_KEY_OPENAI igual tu clave de OpenAI. Para guardar en nano presiona Ctrl mas X luego Y y finalmente Enter.
Configuración principal. Abre nano espacio config punto py y ajusta lo siguiente. ADMIN_ID pon tu ID de Telegram como número entero. ADMINS_LIST opcional agrega una lista de IDs separados por coma. TYPE_USAGE define el modo de uso private para pruebas o free o pay según tu modelo de negocio. Guarda con Ctrl mas X Y y Enter.
Configuración de agentes IA opcional. Puedes añadir agentes IA personalizados, flujos de herramientas y roles especializados para tareas complejas como análisis de datos, redacción, oops y operaciones blockchain. Q2BSTUDIO puede ayudarte a diseñar estos agentes y a integrarlos con tus sistemas existentes de software a medida y aplicaciones a medida.
Paso 4. Construcción y arranque. Desde el directorio del proyecto ejecuta docker compose up espacio guion guion build espacio guion d. Esto construirá las imágenes y levantará todos los servicios en segundo plano. Para comprobar el estado utiliza docker compose ps.
Paso 5. Pruebas con el bot de Telegram. Busca tu bot por su nombre en Telegram tal como lo definiste en BotFather. Envía el comando barra start. Prueba con un mensaje simple como Hola que tal para validar que el sistema y los agentes IA responden correctamente.
Comandos útiles. Reiniciar el sistema tras cambios de código. cd espacio barra opt barra evi guion run luego docker compose down y después docker compose up espacio guion guion build espacio guion d. Apagar servicios. cd espacio barra opt barra evi guion run y docker compose down. Ver logs. docker compose logs espacio guion f para todos los servicios o docker compose logs espacio guion f espacio bot para el bot. Última hora de logs. docker compose logs espacio guion guion since espacio 1h espacio bot.
Buenas prácticas de seguridad y fiabilidad. Mantén el sistema actualizado con parches de seguridad. Utiliza SSH con clave y firewall básico. Conserva tus variables sensibles en el archivo punto env y rota claves periódicamente. Asegura PostgreSQL y Redis con contraseñas robustas. Programa copias de seguridad y monitorización. La ciberseguridad y el pentesting son fundamentales en entornos de producción y en Q2BSTUDIO contamos con expertos que pueden ayudarte a evaluar riesgos y endurecer la plataforma.
Despliegue híbrido y nube. Si necesitas alta disponibilidad integración con CI CD y escalado automático puedes migrar o extender el despliegue a AWS o Azure. Nuestro equipo ofrece arquitectura y operación gestionada de contenedores, redes y datos a través de servicios cloud aws y azure, alineando costes, seguridad y rendimiento con tus objetivos de negocio.
Conclusión. Con estos pasos tendrás evi-run operando en tu VPS como un sistema multiagente de alto rendimiento listo para uso privado o comercial. A partir de aquí puedes personalizar agentes IA, flujos de herramientas y políticas de uso, además de integrar analítica con power bi, gobernanza de datos y más. En Q2BSTUDIO te acompañamos de extremo a extremo con software a medida, aplicaciones a medida, inteligencia artificial, ciberseguridad, servicios inteligencia de negocio y automatización de procesos para que tu producto crezca con garantías.