ai-pipeline-tool 0.1.2

A generic AI-powered CLI tool to automatically generate CI/CD pipelines.

AI Pipeline Tool

AI Pipeline Tool é uma ferramenta de linha de comando (CLI) desenvolvida em Python para automação de processos de DevOps. A ferramenta analisa o código-fonte de um repositório, identifica a pilha tecnológica (stack) e utiliza interfaces de inteligência artificial para gerar arquivos de configuração de CI/CD (GitHub Actions).

Funcionalidades

• Escaneamento de Repositório: Localização de arquivos de configuração padrão (package.json, requirements.txt, Dockerfile, terraform, etc).
• Detecção de Stack: Identificação de linguagem de programação, versões, frameworks de teste e ferramentas de segurança.
• Gerador de Pipeline: Geração automatizada de workflows do GitHub Actions (.github/workflows/ci.yml) baseada nos dados detectados.
• Multi-Provedor: Suporte a diversos provedores de IA através de detecção automática de chaves de ambiente.
• Seleção Interativa: Interface numerada para seleção de chaves quando múltiplas opções são detectadas no ambiente.

Arquitetura do Processo

1. Scan: O sistema varre o diretório atual em busca de marcadores tecnológicos.
2. Analysis: O motor de detecção extrai metadados como versões de motores (ex: Node v18) e scripts de execução.
3. Prompt Engineering: Os metadados são estruturados em um prompt técnico enviado ao provedor de IA selecionado.
4. Generation: O YAML retornado é validado e persistido no diretório .github/workflows/.

Instalação

A instalação pode ser feita diretamente via pip:

pip install ai-pipeline-tool

Configuração

A ferramenta busca automaticamente por chaves de API no ambiente (exportadas no shell ou em arquivos .env).

Para configurar uma chave manualmente ou definir uma padrão para o diretório atual:

ai-pipeline-tool init

Uso

Analisar Projeto

Para verificar o que a ferramenta detecta sem gerar arquivos:

ai-pipeline-tool analyze

Gerar Workflow de CI/CD

Para executar o fluxo completo de detecção e geração do arquivo de pipeline:

ai-pipeline-tool generate

Requisitos Técnicos

• Python 3.11 ou superior
• Bibliotecas: typer, pydantic, pyyaml, rich, requests, python-dotenv
• Acesso a uma API de IA compatível com o padrão de mercado (OpenAI, OpenRouter, Groq, etc)

Logs

Todas as operações, incluindo payloads de API e erros de autenticação, são registrados no arquivo ai-pipeline-tool.log na raiz de execução para fins de depuração.

Licença

MIT