OneInit
AI-FIRST ENVIRONMENT INITIALIZER

One command
to init your
dev machine.

Python, Node.js, Rust, Go — installed, mirrored, PATH-configured. All in one line. Zero sudo. SQLite manifest for clean rollback.

Get Started
View Changelog
Terminal · oneinit
17
CLI Commands
7
Language Detectors
26
Unit Tests
7.3MB
Binary Size
AI-NATIVE

Built for AI agents.
Not just developers.

OneInit is the first environment initializer designed for the AI era. Every command has a JSON mode. Every operation is parseable. AI agents don't read terminal output — they read structured data.

01

JSON-First Output

Every command supports --json. Structured output that AI agents parse directly. No text scraping needed.

{
  "status": "success",
  "action": "install",
  "package": "python3.11",
  "install_path": "~/.oneinit/envs/python3.11",
  "duration_ms": 3420
}
02

AI Skill Installer

One command installs the OneInit Skill into ZCode, Claude, Codex, and Cursor. AI agents can then install tools, capture environments, and migrate machines autonomously.

$ oneinit skill install
[OK] installed -> zcode/codex/claude/agents
[OK] Skill installed to 4 AI agents
03

Agent Installation Guide

Give your AI assistant one prompt. It clones the repo, builds the binary, installs tools, and configures the Skill. Zero human intervention.

$ curl -fsSL https://raw.githubusercontent.com/
oneinitAI/oneinit/main/install.sh | sh
$ oneinit skill install
$ oneinit install python3.11 --json
$ oneinit install node20 --json
04

AI Agent Autonomous DevOps

AI agents can capture environments, export backups, and restore on new machines. CI/CD pipelines can self-bootstrap with one command. Zero manual config.

# Agent-initiated migration:
oneinit capture -o env.yaml
oneinit export --include-envs
oneinit import backup.tar.gz --force

$ oneinit install python3.11 --json → AI reads {"status":"success")

The Problem

Installing Python
should not take 30 minutes.

Without OneInit

The Developer's Afternoon

01Which Python version do I need?+
02Go to python.org → Downloads → find the right installer+
03Run .exe → check 'Add to PATH' → Next × 5+
04Python works. Now how do I install pip?+
05pip is slow. Google 'pip mirror' → edit pip.ini+
~30 minutes. Every machine. Every time.
With OneInit

One Command

terminal
$ oneinit
✓Don't care. Just install.
✓Auto-detect OS + download.
✓Handled. No checkboxes.
✓Bundled. get-pip auto-bootstrap.
✓Tsinghua mirror auto-configured.
One command. Less than 30 seconds. Every machine.
Comparison

New machine = hours of setup. Until now.

Download installer, Next, Next, Finish
→
$ oneinit install python3.11
Manually configure pip / npm mirrors
→
$ Auto: Tsinghua / npmmirror
rm -rf and hope it's clean
→
$ SQLite manifest, 100% rollback
"What did I install before?"
→
$ oneinit capture, oneinit export
New machine = lost afternoon
→
$ oneinit import backup.tar.gz
How It Works

Install, configure, rollback. Clean.

01

Install

Write a YAML recipe with the download URL, SHA256, and install steps. Drop it in ~/.oneinit/recipes/.

02

Verify

OneInit downloads the archive, verifies the SHA256 checksum, and extracts it to a sandboxed directory.

03

Configure

Mirror sources are auto-configured. PATH entries are added. Config files are written. All tracked in SQLite.

04

Rollback

Uninstall removes everything: PATH entries, config files, install directory, and manifest record. Complete.

Community Registry

Publish YAML.
Anyone installs.

Like npm, but for dev tools. Write a recipe. Push to GitHub. One command installs it anywhere.

Built-in security: every recipe is SHA256-verified before installation. Users confirm before anything runs.

zip_extract·tar_extract·exe_silent·msi_install·pkg_install
recipe.yaml
name: node20
version: "20.18.1"
description: "Node.js 20 LTS"

platforms:
  windows:
    url: "https://nodejs.org/..."
    sha256: "56e5aacd..."
    install_type: "zip_extract"

post_install:
  config_files:
    - path: ".npmrc"
      template: "registry={{mirror_npm}}"

maintainer:
  github: "BG4JTS"
Team Environment

One repo.
Whole team in sync.

Fork the team template, edit team.yaml (tools, mirrors, env vars, PATH, config files), push — and OneInit auto-detects on every run and syncs missing tools with your confirmation. New teammate? One command.

Ed25519-signed team.yaml is pinned on first add and verified on every sync — tampered content is refused. Recipes that run commands stay denied by default (--allow-exec).

oneinit team add <url>·team sync --force·team status
team.yaml
# 团队环境定义 team.yaml（fork 模板后修改）
team:
  name: "WebTeam"
  signing_key: "d8ee1d1c..."   # 可选：Ed25519 公钥

envs:
  node: "20"                    # → node20
  python: "3.11"               # → python3.11

mirrors:
  pip: "tsinghua"
  npm: "npmmirror"

env_vars:
  NODE_ENV: "development"

config_files:
  - path: "{{user_home}}/.npmrc"
    template: "registry={{mirror_npm}}"
SUPPORTED RECIPES · LIVE

One command.
4 tools and counting.

The recipe list is fetched live from the registry. Builtin recipes work out of the box; remote recipes install with one command.

BUILTINpython3.11
v3.11.9

Python + pip + 清华源

runtime
$ oneinit install python3.11
BUILTINnode20
v20.18.1

Node.js 20 LTS + npm 淘宝源

runtimejavascripttypescript
$ oneinit install node20
BUILTINgo
v1.23.4

Go 工具链

runtime
$ oneinit install go
BUILTINjava17
v17.0.20+8

Temurin JDK 17 LTS

runtimejava
$ oneinit install java17
fetching registry...

Need more tools? Submit a recipe request →github.com/oneinitAI/oneinit-recipes

01

Auto Mirror Config

pip uses Tsinghua. npm uses npmmirror. No manual setup. No config files. Works on every install.

02

7 Language Detectors

Scan any machine: Python, Node, Git, Rust, Go, Java, Docker. Plus custom detectors via scan_config.yaml.

03

Environment Migration

Export your entire setup as tar.gz. Import on a new machine. Tools, configs, package lists — everything restored.

04

Clean Uninstall

SQLite manifest tracks every PATH entry and config file. Uninstall removes everything. No leftovers. No guessing.

Install

One line. Done.

Pick your method. All install the same binary.

$ curl -fsSL https://raw.githubusercontent.com/oneinitAI/oneinit/main/install.sh | sh

Zero prerequisites. Auto-detects OS and architecture.

AI Install

Let AI do it.
Copy. Paste. Done.

Don't want to open a terminal? Ask ChatGPT, Claude, or ZCode to install OneInit for you. One prompt is all it takes.

Install OneInit on this machine and set up my dev environment.
Follow the guide at:
https://raw.githubusercontent.com/oneinitAI/oneinit/main/INSTALL_AGENT.md

Works with ChatGPT · Claude · ZCode · Copilot · any AI assistant