{"id":15060024,"url":"https://github.com/cwielder/coldcpu","last_synced_at":"2026-01-02T20:03:40.869Z","repository":{"id":255801435,"uuid":"846422057","full_name":"cwielder/coldcpu","owner":"cwielder","description":"Custom processor architecture, assembly language, and toolchain.","archived":false,"fork":false,"pushed_at":"2025-01-11T21:46:16.000Z","size":850,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T19:48:57.453Z","etag":null,"topics":["assembler","assembly","compiler","cpp","cpu","emulation","premake","processor-architecture"],"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/cwielder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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-08-23T07:09:09.000Z","updated_at":"2025-01-11T21:46:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"8891dbb0-cac6-4ee2-a2b0-a5e3d97e4322","html_url":"https://github.com/cwielder/coldcpu","commit_stats":null,"previous_names":["cwielder/coldcpu"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwielder%2Fcoldcpu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwielder%2Fcoldcpu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwielder%2Fcoldcpu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cwielder%2Fcoldcpu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cwielder","download_url":"https://codeload.github.com/cwielder/coldcpu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681084,"owners_count":20330155,"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","compiler","cpp","cpu","emulation","premake","processor-architecture"],"created_at":"2024-09-24T22:51:19.968Z","updated_at":"2026-01-02T20:03:40.819Z","avatar_url":"https://github.com/cwielder.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg width=\"600px\" src=\"https://github.com/user-attachments/assets/1cd0a6de-ea33-47f1-b8b4-9931e9c42260\"\u003e\n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/cwielder/coldcpu/wiki\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/docs-latest-blue.svg?style=flat\"\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://sloc.xyz/github/cwielder/coldcpu\"\u003e\n    \u003ca href=\"https://github.com/cwielder/coldcpu/blob/main/LICENSE.txt\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/license/cwielder/coldcpu?style=flat\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n# ❄️ Overview\n**ColdCPU** is a custom-made fictional processor architecture and assembly language written in C++. It offers a comprehensive toolchain for compiling, cross-platform emulation, and disassembly.\n\n# 🚀 Features\n* Turing Completeness: Supports arithmetic, floating-point and bitwise operations.\n* Control Flow: Conditional branching for complex program logic.\n* Memory Operations: Secure memory model with fast load/store instructions.\n* Clean \u0026 Simple: ColdCPU provides an educational reference designed to explore low-level architecture concepts and enhance understanding of basic processor functionality.\n* Examples: Several examples of programs written in the `cold` assembly language have been provided in the [workdir](https://github.com/cwielder/coldcpu/tree/main/workdir) folder of this repository.\n\n# 📚 Usage\n## Assembler\n```\nUsage: coldasm --input PATH --output PATH\n```\n\n## Emulator\n```\nUsage: coldemu --path PATH [--memory VAR]\n\nOptional arguments:\n  -m, --memory   memory size in bytes [default: 1024]\n```\n\n## Disassembler\n```\nUsage: colddsm --input PATH --output PATH\n```\n\n### See the documentation for more detailed information about the processor and toolchain in the [wiki](https://github.com/cwielder/coldcpu/wiki).\n\n# 🔨 Building\nThis project is built upon the [Premake5](https://premake.github.io/) metabuild system, meaning that it can compile using native build systems depending on the host. Currently, Windows and Linux are supported, and build systems for Visual Studio and GNU Make can be generated for each respectively by running the corresponding setup script found in the `scripts` directory at the root of the repository.\n\n## Steps\n* Clone the repository:\n```\ngit clone https://github.com/cwielder/coldcpu.git\ncd coldcpu\n```\n* Generate build files:\n  * Windows (Visual Studio):\n    ```\n    \"./scripts/setupVS.bat\"\n    ```\n    Open the resulting `coldcpu.sln` file in Visual Studio 2022+\n  * Linux (GNU Make):\n    ```\n    \"./scripts/setupMake\"\n    make\n    ```\n# 📃 License\nAll code in the `coldcpu` repository has been made available under the [MIT License](https://github.com/cwielder/coldcpu/blob/main/LICENSE.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcwielder%2Fcoldcpu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcwielder%2Fcoldcpu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcwielder%2Fcoldcpu/lists"}