{"id":23702998,"url":"https://github.com/polymathuniversata/x-ea-awards","last_synced_at":"2026-04-13T13:32:29.286Z","repository":{"id":269621037,"uuid":"908013643","full_name":"polymathuniversata/X-EA-Awards","owner":"polymathuniversata","description":"🚀 A cutting-edge tool that uses social media insights to:  📊 Track engagement 📈 Analyze trends 💡 Inform award decisions. Empowering organizations to recognize top influencers and participants based on real-time interactions. 🏆","archived":false,"fork":false,"pushed_at":"2024-12-24T23:03:25.000Z","size":174,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-20T05:17:38.442Z","etag":null,"topics":["ai-assistant","east-africa","fastapi","influencer-analytics","python","react","twitter-api","typescript"],"latest_commit_sha":null,"homepage":"https://x.com/emertechlabs","language":"Python","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/polymathuniversata.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-12-24T21:44:45.000Z","updated_at":"2024-12-24T23:03:28.000Z","dependencies_parsed_at":"2024-12-24T22:24:21.646Z","dependency_job_id":"7fa0688f-ed94-4caa-b6e9-776042194ffc","html_url":"https://github.com/polymathuniversata/X-EA-Awards","commit_stats":null,"previous_names":["polymathuniversata/x-ea-awards"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polymathuniversata%2FX-EA-Awards","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polymathuniversata%2FX-EA-Awards/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polymathuniversata%2FX-EA-Awards/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polymathuniversata%2FX-EA-Awards/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/polymathuniversata","download_url":"https://codeload.github.com/polymathuniversata/X-EA-Awards/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239780144,"owners_count":19695735,"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-assistant","east-africa","fastapi","influencer-analytics","python","react","twitter-api","typescript"],"created_at":"2024-12-30T13:00:24.521Z","updated_at":"2026-01-31T03:30:20.614Z","avatar_url":"https://github.com/polymathuniversata.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# X-EA Awards 🏆\n\n\u003e A comprehensive platform for analyzing and ranking X (Twitter) accounts from East Africa based on various metrics including engagement, follower count, and AI-based ranking.\n\n\u003cdiv align=\"center\"\u003e\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg)\n![Python](https://img.shields.io/badge/python-v3.8+-blue.svg)\n![FastAPI](https://img.shields.io/badge/FastAPI-v0.104.1-green.svg)\n![React](https://img.shields.io/badge/react-v18.0.0-blue.svg)\n![TypeScript](https://img.shields.io/badge/typescript-v4.9.5-blue.svg)\n\n[![Follow on X](https://img.shields.io/twitter/follow/emertechlabs?style=social)](https://twitter.com/emertechlabs)\n[![GitHub stars](https://img.shields.io/github/stars/polymathuniversata/X-EA-Awards?style=social)](https://github.com/polymathuniversata/X-EA-Awards/stargazers)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cp\u003e\n        \u003ca href=\"https://twitter.com/emertechlabs\"\u003e\n            \u003cimg src=\"https://img.shields.io/badge/Powered_by-EmerTech_Labs-1da1f2?style=for-the-badge\u0026logo=twitter\u0026logoColor=white\" alt=\"Powered by EmerTech Labs\" /\u003e\n        \u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents\n\n- [Features](#-features)\n- [Tech Stack](#-tech-stack)\n- [Installation](#-installation)\n- [API Documentation](#-api-documentation)\n- [Influencer Categories](#-influencer-categories)\n- [Development](#-development)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n## ✨ Features\n\n### 🔹 Backend Features\n- **AI-Powered Analysis**\n  - Advanced account ranking using machine learning\n  - Multi-metric evaluation system\n  - Intelligent engagement scoring\n\n- **Regional Focus**\n  - Specialized for East African countries\n  - Location verification system\n  - Country-specific insights\n\n- **Performance Metrics**\n  - Engagement rate tracking\n  - Posting intensity analysis\n  - Thread creation monitoring\n  - Follower growth patterns\n\n- **Technical Features**\n  - Rate limit handling with progress indicators\n  - Results caching for better performance\n  - Data export in multiple formats (CSV/JSON)\n\n### 🔸 Frontend Features\n- **Modern UI/UX**\n  - Clean, responsive design\n  - Dark/Light mode support\n  - Real-time updates\n\n- **Interactive Components**\n  - Dynamic dashboard\n  - Sortable leaderboards\n  - Advanced search interface\n  - Data visualization with Chart.js\n\n## 🛠 Tech Stack\n\n### Backend Infrastructure\n```\nPython 3.8+ │ FastAPI │ Tweepy v2 │ Pandas │ Scikit-learn\n```\n\n### Frontend Framework\n```\nReact 18 │ TypeScript │ Tailwind CSS │ HeadlessUI │ Chart.js │ Axios\n```\n\n## 🚀 Installation\n\n### Backend Setup\n\n1. **Clone and Navigate**\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd Xbot\n   ```\n\n2. **Install Dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Configure Environment**\n   ```bash\n   # Create .env file in project root\n   touch .env\n\n   # Add your X API credentials\n   API_KEY=your_api_key\n   API_KEY_SECRET=your_api_key_secret\n   BEARER_TOKEN=your_bearer_token\n   ACCESS_TOKEN=your_access_token\n   ACCESS_TOKEN_SECRET=your_access_token_secret\n   ```\n\n4. **Launch Server**\n   ```bash\n   python run_api.py\n   # API available at http://localhost:8000\n   ```\n\n### Frontend Setup\n\n1. **Navigate to Frontend**\n   ```bash\n   cd frontend\n   ```\n\n2. **Install Dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Start Development Server**\n   ```bash\n   npm start\n   # Frontend available at http://localhost:3000\n   ```\n\n## 📚 API Documentation\n\n### Core Endpoints\n\n| Endpoint | Description | Method |\n|----------|-------------|--------|\n| `/` | Health check | GET |\n| `/search` | Account search with filters | GET |\n| `/leaderboard/{category}` | Category-based rankings | GET |\n| `/dashboard/stats` | Analytics \u0026 statistics | GET |\n| `/countries` | Supported countries list | GET |\n| `/categories` | Influencer categories | GET |\n\n### Search Parameters\n\n| Parameter | Type | Description | Required |\n|-----------|------|-------------|-----------|\n| `topic` | string | Search keyword | Yes |\n| `country` | string | Country filter | No |\n| `category` | string | Influencer category | No |\n| `min_followers` | integer | Minimum followers | No |\n| `min_engagement` | float | Minimum engagement rate | No |\n| `sort_by` | string | Sort parameter | No |\n| `page` | integer | Page number | No |\n| `limit` | integer | Results per page | No |\n\n## 👥 Influencer Categories\n\n### Nano Influencers (1K - 10K followers)\n- High engagement rates\n- Niche market focus\n- Strong community interaction\n\n### Micro Influencers (10K - 100K followers)\n- Balanced reach and engagement\n- Growing authority\n- Active community management\n\n### Macro Influencers (100K+ followers)\n- Extensive reach\n- Established authority\n- Broad market influence\n\n## 💻 Development\n\n### Testing\n```bash\n# Run backend tests\npython -m pytest\n\n# Run frontend tests\ncd frontend \u0026\u0026 npm test\n```\n\n### Production Build\n```bash\n# Build frontend\ncd frontend \u0026\u0026 npm run build\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n1. Fork the repository\n2. Create your feature branch\n   ```bash\n   git checkout -b feature/AmazingFeature\n   ```\n3. Commit your changes\n   ```bash\n   git commit -m 'Add some AmazingFeature'\n   ```\n4. Push to the branch\n   ```bash\n   git push origin feature/AmazingFeature\n   ```\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003cp\u003eDeveloped by \u003ca href=\"https://github.com/polymathuniversata\"\u003ePolymath Universata\u003c/a\u003e\u003c/p\u003e\n\u003cp\u003ePowered by \u003ca href=\"https://twitter.com/emertechlabs\"\u003eEmerTech Labs\u003c/a\u003e 🚀\u003c/p\u003e\n\u003cp\u003eMade with ❤️ in Tanzania\u003c/p\u003e\n\u003c/div\u003e ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolymathuniversata%2Fx-ea-awards","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpolymathuniversata%2Fx-ea-awards","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolymathuniversata%2Fx-ea-awards/lists"}