{"id":27224877,"url":"https://github.com/frankray78/instructionos","last_synced_at":"2025-04-10T10:35:14.026Z","repository":{"id":241564836,"uuid":"805022051","full_name":"FrankRay78/InstructionOS","owner":"FrankRay78","description":"A 32-bit, x86 operating system written in C.","archived":false,"fork":false,"pushed_at":"2024-07-10T13:36:50.000Z","size":70,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-10T23:28:50.653Z","etag":null,"topics":["kernel","operating-system","os","osdev"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FrankRay78.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-23T18:20:08.000Z","updated_at":"2024-07-10T13:36:49.000Z","dependencies_parsed_at":"2024-06-25T11:24:22.872Z","dependency_job_id":null,"html_url":"https://github.com/FrankRay78/InstructionOS","commit_stats":null,"previous_names":["frankray78/instructionos"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrankRay78%2FInstructionOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrankRay78%2FInstructionOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrankRay78%2FInstructionOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrankRay78%2FInstructionOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FrankRay78","download_url":"https://codeload.github.com/FrankRay78/InstructionOS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248199247,"owners_count":21063641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kernel","operating-system","os","osdev"],"created_at":"2025-04-10T10:35:12.969Z","updated_at":"2025-04-10T10:35:14.017Z","avatar_url":"https://github.com/FrankRay78.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InstructionOS\n\nA 32-bit, x86 operating system written in C. \n\nInstructionOS is a hobby operating system written with a particular interest in low-level, test-driven development and comprehensive unit test coverage integrated from the beginning, something other kernels severely lack. The kernel code is clean, well-structured and commented to maximise educational value.\n\n## Features\n\n* Kernel written in ANSI C\n* Bootloader written in NASM assembly\n* Build toolchain written in Makefiles\n* Comprehensive unit test coverage\n* Multiboot Specification v1 compliant\n* Full 32-bit protected mode\n* Basic keyboard handler\n* VGA text mode \n\n## Progress\n\nInstructionOS isn't a fully-fledged 'operating system' yet, but it does boot and is being actively developed. The obligatory screenshot (which is pretty underwhelming at the moment) is here:\n\n![Screenshot from 2024-06-11 11-31-02](https://github.com/FrankRay78/InstructionOS/assets/52075808/025c2eed-c4d0-4208-a3d0-ce08dde13121)\n\n## Playing with InstructionOS\n\nInstructionOS is developed on Ubuntu running in VMWare workstation.\n\nA C cross-compiler is required (i686-elf-gcc); my [bash script](https://github.com/FrankRay78/InstructionOS/blob/main/i686-elf-gcc-build.sh) will build this for you, instructions for doing it manually are [here](https://wiki.osdev.org/GCC_Cross-Compiler).\n\nAdditional tools must also be installed: `apt install build-essential nasm qemu-system-i386`\n\n`make` will boot the kernel in QEMU, having first built it using the C freestanding toolchain.\n\n`make test` will run the unit tests, having first built the kernel and unit tests using the standard C11 toolchain.\n\n`make clean` should be run before switching between these two commands, otherwise you'll get a linker failure (given the differing toolchains).\n\nAdditional targets exist in the main [Makefile](https://github.com/FrankRay78/InstructionOS/blob/main/Makefile), ideal for development IDE's with integrated Makefile support (eg. JetBrains CLion or Visual Studio Code).\n\n## License\n\nInstructionOS is free software licensed under the terms of the MIT License, see [LICENSE](https://github.com/FrankRay78/InstructionOS/blob/main/LICENSE) for more details.\n\n## Credits\n\nInstructionOS was created by Frank Ray, [Better Software UK](https://bettersoftware.uk).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrankray78%2Finstructionos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrankray78%2Finstructionos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrankray78%2Finstructionos/lists"}