Agente de Planeamento de Receitas e Refeições de IA

Um agente inteligente de planeamento de refeições construído com Agno que te ajuda a descobrir receitas, analisar nutrição, estimar custos e criar planos de refeições semanais com base nos teus ingredientes e preferências dietéticas.

Funcionalidades

🔍 Descoberta de Receitas

• Encontra receitas com base nos ingredientes disponíveis
• Suporte para restrições dietéticas (vegetariano, vegano, keto, paleo, etc.)
• Sugestões de substituição de ingredientes
• Instruções de cozedura detalhadas e tempos

📊 Análise Nutricional

• Análise nutricional abrangente por porção
• Avaliações de saúde fáceis de entender
• Acompanhamento de calorias, proteínas, hidratos de carbono e gorduras
• Análise do conteúdo de sódio e fibra

💰 Estimativa de Custos

• Estimativa de custos de supermercado para ingredientes
• Sugestões de refeições económicas
• Cálculos de custo por porção

📅 Planeamento Semanal de Refeições

• Planos de refeições equilibrados para qualquer tamanho de agregado familiar
• Acomodação de preferências dietéticas
• Otimização da lista de compras
• Planeamento consciente do orçamento

🧠 Conversas Baseadas em Sessões

• Lembra-se do contexto durante a tua sessão atual no navegador
• Preferências não são mantidas após reinício (sem armazenamento a longo prazo)

Como Começar?

1. Clona o repositório do GitHub

git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd advanced_ai_agents/single_agent_apps/ai_recipe_meal_planning_agent

2. Instala as dependências necessárias:

npm install

pip install -r requirements.txt

3. Obtém a tua chave de API da OpenAI

• Regista-te para uma conta OpenAI e obtém a tua chave de API.

4. Obtém a tua chave de API da Spoonacular

• Regista-te para uma conta Spoonacular e obtém a tua chave de API (plano gratuito ~50 pedidos/dia).

5. Cria um ficheiro .env nesta pasta

# Required
OPENAI_API_KEY=your_openai_api_key_here

# Optional but recommended for full recipe & nutrition functionality
SPOONACULAR_API_KEY=your_spoonacular_api_key_here

6. Executa a Aplicação Streamlit

Para executar a aplicação Streamlit, utiliza o seguinte comando no terminal:

streamlit run app.py

Depois de executar o comando, deves ver uma mensagem no terminal que indica que a aplicação está a ser executada. Abre o teu navegador e vai até a seguinte URL:

http://localhost:8501

Agora deves conseguir ver a aplicação em funcionamento. Explora as funcionalidades e interage com os elementos disponíveis.

streamlit run ai_recipe_meal_planning_agent.py

7. Abre o teu navegador em http://localhost:8501

Interacções Exemplares

Descoberta de Receitas:

• "Tenho frango, brócolos e arroz. O que posso fazer?"
• "Encontra-me receitas veganas com lentilhas"
• "Mostra-me ideias de jantares rápidos de 30 minutos"

Análise Nutricional:

• "Qual é o conteúdo nutricional desta receita?"
• "Esta refeição é rica em proteínas?"
• "Quantas calorias por porção?"

Planeamento de Refeições:

• "Cria um plano de refeições vegetarianas para 2 pessoas durante uma semana"
• "Preciso de um plano de refeições com baixo teor de sódio"
• "Planeia refeições económicas para uma família de 4"

Estimativa de Custos:

• "Quanto vão custar estes ingredientes?"
• "Qual é a opção mais económica?"
• "Estima os custos semanais de supermercado para este plano de refeições"

Arquitetura da Aplicação

Construído com o Agno Framework

• Agente: Agente de planeamento de refeições alimentado pelo OpenAI GPT-5 mini
• Memória: Memória de conversação para recomendações personalizadas
• Ferramentas: Ferramentas personalizadas para pesquisa e análise de receitas + pesquisa web DuckDuckGo
• Interface: Aplicação web Streamlit

Ferramentas Personalizadas

1. search_recipes(ingredients, diet_type=None) - Descoberta de receitas via Spoonacular API com instruções detalhadas
2. analyze_nutrition(recipe_name) - Análise nutricional detalhada via Spoonacular
3. estimate_costs(ingredients, servings=4) - Planeamento orçamental e estimativa de custos
4. create_meal_plan(dietary_preference="balanced", people=2, days=7, budget="moderate") - Planeamento abrangente de refeições semanais com lista de compras
5. DuckDuckGoTools - Pesquisa web para contexto adicional

Tecnologias Chave

• Agno: Framework de agente de IA
• Streamlit: Interface web e interação com o utilizador
• Spoonacular API: Dados de receitas e nutrição
• OpenAI GPT-5 mini: Compreensão e geração de linguagem natural

Personalização

Adicionando Novas Preferências Alimentares

Modifica a ferramenta search_recipes para incluir tipos de dieta adicionais suportados pela Spoonacular API.

Extensão da Base de Dados de Custos

Atualiza o dicionário ingredient_costs em estimate_grocery_costs() com preços locais.

Categorias de Refeições Personalizadas

Edita as meal_categories em create_weekly_meal_plan() para corresponder às tuas preferências.

Resolução de Problemas

Problemas com a Chave da API:

• Assegura-te de que o teu ficheiro .env está no diretório correto
• Verifica se as chaves da API são válidas e têm créditos suficientes
• Confirma o formato da chave da API (sem espaços ou aspas extras)
• Nota: Sem SPOONACULAR_API_KEY, a pesquisa de receitas e as ferramentas nutricionais irão retornar um erro; outras funcionalidades ainda irão carregar.

Pesquisa de Receitas Não Funciona:

• Verifica se a chave da API Spoonacular está configurada corretamente
• Confirma os teus limites de utilização da API (150 pedidos/dia para o nível gratuito)
• Tenta pesquisas de ingredientes mais simples

Problemas de Memória:

• O agente utiliza memória de conversação para recordar preferências
• Limpa o cache do navegador se estiveres a ter problemas persistentes
• Reinicia a aplicação para redefinir o histórico de conversação

Contribuição

Sente-te à vontade para contribuir:

• Adicionando novas fontes de receitas ou APIs
• Melhorando algoritmos de análise nutricional
• Aumentando a precisão da estimativa de custos
• Adicionando novas funcionalidades de planeamento de refeições

Licença

Este projeto é de código aberto. Por favor, verifica o repositório principal para detalhes da licença.

Suporte

Para questões e problemas:

• Consulta a secção de resolução de problemas acima
• Revê a documentação do Agno
• Abre um problema no repositório principal