O MagicFridgeAI é uma API RESTful inteligente desenvolvida em Java com Spring Boot. O objetivo principal do projeto é interagir com a API do Google Gemini (através do Spring AI) para sugerir receitas criativas e deliciosas utilizando estritamente os ingredientes que você possui cadastrados no seu banco de dados.
Chega de olhar para a geladeira sem saber o que cozinhar! 🍳✨
- Geração Inteligente de Receitas: Comunicação direta com a LLM do Gemini para montar pratos baseados no seu inventário atual.
- Gerenciamento de Ingredientes: Persistência de dados para manter o controle exato do que você tem disponível.
- Arquitetura Direta: Foco total na integração com IA e regras de negócio. (Nota: Este projeto não implementa camadas de Spring Security, priorizando a simplicidade da montagem das requisições e respostas).
- Java
- Spring Boot
- Spring AI (Integração com Gemini)
- Spring Data JPA (Mapeamento Objeto-Relacional)
- Lombok (Redução de boilerplate de código, como Getters, Setters e Construtores)
- PostgreSQL / H2 (Configurável para o banco de dados da sua preferência)
Para rodar o projeto localmente, certifique-se de ter:
- Java 17+ instalado
- Maven
- Uma chave de API válida do Google AI Studio / Gemini
- Banco de Dados relacional configurado (PostgreSQL recomendado)
-
Clone o repositório:
git clone https://github.com/H4ttiz/MagicFridgeAI.git cd MagicFridgeAI -
Configure o
application.properties(ouapplication.yml): No diretóriosrc/main/resources/, ajuste as credenciais do seu banco de dados e insira sua chave da API do Gemini:# Configurações do Banco de Dados (Exemplo com PostgreSQL) spring.datasource.url=jdbc:postgresql://localhost:5432/magicfridge spring.datasource.username=seu_usuario spring.datasource.password=sua_senha spring.jpa.hibernate.ddl-auto=update # Configuração da API do Gemini via Spring AI spring.ai.vertex.ai.gemini.api-key=SUA_CHAVE_API_AQUI
-
Execute a aplicação: Utilize o Maven para iniciar o servidor Spring Boot:
mvn spring-boot:run
Sinta-se à vontade para fazer um fork do projeto, criar uma branch com suas melhorias (git checkout -b feature/minha-melhoria) e abrir um Pull Request.
Este projeto é de código aberto. Sinta-se livre para clonar, modificar e utilizar!