Skip to content

Home

Jump to bottom
ayaan._.infinity edited this page Jun 29, 2026 · 4 revisions

Forge OS Wiki

Welcome to the Forge OS wiki — documentation for the Python virtual operating system.

Quick links

Link Description
Documentation Full command reference, setup, Supabase, troubleshooting
GitHub Repository Source code, issues, contributions
License (MIT) Open-source license

What is Forge OS?

Forge OS is a Python-based virtual operating system for learning, experimentation, and development. It is not a real kernel — it runs as a Python app with its own shell, virtual filesystem, package manager, and 65+ commands.

Built by ayaan global. Open source under the MIT License.

Features

  • ForgeOS terminal window with boot sequence and Rich UI
  • Forge Shell — 65+ auto-discovered commands
  • Virtual filesystem (in-memory VFS)
  • User management and login system
  • Package manager — forgepkg
  • Supabase cloud accounts — usernames and salted password hashes stored in PostgreSQL (forge_users table); local fallback when not configured

Quick start (Windows)

cd /d D:\ForgeOS\Forge
uv pip install -r requirements.txt
uv pip install -e .
cd /d D:\ForgeOS\Forge && .\.venv\Scripts\python.exe boot.py

First launch: create an account. Later runs: sign in.

Debug in one window:

cd /d D:\ForgeOS\Forge && .\.venv\Scripts\python.exe boot.py --session

In the shell

Command What it does
help List all commands
docs Open this wiki (Docs page) in your browser
source Open the GitHub repository
disclaimer Legal notice + Supabase data-storage disclosure
forgefetch System info
about About Forge OS

Supabase

Forge OS uses Supabase for cloud account storage. Passwords are stored as salted SHA-256 hashes only — never plain text.

Setup steps, .env configuration, and the forge_users schema are in the Documentation page.

Disclaimer

Forge OS is a virtual OS for education and development — not a real operating system. Network and process commands are largely simulated. Account data may be stored in Supabase when configured. See Documentation → Disclaimer or run disclaimer in the shell.

Next steps

→ Read the full Documentation for commands, auth, Supabase setup, and troubleshooting.

→ Star the repo: github.com/axk42-op/ForgeOS

Clone this wiki locally