O que cli-anything-novita faz?
Um harness CLI para Novita AI – um serviço de API compatível com OpenAI para modelos de IA como DeepSeek, GLM e outros.
Instalação
Este CLI é instalado como parte do pacote cli-anything-novita:
pip install cli-anything-novita
Pré-requisitos:
- Python 3.10+
- Chave de API Novita em novita.ai
Uso
Comandos Básicos
# Exibir ajuda
cli-anything-novita --help
# Iniciar modo REPL interativo
cli-anything-novita
# Conversar com o modelo
cli-anything-novita chat --prompt "O que é IA?" --model deepseek/deepseek-v3.2
# Chat em streaming
cli-anything-novita stream --prompt "Escreva um poema sobre código"
# Listar modelos disponíveis
cli-anything-novita models
# Saída JSON (para consumo por agentes)
cli-anything-novita --json chat --prompt "Olá"
Modo REPL
Quando invocado sem um subcomando, o CLI entra em uma sessão REPL interativa:
cli-anything-novita
# Insira comandos interativamente com auto-preenchimento e histórico
Grupos de Comandos
Chat
Converse com modelos de IA através da API Novita.
| Comando | Descrição |
|---|---|
chat | Conversar com a API Novita |
stream | Chat de conclusão em streaming |
Sessão
Gerenciamento de sessão para histórico de conversas.
| Comando | Descrição |
|---|---|
status | Exibir status da sessão |
clear | Limpar histórico da sessão |
history | Exibir histórico de comandos |
Config
Gerenciamento de configuração.
| Comando | Descrição |
|---|---|
set | Definir um valor de configuração |
get | Obter um valor de configuração (ou exibir todos) |
delete | Excluir um valor de configuração |
path | Exibir o caminho do arquivo de configuração |
Utilitário
| Comando | Descrição |
|---|---|
test | Testar conectividade da API |
models | Listar modelos disponíveis |
Exemplos
Configurar Chave de API
# Definir chave de API via arquivo de configuração (recomendado)
cli-anything-novita config set api_key "sk-xxx"
# Ou usar variável de ambiente
export NOVITA_API_KEY="sk-xxx"
Conversar com DeepSeek
# Conversa simples
cli-anything-novita chat --prompt "Explique computação quântica" --model deepseek/deepseek-v3.2
# Chat em streaming
cli-anything-novita stream --prompt "Escreva uma função Python para calcular o fatorial"
Testar Conectividade
# Verificar chave de API e conectividade
cli-anything-novita test --model deepseek/deepseek-v3.2
# Listar todos os modelos disponíveis
cli-anything-novita models
Modelos Padrão
A API Novita suporta múltiplos provedores de modelos:
| ID do Modelo | Provedor | Descrição |
|---|---|---|
deepseek/deepseek-v3.2 | DeepSeek | Modelo DeepSeek V3.2 (padrão) |
zai-org/glm-5 | Zhipu AI | Modelo GLM-5 |
minimax/minimax-m2.5 | MiniMax | Modelo MiniMax M2.5 |
Formatos de Saída
Todos os comandos suportam modos de saída dupla:
- Legível para humanos (padrão): Tabelas, cores, texto formatado
- Legível para máquina (flag
--json): JSON estruturado para consumo por agentes
# Saída humana
cli-anything-novita chat --prompt "Olá"
# Saída JSON para agentes
cli-anything-novita --json chat --prompt "Olá"
Para Agentes de IA
Ao usar este CLI programaticamente:
- Sempre use a flag
--jsonpara saída parseável - Verifique os códigos de retorno – 0 para sucesso, não-zero para erros
- Analise stderr para mensagens de erro em caso de falha
- Use caminhos absolutos para todas as operações com arquivos
- Verifique se as saídas existem após operações de exportação
Mais Informações
- Documentação completa: Consulte README.md no pacote
- Cobertura de testes: Consulte TEST.md no pacote
- Metodologia: Consulte HARNESS.md no cli-anything-plugin
Versão
1.0.0