ZEPHYRON — Agente CLI de Programação 🤖

Um agente CLI tipo Codex feito em Node.js, com ACESSO TOTAL AO SISTEMA. Capaz de navegar em qualquer pasta, criar/editar código, rodar terminal, buscar trechos, gerar código, e muito mais — tudo via linha de comando.

⚙️ Requisitos

• Node.js >= 20
• npm
• Uma chave de API: Pool API (sky_...) ou NVIDIA NIM (nvapi_...)

🚀 Instalação (1 comando, qualquer PC)

npm install -g zephron      # instala do npm registry
znia                         # comando global — funciona de qualquer pasta!

💡 Primeira vez: o ZEPHYRON cria automaticamente ~/.ivitoria/.env. Configure sua API key nesse arquivo.

Instalar do código-fonte (desenvolvedor)

cd "Desktop/ia vitor"
npm install
npm link
znia

🔧 Comandos da CLI

| Comando | Descrição | |--------------|----------------------------------------| | ajuda | Mostra esta ajuda completa | | memoria | Mostra o histórico de conversas | | limpar | Limpa a memória/conversa | | info | Info do projeto atual | | sistema | Info do sistema (SO, RAM, CPU, etc) | | sair | Sai do agente |

🛠️ Tools Disponíveis (21 tools!)

📁 Manipulação de Arquivos

| Tool | O que faz | |--------------------|---------------------------------------------| | listar_arquivos | Lista pastas/arquivos em qualquer diretório | | ler_arquivo | Lê conteúdo de um arquivo | | escrever_arquivo | Cria/atualiza um arquivo | | editar_arquivo | Edita um trecho do arquivo | | apagar_arquivo | Apaga um arquivo | | criar_pasta | Cria diretórios | | mover_arquivo | Move/renomeia arquivos | | copiar_arquivo | Copia arquivos |

⚡ Execução e Sistema

| Tool | O que faz | |--------------------|---------------------------------------------| | executar_comando | Roda comandos no terminal | | obter_info_sistema | Informações do PC (SO, RAM, CPU) | | listar_processos | Lista processos em execução | | download_arquivo | Faz download de arquivos | | abrir_programa | Abre programas no sistema |

🔍 Desenvolvimento

| Tool | O que faz | |--------------------|---------------------------------------------| | buscar_codigo | Busca texto/regex em arquivos | | info_projeto | Mostra estrutura e info do projeto | | git_comando | Executa comandos Git | | gerar_codigo | Gera código em qualquer linguagem | | explicar_codigo | Explica código linha por linha | | depurar_codigo | Encontra erros e sugere correções |

🌐 Web

| Tool | O que faz | |--------------------|---------------------------------------------| | buscar_web | Busca informações na web | | ler_url | Lê conteúdo de páginas web |

🚀 Capacidades do Agente

✅ Acesso total ao sistema — navegue em qualquer pasta ✅ 21 tools poderosas — manipulate arquivos, execute comandos, acesse a web ✅ Geração de código — gere código em qualquer linguagem ✅ Explicação de código — entenda qualquer trecho de código ✅ Depuração — encontre e corrija erros ✅ Gerenciamento de Git — commits, pushes, pulls ✅ Download de arquivos — baixe qualquer coisa da web ✅ Informações do sistema — veja specs do seu PC

💡 Exemplos de uso

💻 >> Liste os arquivos da minha Área de Trabalho
💻 >> Crie uma pasta chamada "meu-projeto" no Desktop
💻 >> Gere um script Python que baixe vídeos do YouTube
💻 >> Explique o que este código faz: [código]
💻 >> Depure este código com erro: [código]
💻 >> Execute git status no projeto
💻 >> Baixe este arquivo: https://exemplo.com/arquivo.zip
💻 >> Leia esta página web: https://docs.nodejs.org

📁 Estrutura do projeto

ia vitor/
├── .env              # Configurações (API key, modelo)
├── .gitignore
├── .npmignore
├── index.js          # 🤖 Agente principal (v2.0)
├── index.js.backup   # Backup do código original
├── memoria.json      # 🧠 Memória da conversa
├── package.json      # name: zephron, bin: znia
├── README.md
└── start.bat         # Atalho rápido

🔧 Configurações

Global (qualquer PC após npm install -g zephron)

O ZEPHYRON cria automaticamente ~/.ivitoria/.env na primeira execução:

OPENAI_API_KEY=sua_chave_api_aqui
BASE_URL=https://inference.poolside.ai/v1
MODEL=poolside/laguna-xs-2.1
TEMPERATURE=0.2
MAX_ITERATIONS=15

Local (pasta do projeto)

Copie e ajuste .env na pasta do projeto (tem prioridade sobre o global):

OPENAI_API_KEY=sua_chave_api_aqui
BASE_URL=https://inference.poolside.ai/v1
MODEL=poolside/laguna-xs-2.1
TEMPERATURE=0.2
MAX_ITERATIONS=15

Modelos suportados

| Provedor | Modelo | Velocidade | Observação | |-----------|---------------------------------|------------|-----------------------------------| | Pool | poolside/laguna-xs-2.1 | ⚡ Rápido | Recomendado — leve e eficiente | | Pool | poolside/laguna-s-2.1 | 🐢 Mais lento | Modelo maior, mais potente | | NVIDIA| meta/llama-3.1-70b-instruct | ⚡ Rápido | Requer conta NVIDIA NIM |

📋 Changelog v2.0.1

• ✅ Adicionada tool "ler_atalho" para ler atalhos .lnk do Windows

📋 Changelog v2.0

• ✅ Adicionadas 13 novas tools (total: 21)
• ✅ Melhorado o system prompt para respostas mais inteligentes
• ✅ Acesso total ao sistema com caminhos absolutos
• ✅ Novas funcionalidades: gerar código, explicar código, depurar
• ✅ Informações do sistema e processos
• ✅ Download de arquivos e leitura de URLs
• ✅ Gerenciamento de Git integrado
• ✅ Backup automático do código original

Feito com 💙 por Vitor.