Pular para o conteúdo principal
mka1 é a interface de linha de comando oficial para a API MKA1. Toda operação disponível pela API REST pode ser chamada como um comando, com flags, pipe via stdin, múltiplos formatos de saída e um explorador de comandos interativo. Use para:
  • Automatizar chamadas pontuais à API e jobs de CI sem precisar de um SDK.
  • Inspecionar dados em tempo real rapidamente — listar respostas, baixar arquivos, buscar em um vetor store.
  • Prototipar corpos de requisição antes de migrá-los para os SDKs de TypeScript, C# ou Python.

​
Instalação

Binários pré-compilados para todas as plataformas suportadas estão disponíveis em downloads.mka1.com. As URLs *-latest sempre redirecionam para a versão mais recente, então você pode salvá-las em scripts e pipelines de CI.
PlataformaArquiteturaDownload
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
Troque arm64 por x86_64 em Macs 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

Baixe mka1_windows_x86_64-latest.zip, extraia o arquivo e adicione a pasta contendo mka1.exe ao seu PATH.

​
Verifique a instalação

Imprima a versão do CLI para confirmar que o binário está no seu PATH: 
mka1 version
Todo comando suporta --help, que exibe uma descrição, uso e as flags disponíveis: 
mka1 --help
mka1 llm responses create --help

​
Habilite a conclusão automática no shell

As conclusões são geradas sob demanda e cobrem subcomandos, flags e valores conhecidos de enums. 
# Temporário, para o shell atual:
source <(mka1 completion bash)

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

​
Execute sua primeira requisição

Autentique uma vez e chame qualquer endpoint. O caminho mais rápido é definir sua chave em uma variável de ambiente e gerar uma resposta: 
export MKA1_BEARER_AUTH="Bearer <mka1-api-key>"

mka1 llm responses create \
  --model meetkai:functionary-pt \
  --input '"Escreva um resumo de uma frase sobre a API MKA1."'
Para uma configuração persistente que armazena segredos no keychain do seu sistema operacional, veja autentique o CLI.

​
Explore de forma interativa

mka1 explore inicia uma interface de terminal que permite navegar por todos os grupos de comandos, inspecionar as flags de cada comando e executá-los sem sair do shell: 
mka1 explore
Use quando não tiver certeza de qual subcomando ou nome de flag utilizar.

​
Próximos passos