agent-flow-craft 2025.4.1.dev502163

Framework para automação de fluxo de criação de features usando agentes de IA

Agent Flow Craft

Framework para automação de fluxo de criação de features usando agentes de IA.

Instalação

Instalação Rápida

# Clonar o repositório
git clone https://github.com/seu-usuario/agent-flow-craft.git
cd agent-flow-craft

# Criar ambiente virtual e instalar dependências
make install

# Para desenvolvimento, instalar dependências adicionais
make setup

Configuração

1. Copie o arquivo .env.example para .env:

cp .env.example .env

2. Configure as variáveis de ambiente no arquivo .env:

# Chaves de API
OPENAI_API_KEY=sua-chave-openai
OPENROUTER_API_KEY=sua-chave-openrouter
GOOGLE_API_KEY=sua-chave-google
GITHUB_TOKEN=seu-token-github

# Configurações de Modelos
DEFAULT_MODEL=gpt-4-turbo-preview
ELEVATION_MODEL=gpt-4-turbo-preview
FALLBACK_MODEL=claude-3-sonnet

Uso

O pacote oferece vários comandos para automação de tarefas:

# Criar uma nova feature
agent-flow-craft feature --name "nome-da-feature" --description "descrição da feature"

# Gerar conceitos
agent-flow-craft concept --name "nome-do-conceito"

# Validar plano
agent-flow-craft validate --plan "plano-a-validar"

# Integração com GitHub
agent-flow-craft github --repo "usuario/repositorio"

# Gerar critérios TDD
agent-flow-craft tdd --feature "nome-da-feature"

# Verificar status do sistema
agent-flow-craft status

Desenvolvimento

Para contribuir com o projeto:

# Instalar dependências de desenvolvimento
make setup

# Formatar código
make format

# Verificar código
make lint

# Executar testes
make test

# Limpar arquivos gerados
make clean

Modelos Suportados

O framework suporta os seguintes provedores de modelos:

• OpenAI (GPT-4, GPT-3.5)
• OpenRouter (Claude, Mistral, etc)
• Google (Gemini)

O sistema possui um mecanismo de fallback que alterna automaticamente entre modelos em caso de falhas ou limites de quota.

Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.