{"id":22891502,"url":"https://github.com/detalhe/vehicle-ai","last_synced_at":"2025-05-07T16:55:22.816Z","repository":{"id":243243033,"uuid":"811874646","full_name":"detalhe/vehicle-ai","owner":"detalhe","description":"Identify any vehicle using AI. Built with Node.js, Express.js, EJS, and the Google Gemini API.","archived":false,"fork":false,"pushed_at":"2024-12-13T16:07:35.000Z","size":115,"stargazers_count":61,"open_issues_count":1,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T12:05:01.122Z","etag":null,"topics":["ejs","expressjs","gemini","nodejs"],"latest_commit_sha":null,"homepage":"https://vehicle-ai.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/detalhe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-06-07T13:34:17.000Z","updated_at":"2025-03-18T13:23:08.000Z","dependencies_parsed_at":"2024-06-21T17:17:05.337Z","dependency_job_id":"86ffbc37-d525-4205-8b91-1fe89a69bbb6","html_url":"https://github.com/detalhe/vehicle-ai","commit_stats":null,"previous_names":["detalhe/vehicle-ai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detalhe%2Fvehicle-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detalhe%2Fvehicle-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detalhe%2Fvehicle-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detalhe%2Fvehicle-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/detalhe","download_url":"https://codeload.github.com/detalhe/vehicle-ai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252921953,"owners_count":21825632,"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":["ejs","expressjs","gemini","nodejs"],"created_at":"2024-12-13T22:34:02.173Z","updated_at":"2025-05-07T16:55:22.772Z","avatar_url":"https://github.com/detalhe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vehicle AI\n\n![Vehicle AI](https://img.shields.io/badge/Vehicle%20AI-v1.0.0-blue)\n![Node.js](https://img.shields.io/badge/Node.js-20.14.0-brightgreen)\n![Express](https://img.shields.io/badge/Express-4.19.2-orange)\n![@google/generative-ai](https://img.shields.io/badge/%40google%2Fgenerative--ai-0.12.0-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n\n![](https://i.ibb.co/X29RQtV/gif-Vehicle.gif)\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Project Structure](#project-structure)\n- [Dependencies](#dependencies)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Introduction\n\n**Vehicle AI** is a web app that uses Generative AI to identify any vehicle. Utilizing Google's Gemini model, it can detect a vehicle's make, model, color, and year from an image.\n\n## Features\n\n- Image upload through file selection or drag-and-drop.\n- AI-based identification of vehicle make, model, color, and year.\n- Display of car manufacturer logo (when available).\n- User-friendly interface with animations.\n- Responsive design.\n\n## Installation\n\nTo get started with Vehicle AI, follow these steps:\n\n1. **Clone the repository:**\n    ```bash\n    git clone https://github.com/detalhe/vehicle-ai.git\n    cd vehicle-ai\n    ```\n\n2. **Install dependencies:**\n    ```bash\n    npm install\n    ```\n\n3. **Set up environment variables:**\n   Create a `.env` file in the root directory and add your Google Gemini API key:\n   ```\n   GOOGLE_API_KEY=your_google_api_key\n   ```\n   To get an API key, visit [ai.google.dev](https://ai.google.dev) and follow the instructions to create a project and generate a key.\n\n4. **Run the application:**\n    ```bash\n    npm start\n    ```\n\n5. **Deploy on Vercel (Optional):**\n    Ensure you have the `vercel.json` configuration file in place and deploy using Vercel CLI:\n    ```bash\n    vercel\n    ```\n\n## Usage\n\n1. Open your browser and navigate to `http://localhost:3000`.\n2. Upload an image of a vehicle.\n3. Wait for the AI to analyze the image and display the vehicle information.\n\n## Project Structure\n\n```plaintext\nvehicle-ai/\n├── node_modules/\n├── public/\n│   ├── css/\n│   │   └── index.css\n│   ├── img/\n│   │   ├── favicon.ico\n│   │   ├── default.jpg\n│   │   └── preview.jpg\n│   └── js/\n│       └── script.js\n├── views/\n│   └── index.ejs\n├── .env\n├── index.js\n├── package.json\n├── package-lock.json\n└── vercel.json\n```\n\n- **public/**: Contains static assets such as CSS, images, and JavaScript files.\n- **views/**: Contains EJS templates for rendering HTML.\n- **index.js**: Main server file.\n- **vercel.json**: Configuration for deploying on Vercel.\n\n## Dependencies\n\nThe project relies on the following npm packages:\n\n- `@google/generative-ai`: ^0.12.0\n- `axios`: ^1.7.2\n- `dotenv`: ^16.4.5\n- `ejs`: ^3.1.10\n- `express`: ^4.19.2\n- `multer`: ^1.4.5-lts.1\n- `uuid`: ^9.0.1\n\n## Contributing\n\nContributions are welcome! :)\n\n## Acknowledgments\n\n- Thanks to [Dan Nelson](https://github.com/dangnelson) for the [car-makes-icons](https://github.com/dangnelson/car-makes-icons) repository, which provides the car manufacturer logos used in this project.\n\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdetalhe%2Fvehicle-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdetalhe%2Fvehicle-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdetalhe%2Fvehicle-ai/lists"}