Skip to content

rejanegallotti/AItem_PetCare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐾 AI tem PetCare? 🐾

AI tem PetCare Banner

AI Agent System for Pet Care

GitHub license Python version Google Gemini Google ADK

This project implements an interactive AI agent system focused on assisting pet guardians with basic care. Utilizing Google Gemini as the language model and the Google Agent Development Kit (ADK) for agent orchestration, the system offers preliminary guidance in essential areas of animal well-being.

✨ Features

The "AI tem PetCare?" system is composed of specialized agents that can help with:

  1. Primary Health Diagnosis: Assessment of common symptoms, identification of warning signs, and recommendations on when to seek veterinary care.
  2. Home Training: Practical tips and step-by-step guides for teaching basic commands and handling common behaviors, with a focus on positive reinforcement.
  3. Natural Diet Guidance: Information on safe and dangerous foods, and general principles for a natural and balanced diet (always with the caveat about the need for a veterinary nutritionist).

🧠 Architecture

The project uses the Google ADK agent architecture, where different agents with specific roles and instructions collaborate (indirectly, in this case, through the main flow) to process user requests. The google_search tool is integrated into some agents to allow searching for external information when necessary.

  • agente_saude (Health Agent): Specialist in symptoms and veterinary triage.
  • agente_dieta (Diet Agent): Consultant on nutrition and food safety.
  • agente_treinamento (Training Agent): Focused on positive reinforcement training techniques.
  • agente_revisor (Reviewer Agent): Ensures the safety and clarity of the responses generated by other agents.
  • root_agent: Entry point for interfaces expecting a root agent.

🚀 How to Run

To run the "AI tem PetCare?" system locally, follow the steps below:

  1. Clone the repository:

    git clone [https://github.com/rejanegallotti/AItem_PetCare.git](https://github.com/rejanegallotti/AItem_PetCare.git)
    cd AItem_PetCare
  2. Create and activate a virtual environment (recommended):

    python -m venv venv
    # On Windows (Git Bash/CMD):
    source venv/Scripts/activate
    # On Linux/macOS:
    source venv/bin/activate
  3. Install dependencies:

    pip install -r requirements.txt
    # Or manually:
    # pip install google-genai google-adk python-dotenv
  4. Configure your Google Gemini API Key: Obtain your API key from Google AI Studio. Create a file in the project root called .env and add your key:

    GOOGLE_API_KEY="YOUR_API_KEY_HERE"

    Do not share this file and add it to your .gitignore!

  5. Execute the system:

    python petcare_agents/agent.py

    The interactive system will start in your terminal.

🤝 Contribution

Contributions are welcome! Feel free to open issues for suggestions or bug reports, or submit Pull Requests with improvements.

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.


Developed by Rejane Menezes Reis Gallotti

About

Projeto Criação de um Agente de IA - Imersão Alura

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages