Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



97 Commits

Repository files navigation

Civboot: civboot a civilizational bootstrapper civboot

To grow a tree you need a seed. To build a computer you need a Civboot. In the same way that a tiny seed has everything needed to grow into a tree, we should create a tiny Civboot which has everything needed to build a modern Civilization.

Want to share your thoughts or ask questions? Feel free to open an issue here or join us on discord.

What is a Civboot? Conceptually it is a seed from which can grow the essential technology of Civilization. Imagine a factory capable of building a minimalist general-purpose personal computer, like something from the 80's/90's or better. A Civboot factory is one which can build such a factory from raw materials.

  • OR imagine that you wanted to be able to build computer chips and other electronic components entirely "in house" (by a small company) with no dependency on a supply chain. How large and expensive would such a factory currently be? Can we do better?
  • OR imagine you wanted to have a self-sufficient factory on Mars that can build computer chips and other necessary "tools that build tools". How large would such a factory have to be and what would we need to take from earth?

Today's technology stack and supply chain are too large and complex to be produced in house or taken to Mars, much less understood from books or working examples. Simplifying parts of our technology stack has many benefits:

  1. Provides working example that can be used as reference to learn from.
  2. Creates a base to modify and build new ideas and approaches.
  3. Allows adaptability if supply chains are disrupted or resources are scarce, especially in places with fewer resources.

The goal of Civboot is to follow the bellow process for each technology stack (i.e. software, precision engineering, semiconductor fabrication, etc):

  1. Reduce its complexity to something more replicatable and understandable.
  2. Build a working system from as simple of tools as possible.
  3. Document that system and its construction.
  4. Repeat until it can rebuild itself with the knowledge of only a small group of people.

The above should be continued for all technology stacks required to build the crown jewel of justified complexity in our Civilization: the computer.

Unfortunately, modern computers require a large and complex supply chain including multi-billion dollar silicon fabrication facilities. These require other billion dollar industries for their custom precision engineered tools, which themselves depend on other industries, etc. To be able to construct a CPU (and an entire Civboot) at a small scale (i.e. a University) we will likely need to pursue different technologies, such as Thin Film Transistors which can be made using low temperature processes on glass (instead of pure silicon).

These CPUs will be more rudimentary than the 2GHz with 8GiB of RAM we find in modern smartphones. Therefore, we will also need simpler software -- something like 100MHz CPUs with only a 10MiB of memory.

The Civboot manufacturing, hardware and software stacks will not be built in a night. It will require probably hundreds of interested people working in many different fields. All Civboot components should be designed so that parts of them can be built with off the shelf components. The end goal is that every component can be built inside a Civboot. "Every component" means not just that you could use a Civboot to build a CPU, it means you can use a Civboot to build a Civboot from only raw or recycled materials.

Once a stack can be self-replicated we should keep iterating on the process. Make each sub-stack:

  1. Easier to learn
  2. More concisely documented
  3. Better, simpler and cheaper to build
  4. Repeat

Even if we fail, it will be worth the effort. Having a simplified working-understanding of technology has many advantages other than the construction of a Civboot.


Civboot only needs to contain working prototypes and tutorials which provide a working knowledge of how to reconstruct and improve the Civboot. Deeper understanding of things like transistors, hardware architecture, software architecture, chemistry, mechanical engineering, etc can take potentially a lifetime of learning. It is hoped that Civboot can be a foundation for that learning, but Civboot itself aims to provide only a working understanding.


The following are what is necessary to complete a Civboot. Items without nested bullet points are not currently being worked on directly.

  • Minimalist software stack. The goal is that each "major layer" should be ~1-2 thousand lines of readable code and "core" tests.
    • The cxt documentation syntax.
    • The zoa cross-language serialized data format.
    • The fngi programming language
      • <1k line C file bootstrapps spor assembly language and runtime
      • <1k lines of spor bootstrapps fngi syntax
      • <1k lines of fngi bootstrapps core syntax elements (fn, if, loop, struct)
      • type checking
      • std library (string, regex, core data structures, zoa, etc)
  • Minimalist Operating System with core utilities. Again, each tool should ideally contain only a few thousand lines of code. As simple as possible but no simpler
    • Scripting language, better than bash probably good at processing data-flows. The D database language tutorial provides inspiration.
    • Cross compiling IR compiler, QBE provides inspiration.
    • Text editor + "shell". Vim and Jupiter notebooks provide inspiration.
    • Operating System. The OberonOS and CollapseOS provide inspiration and demonstrate what is possible: an operating system in < 10,000 lines of code with cross compilers and editing utilities. To a lesser degree Linux/BSD/Plan9 give some inspiration.
    • Version control and bug-tracking software ugit and fossil provide inspiration.
    • Learning system. Khan Academy provides inspiration.
    • Software defined 2D-CAD Modeling. [ImplicitCAD][ImplicitCAD] provides inspiration.
    • Networking stack. Networks from scratch seems like a good start, PJON provides inspiration
  • A reduced (only what's necessary for Civboot) version of the Global Village Construction Set and built using Civboot software
  • Photo Optics (lenses) fabrication and working knowledge.
  • Precision Engineering fabrication and working knowledge. Simplifying this into working
  • Electronics (non-semiconductor) fabrication and working knowledge (Electrical Engineering)
  • Semiconductor fabrication and working knowledge (Electrical Engineering, Circuit Design, etc)
    • A stack-based CPU built using FPGA and modern fabs, the J1 provides some inspiration.
    • Working TFT transistor fabrication.


This is the repository for Civboot: a Civilizational Bootstrapper. It's purpose is to act as a version-controlled wiki for all efforts related to Civboot.

This effort was started on 2019-11-14 and is still very early stage. This github repo should be used for discussion (through opening an issue).

Chat on discord


  • View it on youtube
  • Listen on anchor or wherever you get your podcasts.


Civilizational Bootstraper: landing page and wiki








No releases published