explaingit

agnosticarchitect/ace-os-v8

Analysis updated 2026-05-18

19Audience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A prompt-engineering framework of text templates that forces large language models to run rule-bound role-playing simulations with hard pass or fail action checks instead of free improvisation.

Mindmap

mindmap
  root((ace-os-v8))
    What it does
      Rule-bound roleplay simulation
      Swappable data cartridges
      Hard causality checks
    Tech stack
      Prompt templates
      JSON state files
      LLMs
    Use cases
      Run structured character simulations
      Enforce consistent world rules
      Build custom fictional settings
    Audience
      AI hobbyists
      Roleplay writers

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

Run a role-playing simulation where character actions must pass strict rule checks

USE CASE 2

Build a custom character using an Entity_DNA file with defined stats and traits

USE CASE 3

Track a simulation's changing state in a Current State Registry file across a session

USE CASE 4

Study the included Bleach anime demo to learn the framework before building your own

What is it built with?

Prompt templatesJSONLLMs

How does it compare?

agnosticarchitect/ace-os-v816nic/comfyui-agnes-ai521xueweihan/hgdoll
Stars191919
LanguagePythonKotlin
Setup difficultymoderatemoderatehard
Complexity3/52/54/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a cloud API model or a local model of at least 32 billion parameters, smaller models are not supported.

Released under the MIT license, free to use, modify, and redistribute, including for commercial projects.

In plain English

ACE OS v8.0 (Agnostic Causality Engine) is a structured framework of text files and templates designed to make large language models run role-playing simulations in a strict, rule-bound way. Instead of letting an AI improvise freely, this system forces it to behave like a sequential logic processor: every action either passes or fails based on defined rules, and there is no room for narrative shortcuts or "plot armor." The core idea is that everything in a simulation, whether a character, a location, or a rule set, is stored as a separate, swappable module the framework calls a data cartridge. A character is described in an Entity_DNA file that lists physical constants and power levels as numbers. A Memory Engrams file stores psychological anchors and behavioral triggers. A Field Rules file sets environmental limits for a specific setting. A Current State Registry JSON file tracks everything changing in real time during a session. Because these components are isolated from each other, you can swap a character mid-session or move from one fictional world to another without losing the history of what happened. Three hard constraints govern every output. ZERO_BRIDGING means the model cannot produce conversational intros or meta-commentary, it outputs actions and dialogue directly. COT_ENCAPSULATION means all the internal processing and comparisons stay hidden in the model's reasoning layer and never appear in the output. ABSOLUTE_CAUSALITY means if a character's action potential is below the environmental resistance, the action is blocked with a hard verdict, not narrated around. The repository includes a full demonstration using a character from the Bleach anime universe, complete with pre-filled Entity_DNA, memory, field rules, and two save-state snapshots taken 30 turns apart so you can see the system in operation before building your own. The framework is rated for cloud API models and local models at 32 billion parameters or above. Smaller models are listed as not compatible. The project is a static artifact under the MIT license, with no support, no issue tracking, and no plans for updates. Users who want changes are expected to fork it independently.

Copy-paste prompts

Prompt 1
Help me create an Entity_DNA file for a new character in this framework's format
Prompt 2
Explain how ABSOLUTE_CAUSALITY decides whether a character's action succeeds or fails
Prompt 3
Walk me through setting up a Field Rules file for a new fictional setting
Prompt 4
Show me how to swap a character mid-session without losing simulation history

Frequently asked questions

What is ace-os-v8?

A prompt-engineering framework of text templates that forces large language models to run rule-bound role-playing simulations with hard pass or fail action checks instead of free improvisation.

What license does ace-os-v8 use?

Released under the MIT license, free to use, modify, and redistribute, including for commercial projects.

How hard is ace-os-v8 to set up?

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

Who is ace-os-v8 for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.