🌿 Hera - Sua Assistente de Jardinagem com IA

Obtenha respostas inteligentes para todas suas dúvidas sobre plantas, flores e jardinagem!

Como Usar a Hera

💬 Faça sua pergunta sobre plantas

Digite no terminal:

hera prom "sua pergunta sobre plantas aqui"

ou

hera prom --html "sua pergunta sobre plantas aqui"

Exemplos práticos:

hera prom "Como regar rosas corretamente?"
hera prom "Quais plantas são boas para apartamento?"
hera prom --html "Como tratar pragas em hortaliças?"

⏳ O que acontece?

1. Hera mostrará: 🤖 Analisando questão... (Pode levar alguns instantes)
2. Em segundos, você receberá uma resposta completa e especializada

Caso você tenha passado como parâmetro a flag html a resposta é convertida para formato HTML com:

Sua pergunta original destacada e Resposta formatada com marcação adequada

Um arquivo response-hera-data-atual.html é criado no diretório atual

🌟 Dicas para Melhores Respostas:

• Use aspas nas perguntas
• Seja específico em suas perguntas
• Inclua detalhes como tipo de planta, ambiente, sintomas (se aplicável)

📚 Tipos de Perguntas que Hera Pode Responder:

• ✅ Cuidados com rega e solo
• ✅ Solução de problemas (folhas amarelas, pragas, etc.)
• ✅ Melhores plantas para cada ambiente
• ✅ Dicas de cultivo e poda

💾 Adicionar uma nova planta ao banco de dados

Para adicionar informações sobre uma nova planta, digite no terminal e presione Enter:

hera add "nome da planta"

ou

hera add -c "contexto que a planta vive" -d "seus cuidados diários com a planta" -p "problema da sua planta 1" -p "problema 2" ... "nome da planta"
# ou mesmo
hera add --contexto "contexto que a planta vive" --cuidados-diarios "seus cuidados diários com a planta" --problema "problema da sua planta 1" --problema "problema 2" ... "nome da planta"

📌 Você pode adicionar quantos problemas quiser! Basta usar múltiplas flags -p ou --problema.

Exemplos práticos:

# Modo interativo (a Hera perguntará cada informação)
hera add "Suculenta"

# Modo direto com múltiplos problemas
hera add -c "Varanda ensolarada" -d "Rega a cada 15 dias" \
         -p "Folhas murchas" \
         -p "Manchas brancas" \
         -p "Crescimento lento" \
         "Cacto"

📝 O que acontece?

1. Caso você tenha passado apenas o nome da planta, a Hera irá guiá-lo através de um questionário interativo para coletar:

• Contexto de cultivo (onde a planta vive)
• Seus cuidados diários com a planta
• Problemas que sua planta possui

2. Você poderá adicionar múltiplos problemas (digite /sair para finalizar)
3. Todos os dados serão salvos no banco de dados Neo4j para serem usadas para responder futuras perguntas

Note

Caso contrário, os dados serão salvos com os valores das flags diretamente no banco de dados. Se você não passar alguma das flags a aplicação identifica automaticamente e te pergunta, de forma interativa, o valor daquela flag

💡 Dicas para melhor cadastro:

• Seja específico nos cuidados e contexto
• Liste todos os problemas que sua planta possui

🛠 Solucionar problemas de uma planta específica

Para obter soluções personalizadas para os problemas de uma planta cadastrada, digite:

hera solucionar "nome da planta"

Exemplo prático:

hera solucionar "Orquídea"

🌱 O que acontece?

1. Hera buscará no banco de dados todos os problemas registrados para a planta especificada
2. Em seguida, fornecerá um diagnóstico completo com:

• Possíveis causas dos problemas
• Soluções recomendadas
• Cuidados preventivos

💡 Dicas para melhores resultados:

• Certifique-se que a planta já foi cadastrada previamente com hera add
• Para plantas com muitos problemas, a análise pode ser mais demorada

🔧 Requisitos para Testar e Contribuir com a Versão de Desenvolvimento

🌱 Hera está em desenvolvimento constante para te ajudar cada vez melhor!

Para testar e contribuir para a Hera em fase de desenvolvimento, você precisará:

1. Lua 5.3 instalado em seu sistema
2. Ollama instalado e configurado
3. Neo4j instalado e rodando

Passos para configuração:

1. Clone o repositório
2. Navegue até a raiz do projeto e instale as dependências do projeto com:

luarocks build --only-deps

3. Crie um arquivo .env e defina as variáveis de ambiente. Ex:

NEO4J_PRINCIPAL=neo4j
NEO4J_CREDENTIAL=sua_senha_neo4j
OLLAMA_MODEL=gemma3:1b # ou qualquer outro modelo

4. Teste Hera com:

lua src/main.lua prom "sua pergunta sobre flora aqui"

🐳 Containerização

Futuramente disponilizaremos a Hera em containers Docker, o que irá:

• Simplificar a instalação e execução
• Reduzir conflitos de dependências
• Facilitar o desenvolvimento colaborativo

⚠️ Aviso Importante

As respostas são geradas por IA e devem ser consideradas como orientações gerais. Para casos críticos, consulte sempre um especialista.