0G Forge

0G Forge is a terminal-native agent framework and CLI for building, previewing, and deploying AI-generated apps on the 0G stack — powered by 0G Compute for inference, 0G Storage for persistent memory, and 0G Chain for on-chain registration.

0G Forge serves as a ZeroClaw-style framework alternative: where OpenClaw provides autonomous agent execution loops, 0G Forge provides the code-generation and deployment substrate — a framework primitive that agent builders can use to autonomously scaffold, modify, and ship on-chain AI apps using 0G Compute + Storage

Architecture

┌─────────────────────────────────────────────────────┐
│                   Developer / Agent                  │
└─────────────────────┬───────────────────────────────┘
                      │  og CLI commands
                      ▼
┌─────────────────────────────────────────────────────┐
│                  0G Forge CLI (og)                   │
│  og init │ og create │ og edit │ og preview          │
│  og deploy vercel │ og sync push/pull                │
│  og login │ og model list/use                        │
└──────┬─────────────────┬───────────────────┬────────┘
       │                 │                   │
       ▼                 ▼                   ▼
┌──────────────┐ ┌──────────────┐  ┌─────────────────┐
│  0G Compute  │ │  0G Storage  │  │    0G Chain      │
│  Network     │ │  (Indexer +  │  │  FrameworkReg.  │
│  (inference) │ │   KV Layer)  │  │  (EVM contract) │
└──────────────┘ └──────────────┘  └─────────────────┘
       │                 │                   │
       ▼                 ▼                   ▼
 Plan + Diff       Sync metadata        On-chain
 generation        across machines      framework entry

packages/
  forge-agent/       # Agent runtime — AgentLoop, ToolRegistry, MemoryLayer (NEW)
  core/              # .og manifest + history schema
  compute-client/    # 0G Compute auth + model client
  storage/           # SyncProvider interface + local-file provider
  storage-0g/        # 0G Storage SyncProvider (Indexer + contract)
apps/
  cli/               # og CLI — all commands wired here
contracts/
  FrameworkRegistry  # Solidity — deployed on 0G Chain mainnet
examples/
  goal-agent/        # Autonomous agent built on forge-agent runtime
    src/agent.mjs        # basic agent (mock mode)
    src/agent-0g.mjs     # 0G-native agent using forge-agent framework

forge-agent Runtime (`packages/forge-agent/`)

The core framework primitive — a ZeroClaw-style agent runtime built natively on 0G.

import { AgentLoop, ToolRegistry, MemoryLayer, createLocalMemoryBackend } from "@og/forge-agent";
import { createOgCreateTool, createOgEditTool, createOgSyncTool } from "@og/forge-agent";

const registry = new ToolRegistry()
  .register(createOgCreateTool({ cliEntry, tsxBin, projectDir, apply: true }))
  .register(createOgEditTool({ cliEntry, tsxBin, projectDir, apply: true }))
  .register(createOgSyncTool({ cliEntry, tsxBin, projectDir }));

const memory = new MemoryLayer(createLocalMemoryBackend("./state.json"), "my-agent");

const loop = new AgentLoop({
  registry,
  memory,
  maxRetries: 2,
  onStepEnd(reflection) {
    console.log(`${reflection.decision}: ${reflection.goal}`);
  }
});

loop
  .addGoal("Create a landing page with hero section", "og:create")
  .addGoal("Improve accessibility and contrast", "og:edit")
  .addGoal("Add feature list below hero", "og:edit");

const result = await loop.run();
// { goalsCompleted: 3, goalsSkipped: 0, reflections: [...] }

Three extensible primitives:

AgentLoop — goal execution engine with reflection (continue / retry / skip / abort)
ToolRegistry — register any tool; built-ins wrap og create, og edit, og sync
MemoryLayer — read/write/append agent state; backend-agnostic (local file or 0G Storage)

Install

npm install -g @kaptan_web3/og-cli
og --version
og --help

Before you start

Not every command needs setup. What each step requires:

