{"id":30105696,"url":"https://github.com/fielding/redstone-university","last_synced_at":"2025-08-10T00:18:53.547Z","repository":{"id":306196300,"uuid":"1025297058","full_name":"fielding/redstone-university","owner":"fielding","description":"An interactive course on computer science and digital architecture, built from the ground up in Minecraft.","archived":false,"fork":false,"pushed_at":"2025-08-08T16:34:39.000Z","size":126462,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-08T18:31:50.026Z","etag":null,"topics":["bitwise-operators","boolean-algebra","boolean-logic","computer-science","course","digital-architecture","minecraft"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fielding.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"2025-07-24T03:47:44.000Z","updated_at":"2025-08-08T16:34:42.000Z","dependencies_parsed_at":"2025-07-24T08:50:45.898Z","dependency_job_id":"14ebb9a8-cc9e-410c-a758-1919382f8bcf","html_url":"https://github.com/fielding/redstone-university","commit_stats":null,"previous_names":["fielding/redstone-university"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fielding/redstone-university","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fielding%2Fredstone-university","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fielding%2Fredstone-university/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fielding%2Fredstone-university/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fielding%2Fredstone-university/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fielding","download_url":"https://codeload.github.com/fielding/redstone-university/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fielding%2Fredstone-university/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269656879,"owners_count":24454734,"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","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"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":["bitwise-operators","boolean-algebra","boolean-logic","computer-science","course","digital-architecture","minecraft"],"created_at":"2025-08-10T00:18:50.995Z","updated_at":"2025-08-10T00:18:53.508Z","avatar_url":"https://github.com/fielding.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"assets/images/logo.png\"\u003e\n      \u003cimg alt=\"Redstone University Logo\" src=\"assets/images/logo-dark.png\"\u003e\n    \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eRedstone University\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eAn interactive course on computer science and digital architecture, built from the ground up in Minecraft.\u003c/strong\u003e\n  \u003cbr /\u003e\n  \u003cbr /\u003e\n  \u003ca href=\"#️-course-structure--curriculum\"\u003eCourse Structure\u003c/a\u003e\n  ·\n  \u003ca href=\"https://github.com/fielding/redstone-university/issues\"\u003eReport a Bug or Typo in the Course\u003c/a\u003e\n  ·\n  \u003ca href=\"https://github.com/fielding/redstone-university/issues\"\u003eRequest a Feature\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Course%20Status-In%20Development-yellow\" alt=\"Course Status: In Development\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Contributions-Welcome-brightgreen\" alt=\"Contributions Welcome\"\u003e\n\u003c/p\u003e\n\n---\n\n## About The Project\n\nHave you ever used a computer and wondered what’s *really* happening inside? Not just the software, but the deep, physical magic behind it all?\n\n**Redstone University** is a journey into the heart of the machine. This project provides a complete, university-level curriculum for learning computer architecture from first principles. But instead of abstract Hardware Description Languages and simulators, our campus is the world of Minecraft. We will make the abstract tangible, turning theory into a physical, working machine that you can walk around inside of.\n\nAs a self-taught computer engineer, I found myself wanting to explore the foundational principles of computer science. The initial spark for this project, however, came from wanting to build something that could share these incredible ideas with my daughter, Ada. Ada introduced me to minecraft when she was 2 years old, and we've been building together ever since. I realized that the abstract concepts of binary, bitwise operations, logic gates, and computer architecture are sometimes introduced in ways that make them feel very intangible. At the same time, I saw the incredibly complex and logical machines being built in Minecraft with Redstone. The idea was born: **what if we could learn these concepts in a tangible way, by building a computer from scratch, using tools we already love?**\n\nThat is the mission of Redstone University. We will make the abstract tangible. We will turn theory into a physical, working machine that you can walk around inside of.\n\n### Who Is This For?\n\nThis course is for the curious. It's for:\n*   **My daughter, Ada**, for whom this project was first imagined.\n*   **Students and kids** who want a fun, hands-on introduction to STEM and computer science.\n*   **University CS students** who want a physical way to visualize the concepts from their \"Computer Architecture\" class.\n*   **Self-taught programmers and professionals** who want to solidify their understanding of what's happening at the hardware level.\n\n---\n\n## Course Structure \u0026 Curriculum\n\nThis course is structured as a complete curriculum, taking you from zero knowledge to a fully functional, programmable 4-bit computer. We will follow a clear, logical path, broken into five distinct parts:\n\n*   **Part I: The Foundations - Speaking to the Machine.** We will begin by building the essential human-computer interface. We'll learn the language of binary, the grammar of Boolean logic, and construct our own \"keyboard\" and \"monitor.\"\n*   **Part II: Engineering a Robust Arithmetic Unit.** Here, we will build the mathematical core of our machine. We'll engineer an adder and subtractor, discover our machine's natural limitations through \"bugs\" like overflow, and upgrade our system to solve them, just like real engineers.\n*   **Part III: The Processor Core.** With our arithmetic unit perfected, we will forge the true brain of our computer: the Arithmetic Logic Unit (ALU). We will combine all our mathematical and logical circuits into one powerful, versatile, and controllable component.\n*   **Part IV: Creating an Automated Computer.** In the final core modules, we'll give our processor a memory to store its thoughts and a clock to act as its heartbeat. We will assemble everything into a single, automated machine that can run a simple program on its own.\n*   **Part V: Post-Graduate Studies.** For those who want to go even further, we'll explore advanced topics, tackling the complex challenge of making our computer display multi-digit decimal numbers, just like a real-world calculator.\n\n\nPlease see 'curriculum.md' for the full course outline and 'structure.md' for details on how the course is organized.\n\n---\n\n\n## Contributing\n\nContributions are what make the open-source community such an amazing place to learn and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion to improve a lesson, fix a typo, or correct a circuit diagram, please feel free to fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\n\nPlease see [contributing.md](.github/CONTRIBUTING.md) for more details.\n\n---\n\n## License\n\nThis project is dual-licensed to ensure it remains a free educational resource while protecting the creator's rights.\n\n#### Course Content\nThe educational content of this course, including all Markdown files (`.md`), images, diagrams, and assets, is licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0)](http://creativecommons.org/licenses/by-nc-sa/4.0/).\n\n\u003ca rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc-sa/4.0/\"\u003e\u003cimg alt=\"Creative Commons License\" style=\"border-width:0\" src=\"https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png\" /\u003e\u003c/a\u003e\n\nThis means you are free to share and adapt the material for **non-commercial** purposes, as long as you give appropriate credit and distribute your contributions under the same license.\n\n#### Software\nAll source code in this repository, such as the build script, is licensed under the [MIT License](LICENSE). You are free to use, modify, and distribute this code for any purpose.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffielding%2Fredstone-university","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffielding%2Fredstone-university","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffielding%2Fredstone-university/lists"}