{"id":15060118,"url":"https://github.com/sam-astro/astro8-computer","last_synced_at":"2025-04-14T08:52:52.388Z","repository":{"id":43439939,"uuid":"499979743","full_name":"sam-astro/Astro8-Computer","owner":"sam-astro","description":"Custom 16-bit homebrew CPU, emulator, renderer, circuit, and language","archived":false,"fork":false,"pushed_at":"2025-03-15T19:08:51.000Z","size":359110,"stargazers_count":798,"open_issues_count":6,"forks_count":88,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-04-07T01:09:47.513Z","etag":null,"topics":["assembler","assembly","assembly-language","compiled-language","computer","computer-architecture","cpp","cpu","emulator"],"latest_commit_sha":null,"homepage":"","language":"C++","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/sam-astro.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":"2022-06-05T02:14:18.000Z","updated_at":"2025-03-29T18:33:08.000Z","dependencies_parsed_at":"2023-01-29T14:15:59.319Z","dependency_job_id":"e92eb0cf-5527-47a4-a587-5637b8cea83e","html_url":"https://github.com/sam-astro/Astro8-Computer","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sam-astro%2FAstro8-Computer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sam-astro%2FAstro8-Computer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sam-astro%2FAstro8-Computer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sam-astro%2FAstro8-Computer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sam-astro","download_url":"https://codeload.github.com/sam-astro/Astro8-Computer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248852078,"owners_count":21171839,"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":["assembler","assembly","assembly-language","compiled-language","computer","computer-architecture","cpp","cpu","emulator"],"created_at":"2024-09-24T22:53:12.399Z","updated_at":"2025-04-14T08:52:52.369Z","avatar_url":"https://github.com/sam-astro.png","language":"C++","readme":"\u003cimg src=\"https://github.com/sam-astro/Astro8-Computer/blob/main/images/Astro8-Logo-Small.png?raw=true\"/\u003e\n\n[![Badge License]][License]   [![Button Discord]][Discord Server]\n\n\u003cbr\u003e\n\nThe Astro-8 is a 16-bit computer design. It has a (almost) working **[Logisim Evolution]** circuit, along with an emulator on Windows, Mac, and Linux, for running code at full speed. There is an assembly language, along with a higher level language called Armstrong, plus more which are actively being built by the community.\n\nI created a video about the creation of this and how it works, which you can view here:\n\n[![Button Video]][Video]\n\n## Demos\nThere are some demos for the Astro-8, such as the pong game and a typing program. You can locate those in the folder `/example_armstrong_programs/`.\n\n[Go here for the documentation and more previews for some other demos](https://sam-astro.github.io/Astro8-Computer/docs/Demos.html)\n\n\u003cp float=\"left\"\u003e\n\u003cimg src=\"https://github.com/sam-astro/Astro8-Computer/blob/main/images/pong.gif\" width=30% /\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/sam-astro/Astro8-Computer/main/images/perspectiveCube.gif\"  width=30% /\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/sam-astro/Astro8-Computer/main/images/raytracer.gif\"  width=30% /\u003e\n\u003c/p\u003e\n\n## Programming\nThe two most supported ways to program for the computer is using the [assembly language](https://sam-astro.github.io/Astro8-Computer/docs/Architecture/Instruction%20Set.html) or [Armstrong](https://sam-astro.github.io/Astro8-Computer/docs/Programming/README.html).\n\n## Documentation\n[![Button Documentation]][Documentation] \n\n## Installation\n### Windows\n1. Navigate to [the most recent release](https://github.com/sam-astro/Astro8-Computer/releases), and download the **Windows** version\n2. Unzip the downloaded file\n### Linux\n1. Make sure you have [SDL2 installed](https://wiki.libsdl.org/Installation#supported_platforms) on your system\n\n    For debian based operating systems, you can do this with:\n```\nsudo apt-get install -y libsdl2-2.0-0 libsdl2-mixer-2.0-0\n```\n2. Navigate to [the most recent release](https://github.com/sam-astro/Astro8-Computer/releases), and download the **Linux** version\n3. Unzip the downloaded file\n### From Source\n1. Clone this repository in a command line using `git clone https://github.com/sam-astro/Astro8-Computer.git` OR by downloading the repository as a .ZIP file and unzipping it to your location of choice\n2. Make sure you have [SDL2 installed](https://wiki.libsdl.org/Installation#supported_platforms) on your system\n3. Enter the directory `Astro8-Computer/Astro8-Emulator/linux-build`\n4. Run CMake using `cmake ..` to generate Unix Makefile\n5. Run `make -j5` to generate executable\n6. The executable is `Astro8-Computer/Astro8-Emulator/linux-build/Astro8-Emulator`\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Other projects related to the Astro-8:\n\u003e These projects are not always compatable with the main branch of the official Astro8-Computer repository. Please read the instructions in their project's repo before using.\n* https://github.com/LucasJG1994/Astro8-VM  -  Astro8-VM BY [@LucasJG1994](https://github.com/LucasJG1994)\n* https://github.com/GerardSmit/Astro8  -  Astro8 C# and Web emulator BY [@GerardSmit](https://github.com/GerardSmit)\n* https://github.com/GerardSmit/Astro8  -  Yabal, a high-level C-like language BY [@GerardSmit](https://github.com/GerardSmit)\n\n\u003cbr\u003e\n\n\n\u003c!-----------------------------------------------------------------------------\u003e\n\n[Logisim Evolution]: https://github.com/logisim-evolution/logisim-evolution\n[Documentation]: https://sam-astro.github.io/Astro8-Computer/\n[Video]: https://www.youtube.com/watch?v=Zt0JfmV7CyI\n\n[License]: LICENSE\n[Discord Server]: https://discord.gg/9p82dTEdkN\n\n\n\u003c!----------------------------------[ Badges ]---------------------------------\u003e\n\n[Badge License]: https://img.shields.io/github/license/sam-astro/Astro8-Computer\n\n\u003c!---------------------------------[ Buttons ]---------------------------------\u003e\n\n[Button Documentation]: https://img.shields.io/badge/Documentation-008FC7?style=flat-square\u0026logoColor=white\u0026logo=GitBook\n[Button Video]: https://img.shields.io/badge/Video-c91111?style=flat-square\u0026logoColor=white\u0026logo=YouTube\n[Button Discord]: https://img.shields.io/badge/Discord_Server-573f75.svg?style=social\u0026logo=Discord\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsam-astro%2Fastro8-computer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsam-astro%2Fastro8-computer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsam-astro%2Fastro8-computer/lists"}