Command	What you need
`og init`, `og preview`	Nothing — works fully offline
`og create` / `og edit`	An inference endpoint + token (see below)
`og sync push/pull` (0G mode)	A 0G mainnet wallet with a small balance (storage fee + gas, well under 0.1 0G per sync)
`og deploy vercel`	Vercel CLI installed and logged in (`npm i -g vercel && vercel login`)

Getting an inference endpoint + token

og talks to any OpenAI-compatible chat-completions API. Use whichever you have access to:

0G Compute proxy — if you have a token from a 0G Compute provider, use it directly (this is the recommended path; example endpoint shown in Quick start below).
Any OpenAI-compatible provider — endpoints exposing /chat/completions or /v1/chat/completions work with og login --endpoint <url> --token <key>.

After login, run og model list — it discovers the model ids your provider actually accepts, even if the endpoint has no /models catalog. If your project's default model is rejected, og create/og edit automatically retries with a provider-accepted model.

Getting a 0G wallet for sync (optional)

og sync works without any wallet (local-file mode). To sync through real 0G Storage + 0G Chain:

Use any EVM wallet; export its private key as OG_PRIVATE_KEY (with or without the 0x prefix).
Fund it with a small amount of 0G on 0G Mainnet (chain id 16661, RPC https://evmrpc.0g.ai).
Set OG_STORAGE_ENABLED=1. That's all — RPC endpoints and the registry contract default to mainnet values.

Quick start

1) Login with 0G Compute credentials

og login \
  --token "$OG_COMPUTE_TOKEN" \
  --endpoint "https://compute-network-4.integratenetwork.work/v1/proxy"

Any OpenAI-compatible 0G Compute proxy endpoint works. After login, og model list discovers the models your provider actually accepts. If your project's default model is not supported by the provider, og create/og edit automatically retries with a provider-accepted model.

2) Init a project

og init --template react-vite --dir ./my-app --yes
cd ./my-app && pnpm install

3) Generate from a prompt

og create --prompt "Add a hero section with gradient background" --dry-run
og create --prompt "Add a hero section with gradient background" --yes

4) Edit → preview → deploy

og edit --prompt "Improve CTA contrast and add mobile nav" --yes
og preview
og deploy vercel --yes

5) Sync metadata to 0G Storage

Only a funded 0G mainnet wallet key is required — RPC endpoints and the registry contract default to 0G mainnet values:

export OG_STORAGE_ENABLED=1
export OG_PRIVATE_KEY=<your_key>

og sync push   # uploads payload to 0G Storage, stores hash on 0G Chain
og sync pull   # reads hash from chain, downloads from 0G Storage

Without OG_STORAGE_ENABLED=1, sync falls back to a local-file provider (no network, no wallet needed).

0G Protocol Integration

Component	Usage
0G Compute Network	AI inference for `og create` / `og edit` — OpenAI-compatible `/v1/chat/completions`
0G Storage (Indexer)	`og sync push/pull` stores project metadata as files on 0G Storage network
0G Chain (EVM)	`FrameworkRegistry` contract stores latest sync hash per project + framework registration

Goal Agent — Autonomous example

The goal agent (examples/goal-agent/) is a working autonomous agent built on top of the og framework. It demonstrates how developers can use og as an agent substrate.

# Basic (mock mode)
node examples/goal-agent/src/agent.mjs --apply

# 0G-native (uses 0G Storage memory + 0G Chain registration + reflection loop)
OG_STORAGE_ENABLED=1 \
OG_PRIVATE_KEY=<key> \
node examples/goal-agent/src/agent-0g.mjs --apply --max-steps 3

What the 0G-native agent does:

Reads goal list
Runs og create / og edit for each goal
Reflection loop: evaluates each step result before continuing (retry / skip / continue)
Writes memory to 0G Storage after each step
Registers itself on 0G Chain via FrameworkRegistry

Contract Deployment (0G Chain)

cd contracts
npm install
cp .env.example .env  # fill in OG_PRIVATE_KEY
npm run deploy:mainnet

