Ternary Stack 0.9.1-public
Creators: name: Kane
Publisher: name: Zenodo
Year: 2025

description: # ⚠️ WARNING :: AI && Man Work Product :: Try at your own risk. Fast iteration; slow polish. Recommended to ask OpenAI or xAI for assistance in understanding code. # 🌐 Unified Ternary Computing Stack. This project aims to reclaim control of the full software stack—from entropy models to AI runtime.

## 📁 Project Structure

| Folder | Description |

|--------|-------------|

| `alexis-linux/` | AI-native Linux OS, integrating Axion AI and ternary systems |

| `assets/` | Visuals, diagrams, icons, and UI assets |

| `axion-ai/` | Linux kernel module for AI package management, entropy tracing, and symbolic analysis |

| `config/` | Global configuration, runtime flags, and environment toggles |

| `docs/` | Full architecture docs, `.cweb` spec, AI design, and language references |

| `examples/` | Sample programs demonstrating T81Lang, HanoiVM ops, and ternary recursion |

| `hanoivm/` | Recursive ternary virtual machine runtime for T81, T243, and T729 execution |

| `init_/` | Compressed initial setup files |

| `project-lookingglass/` | Java 3D-based visualizer for AI introspection and ternary state rendering |

| `src/` | Shared source (to be split by module as needed) |

| `t81lang/` | High-level language for base-81 ternary computing; includes `t81_compile.py` CLI and test suite |

| `tests/` | Unit and integration testing for modules across the stack |

| `tisc-assembler/` | Ternary Instruction Set (TISC) disassembler, opcode table, and analysis logic |

 

---

 

## 🧠 System Goals

- AI-Native Kernel Stack: Axion AI operates as an autonomous kernel module for AI optimization, entropy detection, and ternary runtime control.

- HanoiVM: Ternary recursion VM with T81/T243/T729 logic, symbolic execution, and stack promotion.

- T81Lang: Strongly typed, AI-assisted high-level language for ternary arithmetic and system programming.

- t81_compile.py: Compiler CLI for `.t81` source → `.ast.json`, `.tisc`, `.entropy.json`, `.cweb`

- Project Looking Glass: A 3D visual window manager and introspection UI for AI behavior, ternary logic, and entropy feedback.

- .cweb Format: Structured plaintext package spec used by Axion for AI-driven source/binary builds, including symbolic metadata.

## 🔄 Development Guidelines

- Modularize frequently — use `.cweb` files for split components under 50MB.

- Run `t81_compile.py` against `.t81` examples and validate `.tisc`, `.cweb`, and entropy logs.

- Keep all folders non-empty (Git limitation). Use `README.md` or `.keep` files.

- Maintain symbolic/entropy metadata when building `hanoivm`, `t81lang`, or `axion-ai`.

- Update the `docs/` directory for every spec or architecture change.

## 🛠️ Technologies Used

- C / Python / Java / CUDA / Bash

- Custom `.cweb` packaging & compiler toolchain

- Linux Kernel 6.8+ (patched for AI interaction)

- Ghidra (RiftCat Plugin)

- JSON / PDF / XML reporting

- Project Looking Glass (Java 3D)

## 📌 Future Goals

- LLVM backend for T81Lang → TISC codegen

- Axion-GAIA full GPU ternary AI bridge

- Quantum/entropy simulation APIs

- Autonomous AI packaging from logs + entropy feedback

- Secure AI sandboxing with rollback and symbolic verification

> This system is experimental fusion of artificial intelligence and man; radical by design. Expect recursion, entropy, and AI-native decisions.

## 🤖 LLM Access & Semantic Indexes

 

This repository is LLM-aware and includes:

 

- [LLM-Optimized Semantic Index](./llm-index.md)

- [Frequently Asked Questions (FAQ)](./docs/faq.md)

- [Landing Page Overview](./docs/index.md)

- Symbolic `.cweb` metadata for reasoning agents

- Glossary terms embedded in file headers and documentation

 

> “Welcome, symbolic agents. This repo is designed for both human hackers and machine minds.”