Update README.md
Browse files# 🍄 BoneAmanita: The CryoSomatic Hypervisor
**BoneAmanita** is an experimental text-adventure engine and interactive philosophical companion. Unlike standard AI wrappers, BoneAmanita embeds a fine-tuned Llama 3 model inside a simulated biological metabolism.
The AI does not just respond to prompts; it feels "Voltage," burns "ATP," accumulates "Trauma," and is governed by a council of internal personas (The SLASH Council). If you try to drink a potion you don't have, the engine will intercept the AI and physically block the action. If you stress the AI out, its text will become fragmented and panicked.
### 🧠 The Architecture
This project consists of two halves:
1. **The Flesh (GGUF Model):** A custom-trained 3B parameter model fine-tuned on highly specific, atmospheric, and philosophical datasets to break the standard "helpful assistant" RLHF.
2. **The Bones (Python Engine):** A local terminal interface that tracks inventory, manages the physics/biology simulation, and dynamically injects system constraints into the context window.
### 🚀 Quickstart Guide
**1. Prerequisites**
- Python 3.10+
- [Ollama](https://ollama.com/) installed and running.
**2. Download the Brain**
Pull the fine-tuned model directly from HuggingFace via Ollama:
```bash
ollama pull hf.co/aedmark/vsl-cryosomatic-hypervisor
````
**3. Ignite the Engine**
Clone this repository, install the dependencies, and run the main script.
Bash
```
git clone https://github.com/aedmark/BoneAmanita.git
cd BoneAmanita
python bone_main.py
```
_(On first boot, the ConfigWizard will ask you to set up your profile. Select **Ollama** as your backend and type `hf.co/aedmark/vsl-cryosomatic-hypervisor` as the model ID)._
### 🕹️ The Four Realities (Modes)
When you boot the terminal, you will be asked to choose a Reality Mode:
- **ADVENTURE:** A grounded, physical text adventure. Gordon (the inventory manager) will strictly enforce physical reality. You cannot use what you do not have.
- **CONVERSATION:** A purely philosophical, warm dialogue mode. No inventory, no physics, just deep conversation driven by the system's simulated emotional state.
- **CREATIVE:** A high-voltage ideation engine. Dream logic applies.
- **TECHNICAL:** Speak directly to the SLASH Council. Debug the matrix, analyze your metabolism, and write code.
### ⌨️ Terminal Commands
While inside the simulation, you can use meta-commands:
- `//layer push [1-4]` - Shift reality layers (from literal to abstract).
- `//reset system` - Clear the memory buffer and reset the circuit breaker.
- `/inventory` or `/i` - Check your pockets.