A lightweight, Python-based operating system designed for educational and experimental use. PythOS offers a Unix-like command-line interface with a focus on simplicity and extensibility.
- Intuitive command-line interface
- Basic user and file system management
- Built-in Python package support
- Easily extensible with custom commands
- Lightweight and fast boot via ISO
Grab the latest ISO from
Note: Only x64 devices are supported. Live mode only (persistent mode coming soon).
- Download Rufus or install it from the Microsoft Store.
- Flash the ISO to a USB drive (512MB+ recommended).
- Reboot your PC and enter the boot menu (
Esc,F2,F10,F12, orDel). - Select the USB device and boot into PythOS via GRUB.
⚠️ Changes made in PythOS are not saved after reboot.
UseCTRL+ALT+DELto reboot or hold the power button to shut down.
Therebootandshutdowncommands are not yet functional.
-
Open a terminal and navigate to the ISO directory.
-
Plug in your USB and run
lsblkto identify the device (e.g.,/dev/sda1). -
Unmount the drive:
sudo umount /dev/sda1
-
Flash the ISO:sudo dd if=pythos.iso of=/dev/sda bs=200M status=progress
-
Reboot and boot from USB via GRUB.
- macOS
- Linux
You may download the PythOS Imager from the
npm install pythos-imagerVisit the repo for more details.
⚙️ Run from Source (Advanced)
Recommended for developers or testing in a virtual environment.
Requirements
• Python 3.10+ • Packages: climage, hex, pyfiglet
Setup
git clone https://github.com/milo1004/PythonOS.gitcd PythonOS
pip install -r requirements.txt
python3 -m venv venv
source venv/bin/activate
python3 main.py📁 Project Structure
PythonOS/
├── main.py
├── PythOS/
│ ├── central.py
│ ├── currentdir.txt
│ ├── packages.txt
│ ├── bin/
│ │ ├── [command folders: cd, ls, ping, etc.]
│ ├── boot/
│ ├── userdata/
│ └── assets/
• cd does not support absolute paths starting with /.
Workaround: run cd / first, then navigate.
Pull requests are welcome! Fork the repo and submit your improvements.
This project is licensed under the MIT License. See the LICENSE file for details.