Visión General de la Documentación
Documentación oficial estable para chatflow-agent v0.3.4: un framework liviano y asíncrono para agentes múltiples con handoffs nativos en Python.
Línea de Versión Estable (v0.3.4)
Estás visualizando la documentación oficial estable de chatflow-agent v0.3.4, recomendada para despliegues en producción.
Bienvenido a la documentación oficial de chatflow-agent, un framework asíncrono y ligero en Python diseñado para construir agentes conversacionales modulares y enjambres multi-agente con transferencias (handoffs) nativas y fuertemente tipadas.
Creado y liderado por Gustavo Baranda junto con una comunidad internacional de código abierto, chatflow-agent está diseñado para eliminar la sobrecarga de frameworks monolíticos y la dependencia cautiva de proveedores (vendor lock-in), ofreciendo concurrencia de nivel empresarial, memoria resiliente y conectividad multicanal.
Aspectos Destacados de la Arquitectura
Cero Dependencia Cautiva de SDKs
Se conecta a modelos LLM mediante REST HTTP asíncrono puro usando httpx. No requiere SDKs monolíticos de proveedores ni dependencias pesadas en tiempo de ejecución.
Handoffs Multi-Agente Nativos
Declara enjambres colaborativos. Los agentes delegan tareas dinámicamente mediante herramientas sintetizadas transfer_to_* con prevención automática de ciclos.
Memoria Resiliente Transaccional
Cada turno genera una captura atómica de estado. Si ocurre un error o tiempo límite, el estado se revierte automáticamente. Las operaciones de SQLite se ejecutan en pools de subprocesos dedicados.
Preparado para Múltiples Canales
Despliega tus agentes sin complicaciones en terminales REPL, bots de Telegram o en la API de WhatsApp Business Cloud con verificación criptográfica HMAC SHA-256.
Estrategia de Lanzamientos y Versionado
chatflow-agent sigue estrictamente el Versionado Semántico (SemVer). La documentación está organizada por versiones:
- Stable (0.3.4) Versión Estable Actual (Predeterminada): Recomendada para todos los despliegues en producción. Publicada en PyPI el 23 de octubre de 2026.
- Prerelease (0.4.0rc1) Versión Candidata 1 (Pre-lanzamiento): Disponible en PyPI para evaluar mejoras arquitectónicas futuras, incluyendo la ejecución nativa de Gemini vía REST y validación de nombres duplicados en enjambres.
# Instalar la versión estable (predeterminada)
pip install chatflow-agent
# Instalar la versión candidata de pre-lanzamiento
pip install "chatflow-agent==0.4.0rc1"Documentación Orientada a la Versión Estable
Todos los fragmentos de código y firmas de API en esta documentación corresponden por defecto a la versión estable v0.3.4. Las mejoras o cambios disruptivos introducidos en v0.4.0rc1 se destacan explícitamente mediante la insignia Prerelease (0.4.0rc1).
Ruta de Primeros Pasos
Sigue nuestra guía estructurada de incorporación para pasar de la instalación a un agente en producción en cuestión de minutos:
- Instalación: Verifica tu entorno Python (
>=3.10), instala los paquetes centrales y configura extras opcionales para canales. - Inicio Rápido: Construye tu primer agente en menos de 5 minutos, ejecuta herramientas personalizadas con
@tooly explora la ejecución asíncrona. - Conceptos Fundamentales: Conoce la arquitectura central:
Agent,Runner,Engines,Tools,MemoryyHandoffs.