Despliegues de estrategias de trading nativos de GitHub
Conecta GitHub, elige tu propio repositorio o crea uno a partir de una plantilla de TradingHost y despliega estrategias de trading en entornos de ejecución en la nube siempre activos.
TradingHost utiliza GitHub como la fuente de verdad para tu código de trading. Regístrate con GitHub, conecta un repositorio existente o crea uno nuevo a partir de una plantilla de código abierto o de TradingHost, y luego inicia un despliegue que ejecute la estrategia seleccionada en un entorno de ejecución de TradingHost.
Ciclo de vida nativo de GitHub
- Registro con GitHub
- Soporte para repositorios existentes
- Creación de repositorios en un clic
- Despliegues a nivel de estrategia
- Controles de inicio y parada
- Redespliegues automáticos desde main
- Sin bloqueo de estado
Sección 01 · Concepto
¿Qué es un despliegue de TradingHost?
Un despliegue es una instancia en ejecución de una estrategia de trading en TradingHost.
Tu repositorio de GitHub contiene el código. TradingHost lee ese código, prepara el entorno de ejecución, inyecta los secretos configurados e inicia la estrategia seleccionada dentro de un entorno contenedorizado.
Un solo repositorio puede contener una o varias estrategias. Al crear un despliegue, tú eliges qué estrategia debe ejecutar TradingHost, dónde debe ejecutarse y qué configuración de entorno de ejecución debe utilizar.
- Repo
- equivale al código fuente.
- Estrategia
- equivale a la lógica de trading que decides ejecutar.
- Despliegue
- equivale a la instancia activa en el entorno de ejecución que ejecuta esa estrategia.
Sección 02 · Integración
Regístrate y despliega con GitHub
TradingHost parte de GitHub porque el código de trading serio necesita control de versiones, cambios revisables y una fuente de verdad limpia.
Al registrarte en TradingHost, te autenticas con GitHub. Desde allí, puedes conectar tu propio repositorio o crear uno nuevo a partir de una plantilla compatible.
- PASO 01
Regístrate con GitHub
Usa tu cuenta de GitHub para crear una cuenta en TradingHost y autorizar los permisos de repositorio requeridos.
- PASO 02
Elige la ruta de tu repositorio
Conecta un repositorio existente, crea uno a partir de una plantilla de framework de código abierto o crea un proyecto de TradingHost en blanco.
- PASO 03
Configura el despliegue
Elige la estrategia, la región del entorno de ejecución, los secretos, el perfil de recursos y los ajustes de despliegue.
- PASO 04
Lanzar
TradingHost inicia la estrategia en un entorno de ejecución gestionado y transmite los registros en tiempo real a tu panel de control.
Sección 03 · Rutas de repositorio
Trae tu propio repositorio o crea uno desde una plantilla
TradingHost ofrece tres formas de iniciar un despliegue.
Trae tu propio repositorio
¿Ya tienes un proyecto de trading en GitHub? Conecta el repositorio a TradingHost, elige el punto de entrada de la estrategia, añade tus secretos, selecciona una región y despliega.
Crea a partir de una plantilla de framework de código abierto
Utiliza una estructura de proyecto lista para desplegar en frameworks de código abierto compatibles como CCXT o Freqtrade. TradingHost creará el repositorio en tu cuenta de GitHub para que luego puedas personalizar el código y desplegarlo.
Crea una plantilla en blanco de TradingHost
Comienza con una estructura de proyecto limpia y lista para TradingHost. Esto es útil si quieres desarrollar tu propia estrategia en Python desde cero manteniendo claros la configuración del entorno de ejecución, la estructura de carpetas y el punto de entrada del despliegue.
Las plantillas son estructuras base para proyectos, no estrategias rentables. Proporcionan estructura, ejemplos de configuración y compatibilidad con el entorno de ejecución. Tú aportas la lógica de trading, los controles de riesgo y la configuración del broker o exchange.
Sección 04 · Propiedad de las plantillas
Al elegir una plantilla, el repositorio es tuyo
Si eliges una plantilla de framework de código abierto o una plantilla en blanco de TradingHost, la plataforma creará un nuevo repositorio en tu cuenta de GitHub.
Ese repositorio te pertenece. Puedes editarlo, crear ramas, hacer commits, revisarlo y gestionarlo como cualquier otro proyecto de GitHub. TradingHost utiliza el repositorio como origen del despliegue, pero tu código permanece en tu cuenta de GitHub.
Una plantilla incluye
- Estructura del proyecto
- Configuración del entorno de ejecución
- Ejemplos de nombres de variables de entorno
- Un punto de entrada para la estrategia
- Ejemplos de logs
- Archivos de dependencias
- Configuración de despliegue de TradingHost
- Instrucciones básicas en el archivo README
Las plantillas son estructuras base para proyectos, no estrategias rentables. Proporcionan estructura, ejemplos de configuración y compatibilidad con el entorno de ejecución. Tú aportas la lógica de trading, los controles de riesgo y la configuración del broker o exchange.
Sección 05 · Controles de la estrategia
Despliega la estrategia que quieras ejecutar
Un repositorio puede contener más de una estrategia, script o punto de entrada. TradingHost trata el despliegue como la instancia de ejecución en vivo, no solo como el repositorio en sí.
Al lanzar un despliegue, eliges la estrategia o el punto de entrada que quieres que ejecute TradingHost. Después, puedes iniciar, detener, reiniciar o actualizar ese despliegue desde el panel de control de TradingHost.
Iniciar la estrategia
Detener la estrategia
Reiniciar el entorno de ejecución
Ver logs
Actualizar secretos
Cambiar la configuración del entorno de ejecución
Volver a desplegar el código más reciente
Revisar el estado del despliegue
- El repositorio
- es tu base de código.
- El despliegue
- es la estrategia en ejecución.
- El panel de control
- es tu interfaz de control.
Sección 06 · Redespliegue automático
Haz push a main, vuelve a desplegar en segundos
TradingHost está diseñado para iterar rápidamente. Cuando actualizas la rama principal (main) del repositorio conectado, TradingHost puede obtener los últimos cambios y volver a desplegar el despliegue asociado de forma automática.
Esto te permite mantener tu flujo de trabajo de desarrollo centrado en GitHub. Realiza un cambio, haz push a main y el despliegue activo recibirá la última versión sin necesidad de reconstruir manualmente el entorno.
- Edita tu estrategia localmente o en tu entorno de desarrollo de IA
- Haz commit y push de los cambios a la rama principal (main)
- TradingHost detecta la actualización
- El despliegue obtiene el código más reciente
- El entorno de ejecución se reinicia con la nueva versión
- Los logs muestran el comportamiento actualizado del entorno de ejecución
Sección 07 · Responsabilidad del estado
TradingHost despliega el código. El estado de la estrategia es tu responsabilidad.
TradingHost no almacena ni gestiona el estado de tu estrategia por ti.
Cuando un despliegue se vuelve a desplegar, se reinicia o se mueve a un nuevo entorno de ejecución, tu código debe estar diseñado para recuperarse de forma segura. Cualquier estado de la estrategia, seguimiento de posiciones, control de órdenes abiertas, persistencia en bases de datos, puntos de control (checkpointing) o lógica de conciliación es tu responsabilidad, a menos que lo proporcione explícitamente tu propia aplicación o servicios externos.
Ejemplos de estado
- Supuestos de posiciones abiertas
- Última vela o transacción procesada
- IDs de órdenes
- Niveles de cuadrícula (grid)
- Valores de trailing stop
- Contadores de riesgo
Recomendaciones
Para operar en tiempo real, tu estrategia debe ser capaz de reconstruir su estado actual a partir de las APIs del broker o exchange, datos externos almacenados o tu propia capa de persistencia. No confíes en que el estado en memoria sobrevivirá a un redespliegue, reinicio o fallo.
Límite claro
TradingHost proporciona controles de despliegue, entorno de ejecución y observabilidad. No garantiza la continuidad del estado en memoria de la estrategia creado por el usuario.
Sección 08 · Asistido por IA
Diseñado para el desarrollo asistido por IA
Los despliegues de TradingHost están diseñados para funcionar con flujos de trabajo de desarrollo asistidos por IA. Puedes crear y editar estrategias en herramientas como Cursor o Claude Code, subir los cambios a GitHub y dejar que TradingHost despliegue automáticamente la última versión.
Gracias al soporte de MCP, las herramientas compatibles también pueden interactuar con las funciones de TradingHost, como listar despliegues, inspeccionar logs e iniciar redespliegues.
Sección 09 · Ciclo de vida
El ciclo de vida del despliegue
Cada despliegue sigue un ciclo de vida sencillo, desde el repositorio hasta la estrategia en ejecución.
Creado
El despliegue está configurado pero aún no está en ejecución.
Iniciando
TradingHost está preparando el entorno de ejecución e iniciando el proceso de la estrategia.
En ejecución
La estrategia está activa dentro del entorno de ejecución seleccionado.
Detenido
El despliegue se ha detenido intencionadamente y no hay ningún proceso de estrategia en ejecución.
Reiniciando
TradingHost está reiniciando el entorno de ejecución o el proceso de la estrategia.
Redesplegando
TradingHost está descargando el código más reciente y reiniciando el despliegue.
Fallido
El entorno de ejecución o el proceso de la estrategia no pudieron iniciarse o continuar ejecutándose. Se deben revisar los logs.
Los estados del despliegue te ayudan a entender qué está haciendo TradingHost y dónde mirar a continuación. Si un despliegue falla, los logs son el primer lugar que debes revisar.
Sección 10 · División de responsabilidades
Dónde termina TradingHost y dónde empiezas tú
TradingHost gestiona la capa de despliegue que rodea tu código de trading. Tú sigues siendo responsable del sistema de trading en sí.
TradingHost gestiona
La capa de despliegue
- Conexión con GitHub
- Selección o creación de repositorios
- Configuración del despliegue
- Inicio del entorno de ejecución
- Inyección de secretos
- Selección de región
- Estado de salud básico
- Transmisión de logs sin procesar
- Controles de inicio y parada
- Flujo de trabajo de redespliegue
Usted es responsable de
El sistema de trading
- Lógica de la estrategia
- Permisos de brókers y exchanges
- Creación de claves API
- Controles de riesgo
- Conciliación de posiciones
- Gestión de órdenes
- Gestión de errores
- Persistencia externa
- Pruebas antes de operar en real
- Monitoreo del comportamiento en vivo
- Cumplimiento de los términos del bróker o exchange
Declaración directa
TradingHost facilita el despliegue y la operación de código de trading. No hace que el código de trading sea seguro, rentable o correcto por defecto.
Sección 11 · Patrones de repositorio
Patrones de repositorio compatibles
TradingHost está diseñado para admitir diferentes estructuras de repositorio, siempre que el punto de entrada del despliegue y la configuración del entorno de ejecución estén claros.
Repositorio de estrategia única
Un único repositorio contiene una estrategia y un punto de entrada de despliegue.
Repositorio multiestrategia
Un repositorio contiene múltiples estrategias. Cada despliegue de TradingHost selecciona la estrategia que debe ejecutar.
Proyecto de framework
Un repositorio contiene un proyecto de un framework compatible, como CCXT o Freqtrade.
Proyecto en blanco
Un repositorio que comienza con una estructura en blanco lista para TradingHost y se desarrolla hasta convertirse en su propia base de código de estrategia.
Para lograr despliegues predecibles, mantenga explícitos los puntos de entrada, las variables de entorno y la configuración del entorno de ejecución.
Preguntas frecuentes
Preguntas frecuentes
Sí. La versión 1 de TradingHost utiliza GitHub como fuente de verdad para el código de la estrategia y las actualizaciones de despliegue.
Sí. Puede conectar un repositorio de GitHub existente y desplegar una estrategia desde él.
Sí. Si elige una plantilla de framework de código abierto o una plantilla en blanco de TradingHost, TradingHost puede crear un nuevo repositorio en su cuenta de GitHub.
No. Las plantillas son estructuras de proyecto listas para desplegar. Pueden incluir código de ejemplo, configuración y puntos de entrada, pero no son estrategias rentables, señales de trading ni asesoramiento financiero.
Si los redespliegues automáticos están activados, TradingHost puede descargar los últimos cambios de la rama main y volver a desplegar el entorno de ejecución asociado en cuestión de segundos.
No. TradingHost no almacena el estado de la estrategia del usuario. Tu código debe gestionar la persistencia, la conciliación con el broker y la lógica de recuperación si tu estrategia depende del estado entre reinicios o redespliegues.
Sí. Un despliegue se puede iniciar, detener, reiniciar y volver a desplegar desde el panel de control de TradingHost.
Sí, siempre que la estructura de tu repositorio y la configuración de despliegue definan claramente el punto de entrada de cada estrategia. Cada despliegue debe especificar qué se va a ejecutar.
No. El código de tu estrategia se conecta al broker o exchange y envía las órdenes según tu propia lógica. TradingHost proporciona el entorno de ejecución y la capa de despliegue.
Sí. TradingHost está diseñado para flujos de trabajo compatibles con MCP, por lo que las herramientas de desarrollo de IA admitidas pueden inspeccionar despliegues, ver logs y activar redespliegues cuando estén autorizadas.
Despliega tu estrategia desde GitHub
Conecta un repositorio existente o crea uno a partir de una plantilla de TradingHost, configura tu despliegue y lanza tu estrategia en un entorno de ejecución siempre activo.