BranchesTagsOpen more actions menu

Latest commit

 

History

27 Commits27 Commits

Folders and files

NameNameLast commit messageLast commit date
.github/workflows.github/workflows  
designdesign  
docsdocs  
scriptsscripts  
sync-statesync-state  
teststests  
.gitignore.gitignore  
HUMANCOIN_SCENES_V1.mdHUMANCOIN_SCENES_V1.md  
LICENSELICENSE  
README.mdREADME.md  
README_zh-CN.mdREADME_zh-CN.md  
RELEASE_CHECK.mdRELEASE_CHECK.md  
humancoin_scenes_v1.jsonhumancoin_scenes_v1.json  
package.jsonpackage.json  

Repository files navigation

HumanCOIN DataManager

Simplified Chinese · Live portal · Project introduction

HumanCOIN DataManager is a web portal for finding, previewing and downloading HumanCOIN datasets. Filter datasets, save your selection and copy ready-to-run download commands without assembling repository names by hand.

The first batch is expected to include approximately 1,200 hours of data. For access to subsequent data, contact humancoin@163.com. The portal catalog shows what is currently published.

Before downloading: request access

Visit HumanCOIN on Hugging Face, open a dataset and complete the access form shown on its page. Automatically approved datasets grant access upon submission; downloads still require authentication with the approved account.

HumanCOIN runs cross-dataset access synchronization every 5 minutes. Once approved on any public auto dataset, users receive access to the other public auto datasets without applying to each one. Scheduled runs may be delayed, and explicit rejections are preserved. Newly added datasets are included in subsequent runs.

ModelScope permissions are managed separately. Follow the requirements on the HumanCOIN ModelScope page and individual dataset pages. Hugging Face approval does not grant ModelScope access.

Download a single dataset

  1. Open the portal and find a dataset.
  2. Choose Hugging Face or ModelScope in the selection area below the results.
  3. Click Download on the dataset card and copy the generated command.
  4. Install the tool, then run the command in your terminal.

Install once with Python 3.10–3.13:

pip install -U "humancoin>=0.1.1"

This installation supports both platforms; no source checkout is required. See the HumanCOIN repository for tool documentation. For restricted datasets, sign in locally with an approved account or configure HF_TOKEN / MODELSCOPE_TOKEN in your local environment. Do not commit tokens or enter them into the portal.

Download a batch

  1. Open the portal: visit HumanCOIN-DATA. Switch English/Chinese in the top bar; dataset names and metadata remain in English.
  2. Find datasets: filter by tier, modality, scene category and area, task or main camera resolution. Search by name or repository ID.
  3. Select datasets: check Select Dataset on the cards. Select page selects the current page; Select all matches selects every matching page.
  4. Choose a platform: select Hugging Face or ModelScope in My Selection. All selected datasets must be available on that platform.
  5. Get commands: click Generate Download Command, copy the commands and run them in your terminal. A batch may generate multiple commands.

Commands download to ./data/HumanCOIN/ by default. Change --target-dir to choose another location. --revision pins each repository version for reproducibility, while --max-workers controls download concurrency.

The portal generates commands; the local tool downloads data directly from the selected platform.

Save and share a selection

  • Export JSON: save the current selection as selection.json.
  • Import JSON: restore your saved selection or one shared by another user.
  • Clear: remove the current selection.

The JSON file contains a selection list, not dataset files. Importing it does not upload local data. Your browser also remembers your selection.

Previews and catalog updates

Cards provide posters and short video previews. Click Preview for video and sensor information. Autoplay depends on browser settings. Full videos currently load primarily from Hugging Face, requiring network connectivity and any necessary access approval. The download platform selector does not change preview sources.

The catalog refreshes daily at 08:00 and 09:00 Asia/Shanghai and can also be refreshed manually by maintainers. Apply an update when the portal offers it. To avoid removing datasets during temporary API failures, removal requires two consecutive successful syncs confirming absence from all sources.

Need help?

  • Download issues: check tool installation, connectivity, access approval and token permissions.
  • Preview issues: check Hugging Face connectivity and permissions, or open the dataset on its source platform.
  • Portal bugs: open an issue.
  • Tool and dataset-reading questions: HumanCOIN repository.
  • Data requests and contact: humancoin@163.com.

Local development

Portal development requires Python 3.10+ and Node.js 20+. There are no frontend dependencies to install.

npm run dev

Open http://127.0.0.1:8000/ . See the development guide for architecture, sync and tests, release checks for deployment, and access synchronization for administrative configuration.

About

a web portal for finding, previewing and downloading HumanCOIN datasets

Resources

ReadmeApache-2.0 licenseActivityCustom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forksReport repository

Releases

Packages

Contributors

Languages