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 de comandos interactivo. Ú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 almacén vectorial.
  • Prototipar cuerpos de solicitud antes de trasladarlos al SDK de TypeScript, C# o Python.

Instalación

Los binarios precompilados para cada plataforma compatible están disponibles en downloads.mka1.com. Las URLs *-latest siempre redirigen a la versión más reciente, por lo que puedes marcarlas 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, descomprímelo y agrega la carpeta que contiene mka1.exe a tu variable 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 admite --help, que imprime una descripción, uso y los flags aplicables:
mka1 --help
mka1 llm responses create --help

Habilita la autocompletación de shell

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. La forma más rápida 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 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 necesitas.

Próximos pasos