{"id":19023143,"url":"https://github.com/a3ro-dev/eroji","last_synced_at":"2026-05-09T19:35:57.069Z","repository":{"id":151779014,"uuid":"624804262","full_name":"a3ro-dev/eroji","owner":"a3ro-dev","description":" Eroji is a simple Python script that uses the DeepFace library to detect faces in an image and recognize the emotions, gender and race of the detected faces.","archived":false,"fork":false,"pushed_at":"2023-04-07T12:35:46.000Z","size":137,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-02T01:19:24.154Z","etag":null,"topics":["ai","cascade-classifier","deep-learning","deepface","emotion-detection","emotion-recognition","machine-learning","machine-learning-python","ml","opencv","opencv-python","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","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/a3ro-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2023-04-07T09:47:18.000Z","updated_at":"2023-04-07T12:33:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"c2a58a29-d89f-4882-8f62-eade1b29bf96","html_url":"https://github.com/a3ro-dev/eroji","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2Feroji","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2Feroji/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2Feroji/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2Feroji/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a3ro-dev","download_url":"https://codeload.github.com/a3ro-dev/eroji/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240072072,"owners_count":19743527,"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":["ai","cascade-classifier","deep-learning","deepface","emotion-detection","emotion-recognition","machine-learning","machine-learning-python","ml","opencv","opencv-python","python","python3"],"created_at":"2024-11-08T20:28:52.329Z","updated_at":"2026-05-09T19:35:57.064Z","avatar_url":"https://github.com/a3ro-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎭 Eroji - AI Face Analysis App\r\n\r\n## Overview\r\n\r\nEroji is an elegant, modern web application that leverages OpenAI's GPT-4.1 Vision capabilities to provide detailed face analysis from uploaded images. The app features a polished, responsive UI built with Streamlit and custom CSS styling.\r\n\r\n## ✨ Key Features\r\n\r\n### 🧠 Powered by GPT-4.1 Vision\r\n- **No dependencies on traditional computer vision libraries** (OpenCV, DeepFace, etc.)\r\n- **State-of-the-art analysis** leveraging GPT-4.1's powerful vision capabilities\r\n- **JSON-structured responses** for consistent data handling\r\n\r\n### 📊 Comprehensive Face Analysis\r\n- **Primary and secondary emotions** with confidence scores\r\n- **Emotional intensity** and expression details\r\n- **Age estimation** with confidence ranges\r\n- **Gender perception** with confidence metrics\r\n- **Ethnicity/race perception** (when detectable)\r\n- **Facial attributes** (hair, facial hair, glasses, accessories)\r\n- **Pose and positioning** analysis\r\n- **Face quality metrics** (visibility, lighting)\r\n\r\n### 🎨 Modern UI/UX\r\n- **Clean, polished interface** with custom styling\r\n- **Dark/Light theme support** via Streamlit's theme toggle\r\n- **Responsive design** that works on various screen sizes\r\n- **Interactive elements** with visual feedback\r\n- **Progress indicators** during analysis\r\n- **Detailed result cards** with organized metrics\r\n- **Raw JSON data access** for developers\r\n\r\n### 👥 Multi-Face Support\r\n- **Handles multiple faces** in a single image\r\n- **Individual analysis** for each detected face\r\n- **Numerical identification** to distinguish between faces\r\n\r\n## 🚀 Getting Started\r\n\r\n### Prerequisites\r\n- Python 3.8+\r\n- OpenAI API key with GPT-4.1 Vision access\r\n\r\n### Installation\r\n\r\n1. **Clone the repository:**\r\n   ```bash\r\n   git clone https://github.com/a3ro-dev/eroji.git\r\n   cd eroji\r\n   ```\r\n\r\n2. **Set up a virtual environment (recommended):**\r\n   ```bash\r\n   python -m venv .venv\r\n   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\r\n   ```\r\n\r\n3. **Install dependencies:**\r\n   ```bash\r\n   pip install -r requirements.txt\r\n   ```\r\n\r\n4. **Configure your OpenAI API key:**\r\n   - Create a `.streamlit/secrets.toml` file with:\r\n     ```toml\r\n     OPENAI_API_KEY = \"sk-your-api-key-here\"\r\n     ```\r\n   - Or set it as an environment variable:\r\n     ```bash\r\n     export OPENAI_API_KEY=sk-your-api-key-here\r\n     ```\r\n\r\n### Running the App\r\n\r\n```bash\r\nstreamlit run app.py\r\n```\r\n\r\nThe app will be accessible at `http://localhost:8501` in your web browser.\r\n- **Static Image Analysis** - Analyze any image file\r\n- **Interactive Menu** - User-friendly navigation\r\n\r\n## 📄 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.\r\n\r\n## 🤝 Contributing\r\n\r\nContributions are welcome! Please feel free to submit issues, feature requests, or pull requests to the [GitHub repository](https://github.com/a3ro-dev/eroji).\r\n\r\n---\r\n\r\n**Made with ❤️ by [a3ro-dev](https://github.com/a3ro-dev)**\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa3ro-dev%2Feroji","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa3ro-dev%2Feroji","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa3ro-dev%2Feroji/lists"}