The deploy script also registers "0G Forge" on-chain automatically.

Deployed contract (0G Mainnet): 0x47955e005433A548287358c4DFd6679A0e8F5d50

Environment variables

# 0G Compute (required for real generation)
OG_COMPUTE_TOKEN=          # your compute API token
OG_COMPUTE_ENDPOINT=       # OpenAI-compatible proxy endpoint (set during `og login`)

# 0G Storage sync (optional, enables decentralized sync)
OG_STORAGE_ENABLED=1
OG_PRIVATE_KEY=            # wallet key for signing storage + chain txs (required)
OG_STORAGE_INDEXER_RPC=    # default: https://indexer-storage-turbo.0g.ai (mainnet)
OG_EVM_RPC=                # default: https://evmrpc.0g.ai (mainnet)
OG_REGISTRY_CONTRACT=      # default: 0x47955e005433A548287358c4DFd6679A0e8F5d50 (mainnet)

# Generation tuning (optional)
OG_GENERATION_TIMEOUT_MS=          # default: 120000
OG_GENERATION_MAX_FILE_CHARS=      # default: 6000  (per-file prompt context budget)
OG_GENERATION_MAX_CONTEXT_CHARS=   # default: 32000 (total prompt context budget)

# Developer mock mode (local testing only)
OG_ENABLE_MOCK_MODE=1      # enables mock://local endpoint

Run from source

git clone <repo-url>
cd 0G
pnpm install
pnpm build
pnpm --filter @kaptan_web3/og-cli run dev --help

Validation

pnpm lint
pnpm typecheck
pnpm build

Repository map

apps/cli/              # CLI — all og commands
packages/core/         # .og state (manifest, history)
packages/compute-client/ # 0G Compute auth + model client
packages/storage/      # SyncProvider interface + local-file provider
packages/storage-0g/   # 0G Storage SyncProvider (NEW)
contracts/             # FrameworkRegistry.sol — 0G Chain (NEW)
examples/goal-agent/   # Autonomous agent example
  src/agent.mjs        # basic version (mock)
  src/agent-0g.mjs     # 0G-native version with reflection (NEW)
scripts/demo-flow.sh   # reproducible demo runner

Supported templates

react-vite · nextjs-app · static-landing

Commands

og login / logout / whoami
og model list / model use <modelId>
og init
og create / og edit
og preview
og deploy vercel
og sync push / og sync pull
og doctor

Name		Name	Last commit message	Last commit date
Latest commit History 64 Commits
apps/cli		apps/cli
contracts		contracts
examples/goal-agent		examples/goal-agent
frontend		frontend
packages		packages
public		public
scripts		scripts
templates		templates
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
SHOWCASE.md		SHOWCASE.md
eslint.config.mjs		eslint.config.mjs
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.base.json		tsconfig.base.json
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

0G Forge

Architecture

forge-agent Runtime (`packages/forge-agent/`)

Install

Before you start

Getting an inference endpoint + token

Getting a 0G wallet for sync (optional)

Quick start

1) Login with 0G Compute credentials

2) Init a project

3) Generate from a prompt

4) Edit → preview → deploy

5) Sync metadata to 0G Storage

0G Protocol Integration

Goal Agent — Autonomous example

Contract Deployment (0G Chain)

Environment variables

Run from source

Validation

Repository map

Supported templates

Commands

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

0G Forge

Architecture

forge-agent Runtime (packages/forge-agent/)

Install

Before you start

Getting an inference endpoint + token

Getting a 0G wallet for sync (optional)

Quick start

1) Login with 0G Compute credentials

2) Init a project

3) Generate from a prompt

4) Edit → preview → deploy

5) Sync metadata to 0G Storage

0G Protocol Integration

Goal Agent — Autonomous example

Contract Deployment (0G Chain)

Environment variables

Run from source

Validation

Repository map

Supported templates

Commands

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

forge-agent Runtime (`packages/forge-agent/`)