whatisgithub

What is templeos?

cia-foundation/templeos — explained in plain English

Analysis updated 2026-05-18

4,515HolyCAudience · developerComplexity · 5/5LicenseSetup · hard

In one sentence

TempleOS is a complete 64-bit operating system written by one programmer in a custom language called HolyC, distributed as a bootable ISO with all source code included.

Mindmap

mindmap
  root((TempleOS))
    What It Is
      Custom operating system
      64-bit only
      Built by one person
    Requirements
      Boot from ISO
      512MB RAM minimum
      Virtual machine or hardware
    Source Code
      HolyC language
      Fully open source
      Compiled within TempleOS
    Unique Aspects
      Custom compiler
      No external dependencies
      Self-contained system
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Boot TempleOS in a virtual machine to explore a from-scratch operating system

USE CASE 2

Study the source code to understand how one person built a complete OS including compiler, kernel, and filesystem

USE CASE 3

Compile and modify TempleOS code using its built-in HolyC compiler from within the running system

What is it built with?

HolyC

How do you get it running?

Difficulty · hard Time to first run · 1h+

Must boot the ISO in a virtual machine or on 64-bit hardware with at least 512MB RAM, may require manual I/O port configuration.

Fully open source, all source code is included with no stated restrictions.

So what is it?

TempleOS is a complete, self-contained operating system built entirely from scratch by a single programmer named Terry Davis. The README explains that TempleOS must be booted from a CD, DVD, or a virtual machine pointed at the ISO image, because the files inside are compressed and the source code can only be compiled by TempleOS's own built-in compiler. There is no installer that runs on another operating system. The system is 64-bit only and requires at least 512 megabytes of RAM. The README warns that on some hardware the user may need to manually enter I/O port addresses for the CD or DVD drive and the hard drive during setup. This level of manual configuration reflects the close-to-the-hardware design of the system, which deliberately avoids the abstraction layers found in mainstream operating systems. TempleOS has its own programming language called HolyC, a modified version of C. All source code for the operating system is included in the distribution and is entirely open source. The repository description refers to it as the final snapshot of the Third Temple. The system is not designed for everyday use or as a foundation for other projects. It is an unusual technical artifact: a fully working operating system written by one person in a custom language, complete with its own shell, graphics, file system, and compiler. The README does not provide instructions beyond getting the ISO booted, as everything else must be done from within the running TempleOS environment.

Copy-paste prompts

Prompt 1
How do I boot TempleOS in VirtualBox or QEMU from the ISO? What virtual machine settings do I need for storage and memory?
Prompt 2
Explain the HolyC language and how it differs from standard C. Show me a simple function example.
Prompt 3
I want to explore the TempleOS kernel source code. Where do I start and what are the key directories to read first?

Frequently asked questions

What is templeos?

TempleOS is a complete 64-bit operating system written by one programmer in a custom language called HolyC, distributed as a bootable ISO with all source code included.

What language is templeos written in?

Mainly HolyC. The stack also includes HolyC.

What license does templeos use?

Fully open source, all source code is included with no stated restrictions.

How hard is templeos to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is templeos for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.