CLI do Groq Code: uma ferramenta de programação de linha de comando personalizável com base no Groq

Groq O Code CLI é uma ferramenta de programação de linha de comando leve e de código aberto que aproveita a API do Groq para fornecer recursos rápidos de interação e geração de código de IA. A ideia central deste projeto não é ser um aplicativo enorme com funcionalidade pesada e de difícil manutenção, mas sim servir como um modelo básico no qual os desenvolvedores possam facilmente modificar, estender e personalizar para criar suas próprias ferramentas de linha de comando. Os desenvolvedores podem facilmente adicionar novos comandos, integrar ferramentas externas e até mesmo modificar os elementos visuais da interface. Ao simplificar a base de código e reduzir a complexidade, ele incentiva os desenvolvedores a se aprofundarem e personalizarem o desenvolvimento de acordo com seus próprios fluxos de trabalho. Por exemplo, os usuários podem adicionar recursos avançados, como análise de complexidade de código, testes automatizados, criação de gráficos de conhecimento etc. por conta própria.

Lista de funções

• Interação rápidaDesenvolvido pelo Groq, permitindo a geração rápida de códigos e respostas.
• Bate-papo na linha de comandoNo terminal, por meio degroqinicia uma sessão de bate-papo interativo com a IA.
• A altura pode ser personalizadaPermite que os desenvolvedores adicionem facilmente novos comandos e ferramentas de barra, fornecendo diretrizes detalhadas de personalização.
• Gerenciamento de chaves de API: Apoiar a adoção de/loginou definir variáveis de ambienteGROQ_API_KEYpara gerenciar e autenticar usuários.
• Seleção de modelosUsuários podem usar o/modelpara visualizar e selecionar os diferentes modelos de idiomas disponíveis na plataforma Groq.
• Gerenciamento de sessões: Fornecido/clearvocê pode limpar o histórico e o contexto do bate-papo atual a qualquer momento.
• parametrizaçãoSuporte para ajustar o comportamento dos modelos de IA por meio de opções de linha de comando, como o uso da opção-ttalvez--temperaturepara definir a diversidade do conteúdo gerado.
• Personalização de mensagens do sistemaOs usuários podem acessar essas informações por meio de-stalvez--systemfornece instruções personalizadas em nível de sistema para a IA na inicialização.

Usando a Ajuda

O Groq Code CLI é uma ferramenta de linha de comando para desenvolvedores projetada para fornecer um ambiente de programação de IA altamente personalizável e rapidamente iterativo. Aqui estão instruções detalhadas de instalação e uso para ajudá-lo a começar rapidamente.

montagem

Você pode escolher entre dois tipos de instalação, dependendo de suas necessidades:

1. teste rápido (npx)

Se você quiser apenas experimentar rapidamente a ferramenta e não quiser clonar toda a base de código localmente, poderá usar a opçãonpxcomando. Esse comando extrairá a versão estável mais recente do repositório npm e a executará diretamente sem instalar nenhum arquivo em seu computador.

Abra seu terminal e digite o seguinte comando:

npx groq-code-cli@latest

Uma vez executada, a CLI do Groq Code será iniciada e você poderá começar a usá-la imediatamente.

2. desenvolvimento local e personalização (recomendado)

Se você deseja fazer alterações nessa ferramenta, adicionar novos recursos ou usá-la por um longo período, recomenda-se o modo de desenvolvimento e instalação local. Esse modo clonará todo o código-fonte do projeto em seu computador e permitirá que você faça alterações no código.

Etapa 1: clonar a base de código
Primeiro, use ogitClone o código-fonte do projeto localmente a partir do GitHub.

git clone https://github.com/build-with-groq/groq-code-cli.git

Etapa 2: Insira o catálogo do projeto
fazer uso decdna pasta que você acabou de clonar.

cd groq-code-cli

Etapa 3: Instalar as dependências do projeto
O projeto usa o Node.js e você precisa usar onpm installpara instalar todas as dependências necessárias.

npm install

Etapa 4: Compilar o projeto
Como o projeto é escrito em TypeScript, você precisa compilá-lo em JavaScript para executá-lo.

npm run build

Etapa 5: Link para o comando global
Para poder passar por qualquer caminho no sistema degroqpara invocar essa ferramenta, você precisa usar o comandonpm linkComando.

npm link

Após a execução desse comando, ogroqtorna-se um comando disponível globalmente.

Etapa 6 (opcional): habilitar a compilação automática
Se você planeja fazer alterações no código-fonte, pode executar o comando do modo de desenvolvimento. Esse comando monitorará o arquivo em busca de alterações e recompilará automaticamente o arquivo depois de salvá-lo, evitando que você tenha que executar manualmente o comandonpm run build.

npm run dev

Recomenda-se manter esse comando em execução em uma janela de terminal separada.

Usuários iniciantes: configuração de chaves de API

Seja qual for a forma de instalação, você precisará configurar sua chave de API do Groq na primeira vez que o executar.

1. Inicie a ferramenta no terminal:

   groq
   

2. Na tela de bate-papo que é aberta, digite/logine pressione Enter.
3. O programa solicitará sua chave de API. Você pode obter sua chave de API gratuita no Console do Groq.
4. Depois de inserir a chave, o programa criará um arquivo no diretório inicial do usuário chamado.groqpasta oculta para salvar chaves e outras informações de configuração.

Você também pode fornecer a chave de API temporariamente definindo uma variável de ambiente, o que é útil em um ambiente de integração contínua (CI) ou para testes.

export GROQ_API_KEY=your_api_key_here

Funções principais

1. iniciar uma sessão de bate-papo

Em qualquer diretório, basta digitar no terminalgroqVocê pode iniciar um diálogo com a IA.

Você pode fazer perguntas diretamente ou pedir que ele o ajude a escrever código, explicar conceitos, etc.

2. uso de comandos de barra

Na tela Chat, você pode digitar o nome da pessoa com quem deseja falar, digitando o nome da pessoa com quem deseja falar./comandos no início para realizar operações específicas.

• /helpComando: Exibe todos os comandos disponíveis e suas descrições.
• /loginAPI: Usado para fazer login e definir a chave da API.
• /modelLista os modelos de IA disponíveis no momento e permite que você troque de modelo.
• /clearLimpar o histórico de bate-papo da janela atual e iniciar um novo diálogo.
• /reasoningIA: Alterna se deve ou não mostrar o processo de pensamento da IA em suas respostas.

3. uso de opções de linha de comando

Você pode iniciar ogroqAdicione algumas opções para controlar o comportamento da IA no momento do comando.

• -t, --temperature <temp>:: define a "temperatura" do conteúdo gerado, que é um número entre 0 e 2. Valores mais altos (por exemplo, 1,2) tornarão a saída mais criativa e aleatória, enquanto valores mais baixos (por exemplo, 0,5) tornarão a saída mais determinística e consistente. O valor padrão é 1.

  groq -t 0.7
  

• -s, --system <message>Mensagem do sistema: Define uma mensagem do sistema. Essa mensagem funcionará como a instrução mais alta, orientando o comportamento da IA durante toda a sessão. Por exemplo, você pode fazer com que ela desempenhe uma função específica.

  groq -s "你是一个资深的Go语言程序员，请只用Go语言回答问题。"
  

• -d, --debugAtivação do modo de depuração produzirá mensagens de registro detalhadas no diretório atual dodebug-agent.logDocumentação.
• -h, --helpAjuda: Exibe uma mensagem de ajuda que lista todas as opções de linha de comando disponíveis.
• -V, --versionExibe o arquivo instalado atualmentegroq-code-cliO número da versão do

cenário do aplicativo

