https://github.com/zanderlewis/assemble-os
https://github.com/zanderlewis/assemble-os
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/zanderlewis/assemble-os
- Owner: zanderlewis
- Created: 2025-04-17T21:26:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-17T21:28:45.000Z (about 1 year ago)
- Last Synced: 2025-04-18T11:54:37.208Z (about 1 year ago)
- Language: Assembly
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AssembleOS
AssembleOS is an Operating System made in 100% Assembly. It features basic commands and a basic on-RAM filesystem.
## Background
AssembleOS is an operating system in pure assembly language, entirely written by AI (Claude 3.7 Sonnet, ChatGPT o3, and ChatGPT o4). This was made to test the limits of these AIs and to see if AI can code in assembly language. It is designed to be simple and lightweight, making it easy to understand and modify. The OS is built using NASM (Netwide Assembler) and runs on QEMU, a generic and open-source machine emulator and virtualizer.
## Pre-requisites
For building AssembleOS, you need to have the following tools installed:
- [NASM](https://www.nasm.us/)
- [QEMU](https://www.qemu.org/)
- [Make](https://www.gnu.org/software/make/)
You can install these tools using your package manager. For example, on macOS, you can run:
```bash
brew install nasm qemu make
```
## Building and Running
To build and run AssembleOS, you can simply run this command:
```bash
make it
```
This will build the kernel and run it in QEMU. You can also run the following commands:
```bash
make build
make run
```
The `make build` command will build the kernel, and the `make run` command will run it in QEMU.
## Commands
AssembleOS supports the following commands:
- `ls`: List files in the current directory.
- `cat `: Display the contents of a file.
- `write `: Write text to a file.
- `echo `: Print text to the console.
- `cls`: Clear the console.
- `exit`: Reboot the system.
- `help`: Display help information.
- `disk info`: Display information about the disk.
- `disk read`: Read the first 16 bytes of the disk.
- `ver`: Display the version and other information.
- `mem`: Display memory information.
- `time`: Displays the current time in UTC.