Repolode
basetenlabs

basetenlabs/truss

CLI y toolkit de Python para empaquetar y desplegar modelos de ML en Baseten o en infraestructura propia como servidores de modelos listos para producción.

Estrellas
1,228
Forks
142
Issues abiertos
90
Último commit
hace 18 horas

¿Qué es?

Truss empaqueta la lógica de inferencia de un modelo, sus pesos y dependencias en un servidor de modelos listo para ejecutarse en un contenedor y, después, lo despliega en Baseten o en infraestructura propia. Se configura mediante una clase de modelo de Python para el código personalizado y un archivo config.yaml que declara el hardware, como el tipo de GPU, y las opciones de compilación. Los desarrolladores pueden iterar con un modo de desarrollo con recarga en caliente, mientras que Docker y Kubernetes se configuran automáticamente.

El proyecto admite modelos de frameworks open source populares, como vLLM, SGLang, TensorRT-LLM, transformers, diffusers, PyTorch y TensorFlow. Para los LLM, la configuración puede crear un motor de TensorRT-LLM con opciones como la cuantización FP8 y la longitud máxima de secuencia; el despliegue resultante expone una API compatible con OpenAI. Entre las funciones para producción se incluyen la configuración de GPU, los secretos, el almacenamiento en caché y el autoescalado en Baseten.

Es una buena opción para equipos que quieren convertir un modelo de Hugging Face o un modelo personalizado de PyTorch en un endpoint alojado, sin tener que escribir la infraestructura de serving. El repositorio también incluye un esquema JSON para config.yaml que habilita el autocompletado en el editor.

Funciones clave

  • 01Empaqueta el código del modelo, sus pesos y dependencias en un servidor de modelos
  • 02Modo de desarrollo con recarga en caliente para iterar más rápido
  • 03Compila motores de TensorRT-LLM con cuantización FP8 a partir de una configuración YAML
  • 04Ofrece endpoints compatibles con OpenAI para despliegues de LLM
  • 05Admite modelos de vLLM, SGLang, transformers, diffusers, PyTorch y TensorFlow
  • 06Ofrece configuración de GPU, secretos, almacenamiento en caché y autoescalado en Baseten

Casos de uso

  • Desplegar un LLM de Hugging Face como endpoint de API alojado sin escribir Dockerfiles
  • Servir en producción un modelo personalizado de PyTorch o de difusión con aceleración de GPU
  • Sustituir infraestructuras de serving de modelos creadas a mano por un flujo de trabajo basado en configuración

Inicio rápido

  1. 1

    Instala Truss con pip

    pip install --upgrade truss
  2. 2

    Inicia sesión en Baseten

    uvx truss login
  3. 3

    Crea la estructura de un proyecto nuevo

    uvx truss init qwen-2.5-3b && cd qwen-2.5-3b
  4. 4

    Despliega el modelo en Baseten

    uvx truss push

Antes de usarlo

  • Para desplegar la guía de inicio rápido, necesitas una cuenta y una clave de API de Baseten.
  • El despliegue de TRT-LLM de la guía de inicio rápido requiere una GPU L4 en Baseten, y TRT-LLM no admite el modo --watch.

En colecciones

Temas

Preguntas frecuentes

¿Qué es truss?
CLI y toolkit de Python para empaquetar y desplegar modelos de ML en Baseten o en infraestructura propia como servidores de modelos listos para producción. Truss empaqueta la lógica de inferencia de un modelo, sus pesos y dependencias en un servidor de modelos listo para ejecutarse en un contenedor y, después, lo despliega en Baseten o en infraestructura propia. Se configura mediante una clase de modelo de Python para el código personalizado y un archivo config.yaml que declara el hardware, como el tipo de GPU, y las opciones de compilación. Los desarrolladores pueden iterar con un modo de desarrollo con recarga en caliente, mientras que Docker y Kubernetes se configuran automáticamente.
¿truss es gratuito? ¿Qué licencia tiene?
truss es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿truss sigue mantenido?
Mantenimiento activo. El último commit de truss fue el 5 nov 2026.
¿Para qué puedo usar truss?
Desplegar un LLM de Hugging Face como endpoint de API alojado sin escribir Dockerfiles Servir en producción un modelo personalizado de PyTorch o de difusión con aceleración de GPU Sustituir infraestructuras de serving de modelos creadas a mano por un flujo de trabajo basado en configuración
¿Cómo se instala truss?
Instala Truss con pip: pip install --upgrade truss Inicia sesión en Baseten: uvx truss login Crea la estructura de un proyecto nuevo: uvx truss init qwen-2.5-3b && cd qwen-2.5-3b Despliega el modelo en Baseten: uvx truss push
¿Dónde consigo truss?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/basetenlabs/truss

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados