{"id":21766828,"url":"https://github.com/sandy1990418/flask-celery-template","last_synced_at":"2026-05-06T23:42:32.840Z","repository":{"id":260607710,"uuid":"881792232","full_name":"sandy1990418/Flask-Celery-Template","owner":"sandy1990418","description":"A Flask-Celery integration template for distributed task processing with progress tracking and use MMMLU to evaluation example.","archived":false,"fork":false,"pushed_at":"2024-11-25T08:40:51.000Z","size":2301,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T02:21:08.362Z","etag":null,"topics":["async","celery","evalution","flask","jinja2-templates"],"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/sandy1990418.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-11-01T08:36:03.000Z","updated_at":"2024-12-04T04:35:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"a6cf6aac-0cf6-47b4-a6a9-dce3c4c49699","html_url":"https://github.com/sandy1990418/Flask-Celery-Template","commit_stats":null,"previous_names":["sandy1990418/flask-celery-template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandy1990418%2FFlask-Celery-Template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandy1990418%2FFlask-Celery-Template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandy1990418%2FFlask-Celery-Template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sandy1990418%2FFlask-Celery-Template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sandy1990418","download_url":"https://codeload.github.com/sandy1990418/Flask-Celery-Template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244744173,"owners_count":20502862,"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":["async","celery","evalution","flask","jinja2-templates"],"created_at":"2024-11-26T13:19:01.370Z","updated_at":"2026-05-06T23:42:27.810Z","avatar_url":"https://github.com/sandy1990418.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flask-Celery-System-Template\n\nA project template integrating Flask and Celery for handling asynchronous tasks and background jobs, with a focus on task progress tracking. Currently implemented with MMMLU (Massive Multitask Language Understanding) benchmark evaluation capabilities.\n\n## 🌟 Features\n\n- 🚀 Built with Flask + Celery + RabbitMQ for reliable distributed processing\n\n- 📊 Task execution tracking with detailed status updates\n\n\n## 📁 Project Structure\n\n```bash\n.\n├── src/\n│   ├── celeryflow/      # Celery task management and processing\n│   ├── models/          # Database models and operations\n│   ├── routes/          # API routes and endpoints\n│   ├── templates/       # HTML templates\n│   └── utils/           # Utility functions and helpers\n├── db/                  # Database initialization and drivers\n├── docker/              # Docker and deployment configurations\n├── app_run.py           # Flask Application python script\n├── requirements.txt     # Project dependencies\n└── config.yaml          # Application configuration\n```\n\n\n## 📦 Requirements\n\n- Python 3.8+\n\n## 🛠️ Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/flask-celery-template.git\n   cd flask-celery-template\n   ```\n\n2. Create a virtual environment:\n   ```bash\n   python3 -m venv venv\n   source venv/bin/activate  # On Windows use `venv\\Scripts\\activate`\n   ```\n\n3. Install the dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n\n\n\n\n\n## 🚀 Usage\n\n### Setting up RabbitMQ\n   ```bash\n   # Pull RabbitMQ image (first time only)\n   docker pulll rabbitmq:management\n\n   # Start RabbitMQ container\n   docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:management\n   ```\n\n### Starting the System\n   1. Start the Flask application:\n      ```bash\n      python app_run.py\n      ```\n\n   2. Start the Celery worker:\n      ```bash\n      # Start Celery worker with purge option\n      celery -A app_run.celery_app worker\n\n      # Start Flower for Celery monitoring\n      celery -A app_run.celery_app flower\n      ```\n      Celery command options explained:\n\n      `-A`: Specify the Celery app location \u003cbr\u003e\n      `-Q`: Specify which queues this worker should listen to\u003cbr\u003e\n      `-E`: Enable event tracking (logs task execution events)\u003cbr\u003e\n      `--pool=solo`: Run in single-thread mode\u003cbr\u003e\n      `--purge`: Clear all queued tasks before starting\u003cbr\u003e\n      `--loglevel=info`: Set logging level to info\u003cbr\u003e\n\n   3. Access the interfaces:\n   - Web Application: `http://localhost:5000`\n   - RabbitMQ Management: `http://localhost:15672` (default credentials: guest/guest)\n   - Flower Dashboard: `http://localhost:5555`\n\n## 🐳 Usage with Docker Compose\n\n### Quick Start\n```bash\n# Start all services\ndocker compose -f ./docker/docker-compose.yaml up\n\n# Start in detached mode\ndocker compose -f ./docker/docker-compose.yaml up -d\n```\n\n\n\n## 🙏 Acknowledgments\n\n- OpenAI for the MMMLU benchmark\n- Flask and Celery communities for their excellent frameworks\n- Claude 3.5 Sonnet for assisting with the fronted\n\n## License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsandy1990418%2Fflask-celery-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsandy1990418%2Fflask-celery-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsandy1990418%2Fflask-celery-template/lists"}