Skip to content

Comments

docs: update fine-tuning guide to reflect actual tested workflow#243

Merged
Ravenyjh merged 4 commits into0gfoundation:mainfrom
zeyuyuyu:docs/enhance-fine-tuning-guide
Feb 13, 2026
Merged

docs: update fine-tuning guide to reflect actual tested workflow#243
Ravenyjh merged 4 commits into0gfoundation:mainfrom
zeyuyuyu:docs/enhance-fine-tuning-guide

Conversation

@zeyuyuyu
Copy link
Contributor

@zeyuyuyu zeyuyuyu commented Feb 9, 2026

Summary

Updates the fine-tuning documentation based on end-to-end testing with Qwen2.5-0.5B-Instruct and Qwen3-32B on testnet. Every step in this guide has been verified through actual successful test runs.

Changes

Critical Fixes

  • transfer-fund command: Added --service fine-tuning parameter
  • Restored 0G Storage upload flow: Re-added Upload Dataset section with both --dataset and --dataset-path options
  • Fee description: Updated from byte count to auto-calculated token count

New Content

  • Dataset format examples (Instruction, Chat, Text)
  • Training config example with JSON tips
  • Model name format warning (no Qwen/ prefix)
  • Settlement wait note (~1 min before decrypt)
  • LoRA usage guide (extract, load, inference, merge)
  • Troubleshooting for common errors

Corrections

  • Updated model list with Qwen2.5 and Qwen3
  • Fixed status descriptions (Delivering, Finished)
  • Removed base model 0G Storage download option

Test Verification

… usage guide

- Add detailed dataset format examples (instruction/input/output, chat messages, simple text)
- Add dataset preparation guidelines
- Add direct TEE upload option (--dataset-path) as alternative to 0G Storage
- Add comprehensive "Using the Fine-tuned Model" section:
  - How to download base model (HuggingFace or 0G Storage)
  - How to load LoRA adapter with base model
  - How to run inference with fine-tuned model
  - How to merge and save full model locally
- Add Python package requirements table

Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel
Copy link

vercel bot commented Feb 9, 2026

Someone is attempting to deploy a commit to the 0g-Frontend Team on Vercel.

A member of the Team first needs to authorize it.

@Ravenyjh Ravenyjh changed the title docs: enhance fine-tuning documentation with dataset formats and LoRA usage guide [draft] docs: enhance fine-tuning documentation with dataset formats and LoRA usage guide Feb 9, 2026
Wuying Created Local Users and others added 2 commits February 10, 2026 17:56
0G Storage is not part of the current fine-tuning flow. Removed:
- Upload to 0G Storage option (Option A)
- Calculate Dataset Size section
- 0G Storage-based task creation (--dataset, --data-size)
- Download base model from 0G Storage (Option B)
- Download Data command from Other Commands
- Updated descriptions to reflect TEE-based direct upload flow

Co-authored-by: Cursor <cursoragent@cursor.com>
Key changes based on end-to-end testing with Qwen2.5-0.5B and Qwen3-32B:

- Add --service fine-tuning to transfer-fund (prevents MinimumDepositRequired)
- Restore Upload Dataset section with 0G Storage upload flow
- Document both --dataset (hash) and --dataset-path (file) for create-task
- Update fee description: auto-calculated by token count, not byte count
- Add Qwen2.5-0.5B-Instruct and Qwen3-32B to model list
- Add model name format warning (no Qwen/ prefix)
- Add training config example with JSON tips
- Fix status descriptions (Delivering = encrypting + uploading to 0G Storage)
- Add settlement wait note before decrypt (~1 min after acknowledge)
- Add --data-path directory tip for acknowledge-model
- Remove base model 0G Storage download option (addresses reviewer comment)
- Add troubleshooting for common errors (MinimumDepositRequired, settlement timing, JSON parsing)
- Keep LoRA usage guide from original PR

Co-authored-by: Cursor <cursoragent@cursor.com>
@zeyuyuyu zeyuyuyu changed the title [draft] docs: enhance fine-tuning documentation with dataset formats and LoRA usage guide docs: update fine-tuning guide to reflect actual tested workflow Feb 11, 2026
@Ravenyjh Ravenyjh force-pushed the docs/enhance-fine-tuning-guide branch from 8390dd9 to dfeb170 Compare February 12, 2026 09:49
Ravenyjh
Ravenyjh previously approved these changes Feb 12, 2026
@Ravenyjh Ravenyjh force-pushed the docs/enhance-fine-tuning-guide branch from dfeb170 to f2b9db8 Compare February 12, 2026 09:53
@Ravenyjh Ravenyjh force-pushed the docs/enhance-fine-tuning-guide branch from f2b9db8 to 004b980 Compare February 12, 2026 09:53
Ravenyjh
Ravenyjh previously approved these changes Feb 12, 2026
@Ravenyjh Ravenyjh force-pushed the docs/enhance-fine-tuning-guide branch from 004b980 to 52908cd Compare February 12, 2026 12:19
@vercel
Copy link

vercel bot commented Feb 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
0g-doc Ready Ready Preview, Comment Feb 13, 2026 6:15am

Request Review

@Ravenyjh Ravenyjh merged commit ede4196 into 0gfoundation:main Feb 13, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants