{"id":28103728,"url":"https://github.com/sasooxd/philos","last_synced_at":"2026-04-27T11:31:44.519Z","repository":{"id":229395924,"uuid":"723743767","full_name":"SasooXD/philOS","owner":"SasooXD","description":"Barebones 16-bit operating system, custom BIOS, general software and circuit diagrams for an i8088-based homebrew computer.","archived":false,"fork":false,"pushed_at":"2025-07-05T17:36:22.000Z","size":51857,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-05T18:59:51.284Z","etag":null,"topics":["16-bit","8088","bios","dos","kernel","retrocomputing","x86-16"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"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/SasooXD.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,"zenodo":null}},"created_at":"2023-11-26T16:26:35.000Z","updated_at":"2025-07-05T17:38:39.000Z","dependencies_parsed_at":"2024-03-24T03:33:11.999Z","dependency_job_id":"6c398837-463a-44cb-98b0-c9b213d36cf9","html_url":"https://github.com/SasooXD/philOS","commit_stats":null,"previous_names":["sasooxd/philos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SasooXD/philOS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SasooXD%2FphilOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SasooXD%2FphilOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SasooXD%2FphilOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SasooXD%2FphilOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SasooXD","download_url":"https://codeload.github.com/SasooXD/philOS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SasooXD%2FphilOS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32335296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["16-bit","8088","bios","dos","kernel","retrocomputing","x86-16"],"created_at":"2025-05-13T20:39:05.657Z","updated_at":"2026-04-27T11:31:44.514Z","avatar_url":"https://github.com/SasooXD.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"![philOS' logo](res/banner.png)\n\n# `msg DB 'Welcome to philOS.', 0`\n\nThis repository contains both hardware diagrams and software code for a retro-computing-inspired system, built **entirely from scratch**.\n\n## `INT 0x00 ; GET_GENERAL_INFO`\n\nWe named it **_philOS_**.\n\nThe software consists of a very simple **16-bit kernel**, several **user programs**, and a fully **custom BIOS**.\n\nThe hardware is built around the legendary **Intel 8086**, the 16-bit processor that gave life to the x86 architecture, along with **128 KiB of RAM** and **64 KiB of ROM**.\n\n## `INT 0x01 ; GET_PURPOSE_N_HISTORY`\n\nStarted as a side hobby, later became our final-year exam project for high school.\n\nInitially, we intended to develop only an operating system (hence the name), but we eventually decided to buy some chips and got to work on building the physical computer as well.\n\nThe project is still **work in progress**. There are many things left to implement and improve, however, the journey has taught us a great deal about how a computer _actually_ works under the hood. Working with no abstraction layer was challenging at times, but the result has been far more rewarding and fascinating as a direct consequence.\n\nWe hope we can inspire you to build a computer from absolutely nothing, too!\n\n## `INT 0x02 ; GET_TECHNICAl_DETAILS`\n\nIf you're interested in the project, we would tell you to read the documentation but unfortunately we're still working on it. Once deemed ready, the complete documentation will be available here in both Italian and English.\n\n_philOS_ is completely **free and open-source software** (_can't say the same for the hardware!_), and is licensed under the [**MIT license**](LICENSE.txt).\n\nWe don't accept contributions at this stage, but you're obviously free to fork the repository and make your own improvements.\n\n## `INT 0x03 ; GET_MORE_TECHNICAL`\n\nAfter cloning, you can `make` the project. This will generate the `build/` directory, which contains a NASM-assembled binary file for each source code file found in the `src/` directory. We currently have _some_ C support, but x86-16 assembly remains the preferred choice for most of the code. That being said, the `make release` option is probably what you're after as this creates two 64 KiB binaries, one for each ROM that you should have hooked up to the i8086. Either way if you have an EEPROM programmer and just want the binaries, we periodically release **stable versions**.\n\nYou'll find some useful scripts in the `tools/` directory, these mainly help us build the final binary files.\n\nThe `hw/` directory contains all the hardware-related files, including the complete **circuit diagram** and a **list of components used**. If you want to build the physical system yourself, you may want to check that first.\n\nThe `docs/` directory is pretty much self-explanatory.\n\n## `INT 0x04 ; GET_WORKING_MEMORY_ADDR`\n\nWhile we’re not accepting contributions right now, feedback is always appreciated. You don't necessarily have to emulate or physically build _philOS_ to spot its bugs or errors because they are probably a lot and visible from a distance: you just need to be able to read some assembly. **Thank you!**\n\n## `INT 0x05 ; GET_NEXT_FREE_SEGMENT`\n\nWe don’t have a fixed roadmap for what to implement next; we prefer to develop things as we go. Software-wise, you might want to check `; TODO:` comments, most of them are either \"fix this\" or \"make that\". One final goal could be to create an approximate replica of the [**Olivetti M24**](https://en.wikipedia.org/wiki/Olivetti_M24)—perhaps an enhanced version of it.\n\n## `INT 0X06 ; LOAD_VGA_MODE`\n\nThe following are photographs showing the evolution of the project in chronological order.\n\n![Photo no. 1](res/photos/1.jpg) ![Photo no. 2](res/photos/2.jpg) ![Photo no. 3](res/photos/3.jpg) ![Photo no. 4](res/photos/4.jpg) ![Photo no. 5](res/photos/5.jpg) ![Photo no. 6](res/photos/6.jpg) ![Photo no. 7](res/photos/7.jpg) ![Photo no. 8](res/photos/8.jpg) ![Photo no. 9](res/photos/9.jpg)\n\n# `RET`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsasooxd%2Fphilos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsasooxd%2Fphilos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsasooxd%2Fphilos/lists"}