0 g轨道
开发人员工具包 0 g． 存储，推断，微调-一个SDK，一个CLI，五分钟。
这是什么？
0G Orbit将0G存储SDK、服务代理和链交互封装到一个统一的接口中。而不是耍杂耍 @0gfoundation/0g-ts-sdk， @0glabs/0g-serving-broker，和生醚电话，你得到一个 Orbit 一班一班 orbit CLI。
存储 -上传和下载文件到0G的分散存储网络 推理 -在0G的分散式计算网络上运行AI模型 微调 -上传数据集，创建训练任务，下载微调模型
安装
npm install 0g-orbit
快速入门
SDK
import { Orbit } from '0g-orbit'
const orbit = await Orbit.connect({
network: 'testnet',
privateKey: process.env.PRIVATE_KEY,
})
// Upload a file
const { root, txHash } = await orbit.store('./data.json')
console.log(`Stored: ${root}`)
// Download it back
await orbit.retrieve(root, './downloaded.json')
// Run AI inference
const response = await orbit.infer('meta-llama/Llama-3.2-3B-Instruct', {
message: 'Explain zero-knowledge proofs in one sentence.',
})
console.log(response.content)
// Fine-tune a model
const dataset = await orbit.uploadDataset('./training-data.jsonl')
const task = await orbit.createFineTuneTask({
model: 'base-model',
dataset: dataset.root,
providerAddress: '0x...',
})
命令行界面
# Set your private key
export PRIVATE_KEY=0x...
# Upload a file
orbit store ./my-file.txt
# Download a file
orbit retrieve <rootHash> ./output.txt
# Run inference
orbit infer meta-llama/Llama-3.2-3B-Instruct -m "Hello, 0G!"
# List available AI services
orbit services
# Fine-tune a model
orbit fine-tune ./dataset.jsonl --model base-model --provider 0x...
# Check account status
orbit status
API
Orbit.connect(config)
创建一个连接的Orbit实例。
| 选项 | 类型 | 描述 |
|---|---|---|
network | 'testnet' | 'mainnet' | 要连接的网络 |
privateKey | string? | 钱包私钥(回落到 PRIVATE_KEY env var) |
rpcUrl | string? | 自定义RPC URL |
存储
| 方法 | 描述 |
|---|---|
orbit.store(path, options?) | 上传文件，返回 { root, txHash } |
orbit.storeData(text, options?) | 上传文本字符串 |
orbit.retrieve(rootHash, outputPath, options?) | 通过根哈希下载文件 |
推理
| 方法 | 描述 |
|---|---|
orbit.infer(model, options) | 运行AI推理，返回 { content, tokensUsed } |
orbit.listServices() | 列出网络上可用的AI服务 |
微调
| 方法 | 描述 |
|---|---|
orbit.uploadDataset(path) | 上传训练数据集到存储 |
orbit.createFineTuneTask(options) | 创建一个微调任务 |
orbit.getFineTuneTask(provider, taskId) | 检查任务状态 |
orbit.downloadModel(provider, taskId, outputDir) | 下载一个微调过的模型 |
orbit.listModels() | 列出可用的基本模型 |
orbit.listProviders() | 列出微调提供程序 |
客户端直接访问
对于高级使用，直接访问底层客户端：
orbit.storage // StorageClient
orbit.inference // InferenceClient
orbit.fineTuning // FineTuningClient
安全
此包具有具有已知漏洞的可传递依赖关系（来自上游的0G sdk）。要减轻这种情况，请将其添加到项目中 package.json：
{
"overrides": {
"axios": "1.14.0"
}
}
看到 SECURITY.md 获取详细信息。
贡献
看到 CONTRIBUTING.md.