O que Agente-de-Terminal-Ollama faz?
Automatiza tarefas de shell usando um modelo local do Ollama que planeja, executa e corrige comandos sem dependências de nuvem ou API.
Visão Geral
Este agente permite descrever tarefas em linguagem natural e deixar que um modelo de linguagem local (via Ollama) as execute no terminal, eliminando a necessidade de chamadas externas ou planos pagos.
Como Funciona
- O modelo local recebe uma descrição da tarefa (ex.: "extraia todos os arquivos .zip da pasta atual e organize-os em subpastas por data de modificação").
- O agente planeja e gera os comandos shell necessários, considerando segurança e boas práticas.
- Os comandos são executados sequencialmente no terminal.
- Se um comando falhar, o agente analisa o erro e tenta corrigi-lo automaticamente, reexecutando até que a tarefa seja concluída ou um limite seja atingido.
Requisitos
- Ollama instalado e rodando localmente.
- Um modelo compatível baixado (recomendado:
llama3,codellama,mistral). - Sistema operacional baseado em Unix ou Windows (com suporte a shell).
Instalação
-
Clone o repositório:
git clone https://github.com/unequalequality/Ollama-Terminal-Agent.git cd Ollama-Terminal-Agent -
Instale as dependências:
pip install -r requirements.txt -
Execute o agente:
python main.py
Uso
Informe a tarefa desejada quando solicitado. Exemplo:
Digite sua tarefa: Liste todos os arquivos maiores que 10 MB no diretório atual e registre-os em um arquivo big_files.txt
O agente pode:
- Navegar e manipular arquivos/diretórios.
- Executar operações de rede e sistema.
- Instalar pacotes e gerenciar processos.
- Corrigir automaticamente comandos com falhas.
Configuração
Defina o modelo desejado via variável de ambiente:
export OLLAMA_MODEL="llama3"
Ou edite o arquivo config.yaml:
model: llama3
temperature: 0.2
max_retries: 3
Segurança
Revise comandos antes da execução quando o agente solicitar confirmação. Você pode habilitar o modo de aprovação manual definindo MANUAL_APPROVAL=true.
Licença
MIT