{"id":15165763,"url":"https://github.com/ilyaselmabrouki/pet_pulse","last_synced_at":"2026-01-21T04:05:34.829Z","repository":{"id":250021658,"uuid":"833260065","full_name":"IlyasElMabrouki/Pet_Pulse","owner":"IlyasElMabrouki","description":"Platform for reporting, searching, and adopting pets","archived":false,"fork":false,"pushed_at":"2024-07-24T17:42:18.000Z","size":16438,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T15:16:57.870Z","etag":null,"topics":["angular","aws-s3","llama2","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IlyasElMabrouki.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-24T17:09:54.000Z","updated_at":"2024-07-24T17:49:38.000Z","dependencies_parsed_at":"2024-07-24T19:54:49.202Z","dependency_job_id":null,"html_url":"https://github.com/IlyasElMabrouki/Pet_Pulse","commit_stats":null,"previous_names":["ilyaselmabrouki/pet_pulse"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlyasElMabrouki%2FPet_Pulse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlyasElMabrouki%2FPet_Pulse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlyasElMabrouki%2FPet_Pulse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IlyasElMabrouki%2FPet_Pulse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IlyasElMabrouki","download_url":"https://codeload.github.com/IlyasElMabrouki/Pet_Pulse/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247867365,"owners_count":21009240,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","aws-s3","llama2","spring-boot"],"created_at":"2024-09-27T04:01:43.617Z","updated_at":"2026-01-21T04:05:34.802Z","avatar_url":"https://github.com/IlyasElMabrouki.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PetPulse\n\nPetPulse is an innovative application designed to help pet owners find their lost pets and facilitate the adoption of found animals. This application meets the needs of pet owners and individuals who have found animals, offering an efficient and accessible platform for reporting, searching, and adopting pets.\n\n## Features\n- **Report Lost and Found Pets**: Users can report lost pets and found animals with details and photos.\n- **Search Functionality**: Advanced search capabilities to help users find lost pets or adopt found animals.\n- **Chatbot Assistance**: A chatbot powered by Llama 2 to assist users in navigating the app and answering queries.\n\n## Technologies\n- **Frontend**: Angular\n- **Backend**: Spring\n- **Chatbot**: Llama 2\n\n## Installation\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/IlyasElMabrouki/Pet_Pulse\n   cd petpulse\n   ```\n\n2. **Frontend Setup**:\n   ```bash\n   cd frontend\n   npm install\n   ng serve\n   ```\n\n3. **Backend Setup**:\n   ```bash\n   cd backend\n   ./mvnw spring-boot:run\n   ```\n\n## Usage\n- Open your browser and navigate to `http://localhost:4200` to access the frontend.\n- Use the provided features to report lost or found pets, search for pets, and interact with the chatbot for assistance.\n\n## Chatbot\n\n### Prerequisites\n\nBefore you can start, make sure you have the following prerequisites installed on your system:\n\n- Python 3.6 or higher\n- Required Python packages (you can install them using pip):\n  - langchain\n  - sentence-transformers\n  - faiss\n  - PyPDF2 (for PDF document loading)\n- Llama model: `llama-2-7b-chat.ggmlv3.q8_0.bin`\n\n### Getting Started\n\nTo get started, you need to:\n\n1. **Set up your environment and install the required packages**:\n   ```bash\n   pip install langchain sentence-transformers faiss PyPDF2\n   ```\n\n2. **Prepare the language model**.\n\n3. **Create a vector database from a collection of PDF documents** using FAISS for fast similarity search and the Sentence Transformers model for generating embeddings:\n   ```bash\n   python ingest.py\n   ```\n\n4. **Start the bot by running the provided Python script** (`model.py`):\n   ```bash\n   python model.py\n   ```\n\n### Chatbot Usage\n\nTo use the bot, you can follow these steps:\n\n1. **Start the bot** by running the provided Python script:\n   ```bash\n   python model.py\n   ```\n\n2. **Send a query to the bot**.\n\n3. **The bot will provide a response** based on the information available in its database.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filyaselmabrouki%2Fpet_pulse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Filyaselmabrouki%2Fpet_pulse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filyaselmabrouki%2Fpet_pulse/lists"}