¿Qué hace cli-anything-novita?
Un harness CLI para Novita AI, un servicio de API compatible con OpenAI para modelos de IA como DeepSeek, GLM y otros.
Instalación
Este CLI se instala como parte del paquete cli-anything-novita:
pip install cli-anything-novita
Requisitos previos:
- Python 3.10+
- Clave de API de Novita desde novita.ai
Uso
Comandos básicos
# Mostrar ayuda
cli-anything-novita --help
# Iniciar modo REPL interactivo
cli-anything-novita
# Chatear con el modelo
cli-anything-novita chat --prompt "¿Qué es IA?" --model deepseek/deepseek-v3.2
# Chat en streaming
cli-anything-novita stream --prompt "Escribe un poema sobre código"
# Listar modelos disponibles
cli-anything-novita models
# Salida JSON (para consumo por agentes)
cli-anything-novita --json chat --prompt "Hola"
Modo REPL
Cuando se invoca sin un subcomando, el CLI entra en una sesión REPL interactiva:
cli-anything-novita
# Ingresa comandos interactivamente con autocompletado y historial
Grupos de comandos
Chat
Chatea con modelos de IA a través de la API de Novita.
| Comando | Descripción |
|---|---|
chat | Chatear con la API de Novita |
stream | Transmitir la respuesta del chat |
Sesión
Gestión de sesiones para el historial de chat.
| Comando | Descripción |
|---|---|
status | Mostrar estado de la sesión |
clear | Limpiar el historial de la sesión |
history | Mostrar el historial de comandos |
Configuración
Gestión de configuración.
| Comando | Descripción |
|---|---|
set | Establecer un valor de configuración |
get | Obtener un valor de configuración (o mostrar todos) |
delete | Eliminar un valor de configuración |
path | Mostrar la ruta del archivo de configuración |
Utilidad
| Comando | Descripción |
|---|---|
test | Probar la conectividad de la API |
models | Listar modelos disponibles |
Ejemplos
Configurar clave de API
# Establecer clave de API mediante archivo de configuración (recomendado)
cli-anything-novita config set api_key "sk-xxx"
# O usar variable de entorno
export NOVITA_API_KEY="sk-xxx"
Chatear con DeepSeek
# Chat simple
cli-anything-novita chat --prompt "Explica la computación cuántica" --model deepseek/deepseek-v3.2
# Chat en streaming
cli-anything-novita stream --prompt "Escribe una función en Python para calcular factorial"
Probar conectividad
# Verificar clave de API y conectividad
cli-anything-novita test --model deepseek/deepseek-v3.2
# Listar todos los modelos disponibles
cli-anything-novita models
Modelos predeterminados
La API de Novita soporta múltiples proveedores de modelos:
| ID del modelo | Proveedor | Descripción |
|---|---|---|
deepseek/deepseek-v3.2 | DeepSeek | Modelo DeepSeek V3.2 (predeterminado) |
zai-org/glm-5 | Zhipu AI | Modelo GLM-5 |
minimax/minimax-m2.5 | MiniMax | Modelo MiniMax M2.5 |
Formatos de salida
Todos los comandos soportan dos modos de salida:
- Legible por humanos (predeterminado): Tablas, colores, texto formateado
- Legible por máquina (bandera
--json): JSON estructurado para consumo por agentes
# Salida para humanos
cli-anything-novita chat --prompt "Hola"
# Salida JSON para agentes
cli-anything-novita --json chat --prompt "Hola"
Para agentes de IA
Al usar este CLI de forma programática:
- Usa siempre la bandera
--jsonpara obtener salida analizable - Revisa los códigos de retorno - 0 para éxito, distinto de cero para errores
- Analiza stderr para mensajes de error en caso de fallo
- Usa rutas absolutas para todas las operaciones con archivos
- Verifica que las salidas existan después de operaciones de exportación
Más información
- Documentación completa: Consulta README.md en el paquete
- Cobertura de pruebas: Consulta TEST.md en el paquete
- Metodología: Consulta HARNESS.md en cli-anything-plugin
Versión
1.0.0