{"id":27029944,"url":"https://github.com/carlolepelaars/flocky","last_synced_at":"2026-02-11T03:02:45.072Z","repository":{"id":285587041,"uuid":"956656341","full_name":"CarloLepelaars/flocky","owner":"CarloLepelaars","description":"Simple (Unofficial) SDK for Flock.io","archived":false,"fork":false,"pushed_at":"2025-04-01T15:36:36.000Z","size":389,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-01T15:54:56.507Z","etag":null,"topics":["api","flock","huggingface","llms","web3"],"latest_commit_sha":null,"homepage":"https://carlolepelaars.github.io/flocky/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CarloLepelaars.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":"2025-03-28T16:17:41.000Z","updated_at":"2025-04-01T15:35:32.000Z","dependencies_parsed_at":"2025-04-01T15:55:02.567Z","dependency_job_id":"5d342209-3db4-4134-8520-b89ab1bd4d90","html_url":"https://github.com/CarloLepelaars/flocky","commit_stats":null,"previous_names":["carlolepelaars/flocky"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarloLepelaars%2Fflocky","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarloLepelaars%2Fflocky/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarloLepelaars%2Fflocky/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarloLepelaars%2Fflocky/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CarloLepelaars","download_url":"https://codeload.github.com/CarloLepelaars/flocky/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247270355,"owners_count":20911508,"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":["api","flock","huggingface","llms","web3"],"created_at":"2025-04-05T00:28:51.792Z","updated_at":"2026-02-11T03:02:40.039Z","avatar_url":"https://github.com/CarloLepelaars.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flocky\n\n\n\u003c!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! --\u003e\n\n`flocky` makes participating in [Flock.io](https://www.flock.io) easy!\n\n**NOTE:** This project is not officially affiliated with Flock.io. This\npackage is maintained by a participant of the Flock.io community. While\nI strive for correctness, I cannot guarantee that this package is\nbug-free. Always verify your own implementation, especially when using\n`flocky` in production.\n\n## Installation\n\n    pip install flocky\n\n## Quickstart\n\n### Get specific task\n\nData can be retrieved as JSON or a Pandas DataFrame.\n\n``` python\nfrom flocky.api import get_task\n\nget_task(7, as_df=False)\n```\n\n    {'title': 'FLock x OneKey: Advancing AI-Driven Smart Contract Security',\n     'description': 'FLock and OneKey are collaborating to launch the first AI-driven smart contract security challenge, combining FLock’s decentralized model training with OneKey’s expertise in blockchain security. By training AI on real-world vulnerabilities and security Q\u0026A data, we aim to build a benchmark dataset and develop models capable of detecting and mitigating risks at scale. Top contributors will be rewarded with OneKey Hardware Wallet - FLock Limited Edition',\n     'task_type': 'training',\n     'data': {'training_set_url': 'https://fed-ledger-prod-dataset.s3.amazonaws.com/7/training_set.jsonl?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=AKIASSFQ745NLT5K57N2%2F20250401%2Fus-east-2%2Fs3%2Faws4_request\u0026X-Amz-Date=20250401T153446Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=fc9d7016681513e23a87fe9c30e5e7139ee53b76e3a8ef78a3cd02248d75494c',\n      'max_params': 15000000000,\n      'context_length': 8192},\n     'duration_in_seconds': 2419200,\n     'id': 7,\n     'status': 'submission_phase',\n     'initialized_at': '2025-03-26T16:22:01.791348',\n     'submission_phase_ends_at': '2025-04-23T23:59:59.791348',\n     'final_validation_ends_at': '2025-04-28T23:59:59.791348',\n     'final_link': None}\n\n``` python\nget_task(7, as_df=True)\n```\n\n\u003cdiv\u003e\n\u003cstyle scoped\u003e\n    .dataframe tbody tr th:only-of-type {\n        vertical-align: middle;\n    }\n\u0026#10;    .dataframe tbody tr th {\n        vertical-align: top;\n    }\n\u0026#10;    .dataframe thead th {\n        text-align: right;\n    }\n\u003c/style\u003e\n\n|  | title | description | task_type | duration_in_seconds | id | status | initialized_at | submission_phase_ends_at | final_validation_ends_at | final_link | data_training_set_url | data_max_params | data_context_length |\n|----|----|----|----|----|----|----|----|----|----|----|----|----|----|\n| 0 | FLock x OneKey: Advancing AI-Driven Smart Cont... | FLock and OneKey are collaborating to launch t... | training | 2419200 | 7 | submission_phase | 2025-03-26T16:22:01.791348 | 2025-04-23T23:59:59.791348 | 2025-04-28T23:59:59.791348 | None | https://fed-ledger-prod-dataset.s3.amazonaws.c... | 15000000000 | 8192 |\n\n\u003c/div\u003e\n\n### Get open tasks\n\n``` python\nfrom flocky.api import open_tasks\n\ntasks = open_tasks(as_df=True)\ntasks\n```\n\n\u003cdiv\u003e\n\u003cstyle scoped\u003e\n    .dataframe tbody tr th:only-of-type {\n        vertical-align: middle;\n    }\n\u0026#10;    .dataframe tbody tr th {\n        vertical-align: top;\n    }\n\u0026#10;    .dataframe thead th {\n        text-align: right;\n    }\n\u003c/style\u003e\n\n|  | title | description | task_type | duration_in_seconds | id | status | initialized_at | submission_phase_ends_at | final_validation_ends_at | data_recommended_vram | data_dataset_s3_key | data_max_params | data_context_length | data_training_set_key | data_validation_set_key | data_final_validation_set_key |\n|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|\n| 0 | FLock x OneKey: Advancing AI-Driven Smart Cont... | FLock and OneKey are collaborating to launch t... | training | 2419200 | 7 | submission_phase | 2025-03-26T16:22:01.791348 | 2025-04-23T23:59:59.791348 | 2025-04-28T23:59:59.791348 | 48GB | onekey-security/combined.jsonl | 15000000000 | 8192 | 7/training_set.jsonl | 7/validation_set.jsonl | 7/final_validation_set.jsonl |\n\n\u003c/div\u003e\n\n### Get submission scores\n\n``` python\nfrom flocky.api import get_subs\n\nscores = get_subs(7, as_df=True)\nscores\n```\n\n\u003cdiv\u003e\n\u003cstyle scoped\u003e\n    .dataframe tbody tr th:only-of-type {\n        vertical-align: middle;\n    }\n\u0026#10;    .dataframe tbody tr th {\n        vertical-align: top;\n    }\n\u0026#10;    .dataframe thead th {\n        text-align: right;\n    }\n\u003c/style\u003e\n\n|  | link | submission_phase_score | final_validation_score | submitted_at |\n|----|----|----|----|----|\n| 0 | https://huggingface.co/clepelaars/task-7-Qwen-... | None | None | 2025-03-28T12:45:21.402671 |\n\n\u003c/div\u003e\n\n## Upload to HuggingFace\n\nThis function will upload the contents of the `outputs` directory to the\nHuggingFace Hub with a given repo name. This require you to have set\n`HF_TOKEN` in your environment variables.\n\n``` python\nfrom flocky.api import upload_to_hf\n# upload_to_hf(\"clepelaars/flocky-test\", output_dir=\"outputs\")\n```\n\n## Contributing to Flocky\n\nIf you would like to contribute to Flocky, first of all thank you for\nconsidering this! To get started feel free to create a Github issue so\nwe can discuss the contribution.\n\nPlease read the [contribution\nguidelines](https://github.com/CarloLepelaars/flocky/blob/master/CONTRIBUTING.MD)\nbefore submitting pull requests (PRs).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlolepelaars%2Fflocky","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarlolepelaars%2Fflocky","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlolepelaars%2Fflocky/lists"}