Foundation · Cycle 1 · free core · local only

An OS for AI engineering. Cycle 1 runs locally.

1stStep OS is the open-source foundation around explicit authority, isolated work, evidence, and release gates. Cycle 1 is live as a public free core: clone the repo, run it on your machine, paste an idea, and download a Project OS markdown ZIP. This is not a hosted product, not a full agent OS, and not a control plane.

Open GitHub → Local ZIP commands Public concept page Free OS Audit CLI All tools

Public GitHubClone https://github.com/1ststepai/1ststep-os. The source is public today.

Cycle 1 ZIPIdea → project profile → markdown ZIP on localhost. No model is called.

Free coreThe foundation is meant to stay usable without a metered product lock-in.

Get it

Clone, then run Cycle 1 locally

The public repo is the install. Node 22 or newer. Nothing here requires an email, account, or paid API key. Do not expect a hosted ZIP download from 1ststep.ai.

Works today

GitHub · 1ststepai/1ststep-os

Public source. Clone it. This is the live listing for the free core.

Local ZIP demo

Idea → profile → ZIP

After start, open http://localhost:3000/os. Paste an idea, compile, download a markdown ZIP.

Public concept

1stStep OS concept

https://www.1ststep.ai/os — the intended operating system. Illustrative demos stay labeled. Not a live control plane.

Companion · live CLI

1stStep OS Audit

Free offline audit for existing projects. Evidence over docs. Does not rewrite your repo.

Local commands

Cycle 1 compiles a Project OS markdown ZIP on your machine. No model is called. Do not deploy the unauthenticated compile API.

git clone https://github.com/1ststepai/1ststep-os
cd 1ststep-os
npm install && npm test && npm run build && npm start

Then open http://localhost:3000/os
Paste an idea → compile → download a Project OS markdown ZIP.
Node 22 or newer. Local only.