PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

0.2.9

npm

0g-aura

Decentralized AI coding agent on 0G Compute

0gaiclicoding-agentcomputedecentralized
Published20 Mar 2026
Direct dependencies8
Transitive dependenciesNot calculated

README

Current package documentation

0g-aura

Decentralized AI coding agent powered by 0G Compute. Describe what you want to build, edit, or fix — aura streams responses from verifiable GPU providers and applies file changes directly to your project.

Install

npm install -g 0g-aura

Or with npx (no install):

npx 0g-aura

Or clone and link locally:

git clone <repo-url>
cd 0g-aura
npm install
npm run build
npm link

Setup

aura init

This walks you through wallet setup interactively:

  1. Create a new wallet or import an existing private key
  2. Choose where to save (./.env or ~/.aura/.env for global)
  3. Checks your A0GI balance automatically

You need A0GI tokens to pay for decentralized compute. Get them at portal.0g.ai.

Usage

# Start in current directory with default model
aura

# Choose a model
aura -m deepseek-chat-v3-0324

# Target a specific project directory
aura -d ./my-project

# Skip apply confirmations
aura --no-confirm

Inside the TUI, type a prompt and press Enter. Aura will:

  1. Read your project files for context
  2. Stream a response from a 0G compute provider in real-time
  3. Show a diff of proposed changes
  4. Ask for confirmation before writing files

CLI Flags

FlagDescription
-m, --model <name>Model to use (default: GLM-5-FP8)
-d, --dir <path>Project directory (default: cwd)
--no-confirmApply changes without confirmation
-V, --versionShow version
-h, --helpShow help

Slash Commands

CommandDescription
/helpShow all commands
/model <name>Switch AI model
/add <path>Add a file to prompt context
/remove <path|all>Remove file(s) from context
/filesShow detected project tree
/statusCheck 0G Compute connectivity
/balanceCheck wallet A0GI balance
/undoRevert the last applied file changes
/export [file]Save conversation to markdown
/costShow session token usage
/clearClear conversation history
/quitExit

Keyboard Shortcuts

KeyAction
EnterSend prompt / confirm apply
EscClear input / reject apply
Up/DownRecall previous prompts
Shift+Up/DownScroll conversation
PageUp/PageDownScroll fast
Home/EndJump to oldest/latest
Ctrl+CExit

Models

ModelDescription
GLM-5-FP8Default, fast general-purpose
deepseek-chat-v3-0324DeepSeek v3
gpt-oss-120b120B open-source
qwen3-vl-30b-a3b-instructQwen3 multimodal

Configuration

Environment VariableDefaultDescription
ZG_PRIVATE_KEY(required)0G wallet private key
ZG_RPC_URLhttps://evmrpc.0g.ai0G RPC endpoint
ZG_AUTO_DISCOVER_PROVIDERtrueAuto-discover compute providers
ZG_PROVIDER_ADDRESS—Pin a specific provider (skips discovery)

Config is loaded from ./.env first, then ~/.aura/.env as fallback. Run aura init to create one.

How It Works

Aura connects to the 0G decentralized compute network through the @0glabs/0g-serving-broker SDK. When you send a prompt:

  1. Context assembly — scans your project tree and reads key files (with automatic token budget management)
  2. Provider discovery — finds an available GPU provider serving your chosen model (or uses a pinned address)
  3. Streaming inference — sends your conversation + project context to the provider and streams the response in real-time
  4. Parsing — extracts file changes and shell commands from the model output
  5. Apply — shows a diff preview, then writes files and runs commands on confirmation (with /undo support)

All inference runs on decentralized, verifiable GPU providers — no centralized API keys needed, just an 0G wallet with A0GI tokens.

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 8

Native requirements
8 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
chalk
Environment
{
  "local_name": "chalk",
  "alias": false,
  "peer_metadata": null
}
^5.4.1runtime
dotenv
Environment
{
  "local_name": "dotenv",
  "alias": false,
  "peer_metadata": null
}
^16.4.7runtime
ethers
Environment
{
  "local_name": "ethers",
  "alias": false,
  "peer_metadata": null
}
6.13.1runtime
commander
Environment
{
  "local_name": "commander",
  "alias": false,
  "peer_metadata": null
}
^13.1.0runtime
@0glabs/0g-serving-broker
Environment
{
  "local_name": "@0glabs/0g-serving-broker",
  "alias": false,
  "peer_metadata": null
}
^0.7.1runtime
tsx
Environment
{
  "local_name": "tsx",
  "alias": false,
  "peer_metadata": null
}
^4.19.2development
typescript
Environment
{
  "local_name": "typescript",
  "alias": false,
  "peer_metadata": null
}
^5.7.3development
@types/node
Environment
{
  "local_name": "@types/node",
  "alias": false,
  "peer_metadata": null
}
^22.12.0development

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "4a877694f3bfc21fe1860a4b06aba818fcb1f239",
  "tarball": "https://registry.npmjs.org/0g-aura/-/0g-aura-0.2.9.tgz",
  "fileCount": 54,
  "integrity": "sha512-m84hu0PjLr3wQxt1DVZS/OMYAf3c3YZMoZRmZFV4jk+BlDMW70H+c67tL9BR9E964ZV5xXu/IlHcA3sSSK9rYg==",
  "signatures": [
    {
      "sig": "MEUCIQDg8MfiedHU2a4mLarIRqkZu2l30byBci9Q87gq3yy6+QIgf85s+kbR+DhlGJkiAHkJcR7hYPCaB/PWgKMX7s9nkMI=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 362488
}

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 17:39 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:5aaaeed6b7cf22fbc31c0056835162ede718d727112aa80ac043bf720b63a533

Other collected versions

0.4.3124 May0.4.3022 May0.4.294 May0.4.284 May0.4.2719 Apr0.4.2619 AprView all collected versions →