{"_id":"0g-orbit","_rev":"6-a6884ef71f3c5b858fc06d115681e594","name":"0g-orbit","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"0g-orbit","version":"0.1.0","keywords":["0g","blockchain","ai","storage","inference","sdk","cli"],"license":"MIT","_id":"0g-orbit@0.1.0","maintainers":[{"name":"cybire","email":"shaibuafeez@gmail.com"}],"bin":{"orbit":"dist/cli/cli.js"},"dist":{"shasum":"626447e7b00758422ae0b56a1427da1de7769bfc","tarball":"https://registry.npmjs.org/0g-orbit/-/0g-orbit-0.1.0.tgz","fileCount":105,"integrity":"sha512-AjMdAYhBsPgYSZIE3beCxjxkksxPT2jRC0vRkxdmcuEU3YyVzuEi/71Wk8rMWqZ4cgXMfRbVr6xUuQxyoM4c5w==","signatures":[{"sig":"MEUCIQCjfU5cFehOMbOu/hvXdOgJBuHbvzvdtGPSPe2telvQmAIgckS9Qz/vbsT3wilaF/OHy7PzcYeK8hdVxOMgZjdJdPY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":230317},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"tsc --noEmit","test":"vitest run","build":"tsc","clean":"rm -rf dist","test:watch":"vitest"},"_npmUser":{"name":"cybire","email":"shaibuafeez@gmail.com"},"_npmVersion":"10.9.2","description":"The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"ora":"^8.0.1","chalk":"^5.3.0","ethers":"^6.13.1","commander":"^12.1.0","@0gfoundation/0g-ts-sdk":"^1.0.1","@0glabs/0g-serving-broker":"^0.7.4"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^20.12.0"},"_npmOperationalInternal":{"tmp":"tmp/0g-orbit_0.1.0_1775321316888_0.5341635679044836","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"0g-orbit","version":"0.2.0","keywords":["0g","blockchain","ai","storage","inference","sdk","cli"],"license":"MIT","_id":"0g-orbit@0.2.0","maintainers":[{"name":"cybire","email":"shaibuafeez@gmail.com"}],"bin":{"orbit":"dist/cli/cli.js"},"dist":{"shasum":"09fc0e353a47ea8c9be06243d32a7af50b9c65c3","tarball":"https://registry.npmjs.org/0g-orbit/-/0g-orbit-0.2.0.tgz","fileCount":116,"integrity":"sha512-Gwedzp7Eba4V959ZclzFV/CzqcWJX4JqdeEHBTtIxxPUje05dOuV0f65zt8Wgd6F6tk+q0HSNvwZof3sJ9Z0ag==","signatures":[{"sig":"MEQCIHXSZ7rb0UXABMhB0DhfUr2FZZKthG8vpQSgQ4/8mTb3AiBEKxZk73f1lqT11Q/A8y0jAIltHJfm2pzGLzAJVsScug==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":307128},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"tsc --noEmit","test":"vitest run","build":"tsc","clean":"rm -rf dist","test:watch":"vitest"},"_npmUser":{"name":"cybire","email":"shaibuafeez@gmail.com"},"_npmVersion":"10.9.2","description":"The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"ora":"^8.0.1","chalk":"^5.3.0","ethers":"^6.13.1","commander":"^12.1.0","@0gfoundation/0g-ts-sdk":"^1.0.1","@0glabs/0g-serving-broker":"^0.7.4"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^20.12.0"},"_npmOperationalInternal":{"tmp":"tmp/0g-orbit_0.2.0_1775332472223_0.18418124822354698","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"0g-orbit","version":"0.2.1","keywords":["0g","blockchain","ai","storage","inference","sdk","cli"],"license":"MIT","_id":"0g-orbit@0.2.1","maintainers":[{"name":"cybire","email":"shaibuafeez@gmail.com"}],"bin":{"orbit":"dist/cli/cli.js"},"dist":{"shasum":"8886ef504e815b035a6f889ccdfedfa937f33129","tarball":"https://registry.npmjs.org/0g-orbit/-/0g-orbit-0.2.1.tgz","fileCount":116,"integrity":"sha512-S7bE0kwWAWovwt3TPH8weIHKQbEqUn2jB2+x4MH7TfQqpmNheCh3KSvRdG7REZ81TYd/l2hcZ3jXm9K+t0YNdA==","signatures":[{"sig":"MEUCIBR8KI/umuk7dszcF2viZOJXbbVNHo+B8YIjPTZ0vn5GAiEAoG0wSCDVR3rbuN43Bho+l8ddVGiasO7C4+bronarN2k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":307300},"main":"./dist/index.js","pnpm":{"overrides":{"axios":"1.14.0"}},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"tsc --noEmit","test":"vitest run","build":"tsc","clean":"rm -rf dist","test:watch":"vitest"},"_npmUser":{"name":"cybire","email":"shaibuafeez@gmail.com"},"overrides":{"axios":"1.14.0","open-jsonrpc-provider":{"axios":"1.14.0"}},"_npmVersion":"10.9.2","description":"The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"ora":"^8.0.1","chalk":"^5.3.0","ethers":"^6.13.1","commander":"^12.1.0","@0gfoundation/0g-ts-sdk":"^1.0.1","@0glabs/0g-serving-broker":"^0.7.4"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^20.12.0"},"_npmOperationalInternal":{"tmp":"tmp/0g-orbit_0.2.1_1775368575129_0.17801810666520868","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"0g-orbit","version":"0.2.2","keywords":["0g","blockchain","ai","storage","inference","sdk","cli"],"license":"MIT","_id":"0g-orbit@0.2.2","maintainers":[{"name":"cybire","email":"shaibuafeez@gmail.com"}],"bin":{"orbit":"dist/cli/cli.js"},"dist":{"shasum":"e47d9d4863c364d2c9b1a4e1cfa7f20d86abb2b6","tarball":"https://registry.npmjs.org/0g-orbit/-/0g-orbit-0.2.2.tgz","fileCount":116,"integrity":"sha512-l2+0DXg4/HvhL8yhC/ErZQm6ZAQO1/qNv02hSQKNC03hyeWWuwGMQfPPaGzuybuViPCqENyC7BcYhJUoLeu0YA==","signatures":[{"sig":"MEUCIGGqNDbppVecNJ9yus/74+kzkWK56HYwEF3SaL7bxEYwAiEAxZhmRfiFyMB+i6yt1BV8BtoRoSqi4rWLCNJoYxYr8dk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":307300},"main":"./dist/index.js","pnpm":{"overrides":{"axios":"1.14.0"}},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"tsc --noEmit","test":"vitest run","build":"tsc","clean":"rm -rf dist","test:watch":"vitest"},"_npmUser":{"name":"cybire","email":"shaibuafeez@gmail.com"},"overrides":{"axios":"1.14.0","open-jsonrpc-provider":{"axios":"1.14.0"}},"_npmVersion":"10.9.2","description":"The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"ora":"^8.0.1","chalk":"^5.3.0","ethers":"^6.13.1","commander":"^12.1.0","@0gfoundation/0g-ts-sdk":"^1.0.1","@0glabs/0g-serving-broker":"^0.7.4"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^20.12.0"},"_npmOperationalInternal":{"tmp":"tmp/0g-orbit_0.2.2_1775426747704_0.8545062904245795","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"0g-orbit","version":"0.2.3","keywords":["0g","zero-gravity","blockchain","ai","storage","inference","fine-tuning","sdk","cli","web3","decentralized"],"author":{"name":"cyber"},"license":"MIT","_id":"0g-orbit@0.2.3","maintainers":[{"name":"cybire","email":"shaibuafeez@gmail.com"}],"homepage":"https://github.com/cyber/0g-orbit#readme","bugs":{"url":"https://github.com/cyber/0g-orbit/issues"},"bin":{"orbit":"dist/cli/cli.js"},"dist":{"shasum":"42cb2043c0725be204a1c6dc9003799a15e6a9f8","tarball":"https://registry.npmjs.org/0g-orbit/-/0g-orbit-0.2.3.tgz","fileCount":68,"integrity":"sha512-SGmjt074mMXKDRXleN+UMHDjoqdVoxSkDRpKPjc7LqbE/ZwiU7FNfzAWOSA3qoZA6H4rJz+AujSM9rHQVCtwrA==","signatures":[{"sig":"MEUCICXAJTp4MEFODvB5KVoUPtHQlzR8ohIa9Al+XflLJPHXAiEA1ysxLBwzP00YxpeHMg0SocgUR5kXFtuRoH3nwQhL/xg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":141137},"main":"./dist/index.js","pnpm":{"overrides":{"axios":"1.14.0"}},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"tsc --noEmit","test":"vitest run","build":"tsc","clean":"rm -rf dist","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"cybire","email":"shaibuafeez@gmail.com"},"overrides":{"axios":"1.14.0","open-jsonrpc-provider":{"axios":"1.14.0"}},"repository":{"url":"git+https://github.com/cyber/0g-orbit.git","type":"git"},"_npmVersion":"10.9.2","description":"The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.","directories":{},"sideEffects":false,"_nodeVersion":"22.16.0","dependencies":{"ora":"^8.0.1","chalk":"^5.3.0","ethers":"^6.13.1","commander":"^12.1.0","@0gfoundation/0g-ts-sdk":"^1.0.1","@0glabs/0g-serving-broker":"^0.7.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^20.12.0"},"_npmOperationalInternal":{"tmp":"tmp/0g-orbit_0.2.3_1775432282844_0.5533065051154433","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-04-04T16:48:36.759Z","modified":"2026-06-08T17:14:17.199Z","0.1.0":"2026-04-04T16:48:37.025Z","0.2.0":"2026-04-04T19:54:32.359Z","0.2.1":"2026-04-05T05:56:15.278Z","0.2.2":"2026-04-05T22:05:47.875Z","0.2.3":"2026-04-05T23:38:03.072Z"},"bugs":{"url":"https://github.com/cyber/0g-orbit/issues"},"author":{"name":"cyber"},"license":"MIT","homepage":"https://github.com/cyber/0g-orbit#readme","keywords":["0g","zero-gravity","blockchain","ai","storage","inference","fine-tuning","sdk","cli","web3","decentralized"],"repository":{"url":"git+https://github.com/cyber/0g-orbit.git","type":"git"},"description":"The developer toolkit for 0G. Store, infer, deploy — one SDK, one CLI, five minutes.","maintainers":[{"email":"shaibuafeez@gmail.com","name":"yosuku"}],"readme":"# 0G Orbit\n\nThe developer toolkit for [0G](https://0g.ai). Store, infer, fine-tune — one SDK, one CLI, five minutes.\n\n[![CI](https://github.com/cyber/0g-orbit/actions/workflows/ci.yml/badge.svg)](https://github.com/cyber/0g-orbit/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/0g-orbit)](https://www.npmjs.com/package/0g-orbit)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/node/v/0g-orbit)](https://nodejs.org)\n\n## What is this?\n\n0G Orbit wraps the 0G storage SDK, serving broker, and chain interactions into a single unified interface. Instead of juggling `@0gfoundation/0g-ts-sdk`, `@0glabs/0g-serving-broker`, and raw ethers calls, you get one `Orbit` class and one `orbit` CLI.\n\n**Storage** — Upload and download files to 0G's decentralized storage network\n**Inference** — Run AI models on 0G's decentralized compute network\n**Fine-Tuning** — Upload datasets, create training tasks, download fine-tuned models\n\n## Install\n\n```bash\nnpm install 0g-orbit\n```\n\n## Quick Start\n\n### SDK\n\n```typescript\nimport { Orbit } from '0g-orbit'\n\nconst orbit = await Orbit.connect({\n  network: 'testnet',\n  privateKey: process.env.PRIVATE_KEY,\n})\n\n// Upload a file\nconst { root, txHash } = await orbit.store('./data.json')\nconsole.log(`Stored: ${root}`)\n\n// Download it back\nawait orbit.retrieve(root, './downloaded.json')\n\n// Run AI inference\nconst response = await orbit.infer('meta-llama/Llama-3.2-3B-Instruct', {\n  message: 'Explain zero-knowledge proofs in one sentence.',\n})\nconsole.log(response.content)\n\n// Fine-tune a model\nconst dataset = await orbit.uploadDataset('./training-data.jsonl')\nconst task = await orbit.createFineTuneTask({\n  model: 'base-model',\n  dataset: dataset.root,\n  providerAddress: '0x...',\n})\n```\n\n### CLI\n\n```bash\n# Set your private key\nexport PRIVATE_KEY=0x...\n\n# Upload a file\norbit store ./my-file.txt\n\n# Download a file\norbit retrieve <rootHash> ./output.txt\n\n# Run inference\norbit infer meta-llama/Llama-3.2-3B-Instruct -m \"Hello, 0G!\"\n\n# List available AI services\norbit services\n\n# Fine-tune a model\norbit fine-tune ./dataset.jsonl --model base-model --provider 0x...\n\n# Check account status\norbit status\n```\n\n## API\n\n### `Orbit.connect(config)`\n\nCreates a connected Orbit instance.\n\n| Option | Type | Description |\n|---|---|---|\n| `network` | `'testnet' \\| 'mainnet'` | Network to connect to |\n| `privateKey` | `string?` | Wallet private key (falls back to `PRIVATE_KEY` env var) |\n| `rpcUrl` | `string?` | Custom RPC URL |\n\n### Storage\n\n| Method | Description |\n|---|---|\n| `orbit.store(path, options?)` | Upload a file, returns `{ root, txHash }` |\n| `orbit.storeData(text, options?)` | Upload a text string |\n| `orbit.retrieve(rootHash, outputPath, options?)` | Download a file by root hash |\n\n### Inference\n\n| Method | Description |\n|---|---|\n| `orbit.infer(model, options)` | Run AI inference, returns `{ content, tokensUsed }` |\n| `orbit.listServices()` | List available AI services on the network |\n\n### Fine-Tuning\n\n| Method | Description |\n|---|---|\n| `orbit.uploadDataset(path)` | Upload a training dataset to storage |\n| `orbit.createFineTuneTask(options)` | Create a fine-tuning task |\n| `orbit.getFineTuneTask(provider, taskId)` | Check task status |\n| `orbit.downloadModel(provider, taskId, outputDir)` | Download a fine-tuned model |\n| `orbit.listModels()` | List available base models |\n| `orbit.listProviders()` | List fine-tuning providers |\n\n### Direct Client Access\n\nFor advanced usage, access the underlying clients directly:\n\n```typescript\norbit.storage    // StorageClient\norbit.inference  // InferenceClient\norbit.fineTuning // FineTuningClient\n```\n\n## Security\n\nThis package has transitive dependencies with known vulnerabilities (from upstream 0G SDKs). To mitigate, add this to your project's `package.json`:\n\n```json\n{\n  \"overrides\": {\n    \"axios\": \"1.14.0\"\n  }\n}\n```\n\nSee [SECURITY.md](SECURITY.md) for details.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}