Saltar al contenido principal
mka1 es la interfaz de línea de comandos oficial para la API de MKA1. Cada operación que puedes llamar a través de la API REST está disponible como un comando, con flags, canalización de stdin, múltiples formatos de salida y un explorador interactivo de comandos. Úsala para:
  • Automatizar llamadas puntuales a la API y trabajos de CI sin necesidad de un SDK.
  • Inspeccionar datos en vivo rápidamente — listar respuestas, descargar archivos, buscar en un vector store.
  • Prototipar cuerpos de solicitud antes de llevarlos al SDK de TypeScript, C# o Python.

Instalación

Binarios precompilados para cada plataforma soportada están disponibles en downloads.mka1.com. Las URLs *-latest siempre redirigen a la versión más reciente, por lo que puedes guardarlas en scripts y CI.
PlataformaArquitecturaDescarga
macOSarm64 (Apple silicon)mka1_darwin_arm64-latest.tar.gz
macOSx86_64 (Intel)mka1_darwin_x86_64-latest.tar.gz
Linuxx86_64 (Debian/Ubuntu)mka1_linux_x86_64-latest.deb
Linuxx86_64 (RHEL/Fedora)mka1_linux_x86_64-latest.rpm
Windowsx86_64mka1_windows_x86_64-latest.zip

macOS

curl -fsSL https://downloads.mka1.com/darwin/mka1_darwin_arm64-latest.tar.gz \
  | tar -xz -C /usr/local/bin mka1
Cambia arm64 por x86_64 en Macs con Intel.

Linux

# Debian / Ubuntu
curl -fsSLo mka1.deb https://downloads.mka1.com/linux/mka1_linux_x86_64-latest.deb
sudo dpkg -i mka1.deb

# RHEL / Fedora / Amazon Linux
curl -fsSLo mka1.rpm https://downloads.mka1.com/linux/mka1_linux_x86_64-latest.rpm
sudo rpm -i mka1.rpm

Windows

Descarga mka1_windows_x86_64-latest.zip, extrae el archivo y agrega la carpeta que contiene mka1.exe a tu variable de entorno PATH.

Verifica la instalación

Imprime la versión de la CLI para confirmar que el binario está en tu PATH:
mka1 version
Cada comando soporta --help, que imprime una descripción, uso y los flags disponibles:
mka1 --help
mka1 llm responses create --help

Habilita la autocompletación de comandos

Las autocompletaciones se generan bajo demanda y cubren subcomandos, flags y valores conocidos de enums.
# Temporal, para la shell actual:
source <(mka1 completion bash)

# Permanente, para todo el sistema:
mka1 completion bash > /etc/bash_completion.d/mka1

Ejecuta tu primera solicitud

Autentícate una vez y luego llama a cualquier endpoint. El camino más rápido es establecer tu clave en una variable de entorno y generar una respuesta:
export MKA1_BEARER_AUTH="Bearer <mka1-api-key>"

mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --input '"Escribe un resumen de una frase de la API de MKA1."'
Para una configuración persistente que almacene los secretos en el llavero de tu sistema operativo, consulta autenticar la CLI.

Explora de forma interactiva

mka1 explore inicia una interfaz de usuario en la terminal que te permite explorar cada grupo de comandos, inspeccionar los flags de cada comando y ejecutarlo sin salir de la shell:
mka1 explore
Úsalo cuando no estés seguro de qué subcomando o nombre de flag utilizar.

Próximos pasos