{"id":26851710,"url":"https://github.com/hum2a/doppelgang-car","last_synced_at":"2026-04-11T17:36:40.256Z","repository":{"id":283727452,"uuid":"923838922","full_name":"Hum2a/Doppelgang-Car","owner":"Hum2a","description":"A fun web application that analyzes your facial features and determines which car you resemble most.","archived":false,"fork":false,"pushed_at":"2025-03-21T19:34:52.000Z","size":554,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-21T20:28:49.707Z","etag":null,"topics":["css","deepface","flask","ninjas-cars-api","nuxt","opencv","python","vue"],"latest_commit_sha":null,"homepage":"https://doppelgang-car.vercel.app","language":"Jupyter Notebook","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/Hum2a.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":"2025-01-28T22:57:06.000Z","updated_at":"2025-03-21T19:34:55.000Z","dependencies_parsed_at":"2025-03-21T20:39:34.036Z","dependency_job_id":null,"html_url":"https://github.com/Hum2a/Doppelgang-Car","commit_stats":null,"previous_names":["hum2a/doppelgang-car"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FDoppelgang-Car","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FDoppelgang-Car/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FDoppelgang-Car/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FDoppelgang-Car/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hum2a","download_url":"https://codeload.github.com/Hum2a/Doppelgang-Car/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246390877,"owners_count":20769476,"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":["css","deepface","flask","ninjas-cars-api","nuxt","opencv","python","vue"],"created_at":"2025-03-30T22:33:16.452Z","updated_at":"2026-04-11T17:36:40.215Z","avatar_url":"https://github.com/Hum2a.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DoppelGang-Car\n\nA fun web application that analyzes your facial features and determines which car you resemble most.\n\n## 📝 Project Overview\n\nDoppelGang-Car uses AI-powered facial recognition to analyze your photos and match your features to a car that best represents your personality. The application consists of:\n\n- **Frontend**: Nuxt.js web application with responsive design\n- **Backend**: Flask REST API with facial analysis capabilities\n- **AI Engine**: Utilizes DeepFace framework for facial attribute extraction\n\n## 🛠️ Technology Stack\n\n### Frontend\n- **Framework**: Nuxt.js 3.x / Vue.js\n- **Styling**: CSS with custom styling\n- **HTTP Client**: Native fetch API\n\n### Backend\n- **Framework**: Flask (Python)\n- **Facial Analysis**: DeepFace\n- **Image Processing**: OpenCV\n- **API Integration**: API Ninjas Cars API\n\n## 🚀 Setup Instructions\n\n### Prerequisites\n- Node.js (v16+)\n- Python (v3.8+)\n- Redis (optional, for caching)\n\n### Environment Variables Setup\n\n1. For the backend, create or modify the `.env` file in the `server` directory:\n```\nAPI_KEY=your_api_ninjas_key\nBASE_URL=https://api.api-ninjas.com/v1/cars\nUNSPLASH_ACCESS_KEY=your_unsplash_api_key\n```\n\nYou'll need to sign up for free API keys at:\n- [API Ninjas](https://api-ninjas.com/api/cars) for car data\n- [Unsplash API](https://unsplash.com/developers) for car images (optional)\n\n2. For the frontend, create a `.env` file in the `client` directory if additional environment variables are needed.\n\n### Backend Setup\n\n1. Navigate to the server directory:\n```bash\ncd server\n```\n\n2. Create and activate a virtual environment:\n```bash\npython -m venv venv\n# Windows\nvenv\\Scripts\\activate\n# macOS/Linux\nsource venv/bin/activate\n```\n\n3. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n4. Run the server:\n```bash\npython app.py\n```\nThe server will start at http://127.0.0.1:5000\n\n### Frontend Setup\n\n1. Navigate to the client directory:\n```bash\ncd client\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Run the development server:\n```bash\nnpm run dev\n```\nThe application will be available at http://localhost:3000\n\n## 📋 How It Works\n\n1. Upload a photo containing your face\n2. The backend processes the image using DeepFace to extract facial attributes:\n   - Age\n   - Gender\n   - Dominant emotion\n3. These attributes are mapped to car characteristics\n4. The application matches you with a car that best represents you\n5. Details about the matched car are displayed on the screen\n\n## 🚀 Deployment\n\n### Local Development\n- Frontend: Runs on http://localhost:3000\n- Backend: Runs on http://localhost:5000\n\n### Cloud Deployment\nWhen deploying to cloud platforms like Render, Heroku, or AWS:\n\n1. The backend automatically binds to `0.0.0.0` and uses the `PORT` environment variable provided by the platform\n2. Make sure to set all required environment variables on your deployment platform:\n   - `API_KEY` - Your API Ninjas key\n   - `UNSPLASH_ACCESS_KEY` - Your Unsplash API key (optional)\n   - Any other configuration variables your deployment requires\n\n3. For the frontend, update the API endpoint URL to point to your deployed backend:\n   ```\n   NUXT_PUBLIC_API_URL=https://your-backend-url.com\n   ```\n\n### Troubleshooting Deployment\n- Ensure all environment variables are properly set\n- Check that the application is binding to the correct host and port\n- Verify that CORS is properly configured for your production domains\n\n## 🔍 API Endpoints\n\n### POST /process-photo\nProcesses an uploaded photo and returns car match information.\n\n**Request Body:**\n- `file`: The image file to be processed (multipart/form-data)\n\n**Response:**\n```json\n{\n  \"car\": {\n    \"make\": \"Tesla\",\n    \"model\": \"Model 3\",\n    \"year\": 2023,\n    \"image_url\": \"https://example.com/car-image.jpg\"\n  }\n}\n```\n\n## 🧩 Project Structure\n\n```\nproject-root/\n├── client/               # Frontend Nuxt.js application\n│   ├── components/       # Reusable Vue components\n│   ├── layouts/          # Page layouts\n│   ├── pages/            # Application pages\n│   ├── public/           # Static assets\n│   └── styles/           # Global CSS styles\n│\n├── server/               # Backend Flask application\n│   ├── app.py            # Main application file\n│   ├── requirements.txt  # Python dependencies\n│   └── uploads/          # Directory for uploaded images\n```\n\n## 🔒 Privacy Notice\n\nAll uploaded photos are processed locally and are not permanently stored. Images are temporarily saved for processing and are removed after analysis is complete.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 👥 Contributors\n\n- [Your Name] - Initial work ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhum2a%2Fdoppelgang-car","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhum2a%2Fdoppelgang-car","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhum2a%2Fdoppelgang-car/lists"}