1. Assistência diária à codificação
   A qualquer momento, enquanto escrevem o código, os desenvolvedores podem abrir um terminal e fazer perguntas à CLI do Groq Code, como "Como faço para implementar um algoritmo de classificação rápida em Python?" ou "Ajude-me a escrever um trecho de código do Node.js que se conecte a um banco de dados Redis". ou "Escreva-me um trecho de código Node.js que se conecte a um banco de dados Redis". Graças ao seu rápido tempo de resposta, você pode reduzir significativamente o tempo gasto na busca de informações em mecanismos de pesquisa e documentos.
2. Depuração e interpretação de código
   Ao encontrar um trecho de código que você não entende ou um erro difícil de solucionar, você pode colar o código ou a mensagem de erro diretamente na CLI e deixar que a IA explique a lógica do código ou forneça as possíveis causas do erro e sugestões para corrigi-lo.
3. Aprendizado de novas tecnologias
   Os iniciantes ou desenvolvedores que desejam expandir sua pilha de tecnologia podem usá-lo como uma ferramenta de aprendizado interativa. É possível fazer perguntas sobre conceitos básicos e uso essencial de novas estruturas e linguagens, e a IA fornecerá explicações estruturadas e exemplos de código.
4. Scripts de automação
   Para a equipe de O&M ou os desenvolvedores que precisam escrever alguns scripts simples (por exemplo, Shell, Python) para automatizar suas tarefas diárias, eles podem usar diretamente a linguagem natural para descrever os requisitos, por exemplo, "Escreva um script para excluir todos os arquivos .log no diretório atual que tenham mais de 30 dias", e a IA pode gerar rapidamente um script utilizável.
5. Criação de ferramentas de desenvolvimento personalizadas
   Os usuários Premium e as equipes de desenvolvedores podem usar a CLI do Groq Code para integrar a base de conhecimento interna da equipe, a documentação da API, as especificações de código e outras informações, ou adicionar funcionalidades para interagir com sistemas internos (por exemplo, CI/CD, ferramentas de gerenciamento de projetos) para criar uma ferramenta de CLI proprietária que corresponda ao fluxo de trabalho específico da equipe.

QA

1. Essa ferramenta é gratuita?
   A própria CLI do Groq Code é de código aberto e gratuita, e você pode obter o código-fonte completo no GitHub. No entanto, ela depende dos serviços de modelagem de IA fornecidos pela Groq Cloud Platform, e você precisa obter a chave de API no site oficial da Groq. Normalmente, o Groq fornece uma certa quantidade de uso gratuito para novos usuários, além do qual é necessário pagar.
2. É necessário saber programação para usá-lo?
   Não é necessário nenhum conhecimento de programação para o uso básico; você pode conversar com ele como uma ferramenta de bate-papo para obter informações e códigos. No entanto, seu principal valor está na capacidade de personalização e, se você quiser modificar ou ampliar sua funcionalidade, será necessário algum conhecimento de programação Node.js e TypeScript.
3. Qual é a diferença em relação a outras ferramentas de programação de IA?
   A maior diferença é sua filosofia de design. Em contraste com muitas ferramentas de programação de IA que buscam ser grandes e repletas de recursos, mas com códigos complexos e difíceis de modificar, a CLI do Groq Code é intencionalmente leve e simples, posicionando-se como um "projeto" ou "estrutura" que incentiva os usuários a fazer suas próprias personalizações e extensões, sendo seus principais pontos fortes a alta capacidade de personalização e a baixa latência. Seus principais pontos fortes são a alta capacidade de personalização e a baixa latência.
4. Como adicionar um novo comando como/test?
   Você precisará configurar osrc/commands/definitions/para criar um diretóriotest.tsno qual você define o comportamento do comando e, em seguida, no arquivosrc/commands/index.tspara registrar esse novo comando. A documentação detalhada de desenvolvimento é fornecida no arquivo README do projeto, e as diretrizes são muito claras.