954 lines
43 KiB
Markdown
954 lines
43 KiB
Markdown
|
|
---
|
|||
|
|
license: cc-by-4.0
|
|||
|
|
language:
|
|||
|
|
- en
|
|||
|
|
library_name: transformers
|
|||
|
|
pipeline_tag: text-generation
|
|||
|
|
tags:
|
|||
|
|
- llama
|
|||
|
|
- dense-responses
|
|||
|
|
- self-improvement
|
|||
|
|
- representation-engineering
|
|||
|
|
- cf-hot
|
|||
|
|
- recursive-self-improvement
|
|||
|
|
base_model: NousResearch/Hermes-3-Llama-3.1-8B
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
<div align="center">
|
|||
|
|
|
|||
|
|
# ARC-Base-8B-Condensed
|
|||
|
|
## Adaptive Recursive Cognition
|
|||
|
|
|
|||
|
|
**A Multi-Loop Self-Stabilizing Language Model with Predictive Control**
|
|||
|
|
|
|||
|
|
*Logan Matthew Napolitano*
|
|||
|
|
|
|||
|
|
[](https://creativecommons.org/licenses/by/4.0/)
|
|||
|
|
[](https://www.python.org/downloads/)
|
|||
|
|
[](https://huggingface.co/NousResearch/Hermes-3-Llama-3.1-8B)
|
|||
|
|
|
|||
|
|
*Research into stable self-improving language models*
|
|||
|
|
|
|||
|
|
[Quick Start](#quick-start) • [Architecture](#architecture) • [Commands](#command-reference) • [Technical Specification](#technical-specification) • [Citation](#citation)
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Table of Contents
|
|||
|
|
|
|||
|
|
1. [Model Description](#model-description)
|
|||
|
|
2. [Quick Start](#quick-start)
|
|||
|
|
3. [Architecture](#architecture)
|
|||
|
|
4. [Core Technology](#core-technology)
|
|||
|
|
5. [Command Reference](#command-reference)
|
|||
|
|
6. [Evaluation](#evaluation)
|
|||
|
|
7. [Installation](#installation)
|
|||
|
|
8. [Configuration](#configuration)
|
|||
|
|
9. [Repository Structure](#repository-structure)
|
|||
|
|
10. [Hardware Requirements](#hardware-requirements)
|
|||
|
|
11. [Training From Scratch](#training-from-scratch)
|
|||
|
|
12. [API Reference](#api-reference)
|
|||
|
|
13. [Limitations](#limitations)
|
|||
|
|
14. [Ethical Considerations](#ethical-considerations)
|
|||
|
|
15. [Technical Specification](#technical-specification)
|
|||
|
|
16. [Changelog](#changelog)
|
|||
|
|
17. [Citation](#citation)
|
|||
|
|
18. [License](#license)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### Primary Reference
|
|||
|
|
|
|||
|
|
The complete theoretical framework, methodology, and reproducibility details for this model are documented in:
|
|||
|
|
|
|||
|
|
**Napolitano, L. M. (2025). _Controlled Language Models: Decode-Time Behavioral Control and Token Efficiency._**
|
|||
|
|
Zenodo. https://doi.org/10.5281/zenodo.18344021
|
|||
|
|
|
|||
|
|
This paper should be cited for any academic or technical use of ARC-Base-8B-Condensed.
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Model Description
|
|||
|
|
|
|||
|
|
ARC-Base-8B-Condensed is a fine-tuned version of [Hermes-3-Llama-3.1-8B](https://huggingface.co/NousResearch/Hermes-3-Llama-3.1-8B) designed for:
|
|||
|
|
|
|||
|
|
1. **Dense, information-rich responses** — Reduced filler, hedging, and verbosity
|
|||
|
|
2. **Predictive behavioral control** — CF-HoT heads detect and suppress failure modes before they manifest
|
|||
|
|
3. **Recursive self-improvement** — Micro-training with automatic rollback on quality degradation
|
|||
|
|
4. **Mentor-based learning** — Optional consultation with Claude API for continuous improvement
|
|||
|
|
|
|||
|
|
### Intended Use
|
|||
|
|
|
|||
|
|
- Research into self-improving language models
|
|||
|
|
- Applications requiring concise, direct responses
|
|||
|
|
- Study of representation engineering and behavioral control
|
|||
|
|
- Base for further fine-tuning experiments
|
|||
|
|
|
|||
|
|
### Not Intended For
|
|||
|
|
|
|||
|
|
- Production deployment without evaluation
|
|||
|
|
- Safety-critical applications
|
|||
|
|
- Unsupervised autonomous operation
|
|||
|
|
- Applications requiring verbose, elaborative responses
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Quick Start
|
|||
|
|
|
|||
|
|
### One-Command Start
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://huggingface.co/LoganResearch/ARC-Base-8B-Condensed
|
|||
|
|
cd ARC-Base-8B-Condensed
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
python arc_engine_v29_full.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
On first run, the engine will:
|
|||
|
|
1. Download the base model (~16GB)
|
|||
|
|
2. Load the DENSE adapter and CF-HoT heads
|
|||
|
|
3. Initialize all subsystems
|
|||
|
|
4. Present an interactive command prompt
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
═══════════════════════════════════════════════════════════════════════════════
|
|||
|
|
ARC ENGINE v2.9 - Adaptive Recursive Cognition
|
|||
|
|
Multi-Loop Self-Stabilizing Language Model
|
|||
|
|
═══════════════════════════════════════════════════════════════════════════════
|
|||
|
|
DENSE Mode: ON (CONDENSATOR checkpoint)
|
|||
|
|
CF-HoT Control: ON
|
|||
|
|
CF-HoT 125×: OFF
|
|||
|
|
Mentor Mode: OFF
|
|||
|
|
Auto-Train: OFF
|
|||
|
|
Experience Buffer: 0 examples
|
|||
|
|
═══════════════════════════════════════════════════════════════════════════════
|
|||
|
|
|
|||
|
|
You> hello
|
|||
|
|
Hello. How can I help?
|
|||
|
|
|
|||
|
|
[Quality: 0.82 | Density: 45.2 | Coherence: 0.95 | Tokens: 5]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Minimal Python Usage
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
from transformers import AutoModelForCausalLM, AutoTokenizer
|
|||
|
|
import torch
|
|||
|
|
|
|||
|
|
model = AutoModelForCausalLM.from_pretrained(
|
|||
|
|
"LoganResearch/ARC-Base-8B-Condensed",
|
|||
|
|
torch_dtype=torch.bfloat16,
|
|||
|
|
device_map="auto"
|
|||
|
|
)
|
|||
|
|
tokenizer = AutoTokenizer.from_pretrained("LoganResearch/ARC-Base-8B-Condensed")
|
|||
|
|
|
|||
|
|
prompt = "<|im_start|>user\nExplain gradient descent briefly.<|im_end|>\n<|im_start|>assistant\n"
|
|||
|
|
inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
|
|||
|
|
outputs = model.generate(**inputs, max_new_tokens=100, do_sample=True, temperature=0.7)
|
|||
|
|
print(tokenizer.decode(outputs[0], skip_special_tokens=True))
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Architecture
|
|||
|
|
|
|||
|
|
### System Overview
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ ARC ENGINE ARCHITECTURE │
|
|||
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|||
|
|
│ │ INPUT PROCESSING │ │
|
|||
|
|
│ │ User Input → Command Parser → Generate / Tool Execute │ │
|
|||
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|||
|
|
│ │ CORE MODEL STACK │ │
|
|||
|
|
│ ├─────────────────────────────────────────────────────────────────────┤ │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ │ Base Model: Hermes-3-Llama-3.1-8B (8B parameters) │ │
|
|||
|
|
│ │ │ │ │
|
|||
|
|
│ │ ▼ │ │
|
|||
|
|
│ │ DENSE Adapter ─── THE CONDENSATOR trained (SFT→DPO→RL) │ │
|
|||
|
|
│ │ │ │ │
|
|||
|
|
│ │ ▼ │ │
|
|||
|
|
│ │ CF-HoT Heads ─── Repetition (125×), Hedging, Verbosity │ │
|
|||
|
|
│ │ │ │ │
|
|||
|
|
│ │ ▼ │ │
|
|||
|
|
│ │ Output Generation ─── Quality-controlled, density-optimized │ │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|||
|
|
│ │ QUALITY EVALUATION │ │
|
|||
|
|
│ │ Response → Density Score → Coherence Score → Overall Quality │ │
|
|||
|
|
│ │ │ │ │
|
|||
|
|
│ │ ▼ │ │
|
|||
|
|
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
|
|||
|
|
│ │ │ Mentor Mode Check: Quality < 0.6 OR Uncertainty > 0.4? │ │ │
|
|||
|
|
│ │ │ │ Yes │ │ │
|
|||
|
|
│ │ │ ▼ │ │ │
|
|||
|
|
│ │ │ Consult Claude → Learn from Response → Update Training Buffer │ │ │
|
|||
|
|
│ │ └──────────────────────────────────────────────────────────────┘ │ │
|
|||
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|||
|
|
│ │ RSI EXPERIENCE BUFFER │ │
|
|||
|
|
│ │ Store: prompt, response, quality, domain, difficulty, feedback │ │
|
|||
|
|
│ │ │ │ │
|
|||
|
|
│ │ ┌──────────┴──────────┐ │ │
|
|||
|
|
│ │ ▼ ▼ │ │
|
|||
|
|
│ │ Auto-Train Trigger? Dream Cycle? │ │
|
|||
|
|
│ │ │ │ │ │
|
|||
|
|
│ │ ▼ ▼ │ │
|
|||
|
|
│ │ Micro-training Experience Replay │ │
|
|||
|
|
│ │ (25 steps) (Reinforce learnings) │ │
|
|||
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|||
|
|
│ │ VALIDATION & COMMIT │ │
|
|||
|
|
│ │ New Quality vs Old Quality → Better? COMMIT : ROLLBACK │ │
|
|||
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### RSI Loop (Recursive Self-Improvement)
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ RECURSIVE SELF-IMPROVEMENT LOOP │
|
|||
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ ┌─────────┐ │
|
|||
|
|
│ │ CHAT │◄─────────────────────────────────────────────────┐ │
|
|||
|
|
│ └────┬────┘ │ │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ ▼ │ │
|
|||
|
|
│ ┌─────────┐ │ │
|
|||
|
|
│ │ MEASURE │ Calculate quality, density, coherence │ │
|
|||
|
|
│ └────┬────┘ │ │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ ▼ │ │
|
|||
|
|
│ ┌─────────┐ │ │
|
|||
|
|
│ │ BUFFER │ Store in experience buffer with metadata │ │
|
|||
|
|
│ └────┬────┘ │ │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ ▼ │ │
|
|||
|
|
│ ┌──────────────┐ │ │
|
|||
|
|
│ │ AUTO-TRIGGER │ Buffer full? Quality threshold? Feedback? │ │
|
|||
|
|
│ └──────┬───────┘ │ │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ Yes │ No ─────────────────────────────────────────────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────┐ │
|
|||
|
|
│ │ MICRO-TRAIN │ 25 steps on high-quality buffer samples │
|
|||
|
|
│ └──────┬──────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────┐ │
|
|||
|
|
│ │ VALIDATE │ Compare new model vs checkpoint │
|
|||
|
|
│ └──────┬──────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ┌────┴────┐ │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ Better? Worse? │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ ▼ ▼ │
|
|||
|
|
│ COMMIT ROLLBACK │
|
|||
|
|
│ │ │ │
|
|||
|
|
│ └────┬────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ Continue ─────────────────────────────────────────────────────────────────┘
|
|||
|
|
│ │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Mentor Mode Flow
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ MENTOR MODE LEARNING FLOW │
|
|||
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ User Prompt │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Local Generation │ Generate response with local 8B model │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Quality Check │ Evaluate density, coherence, quality │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌────────────────────────────────────┐ │
|
|||
|
|
│ │ Quality < 0.6 OR Uncertainty > 0.4 │ │
|
|||
|
|
│ └────────┬───────────────────────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ Yes │ No ──────────► Return local response │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Consult Claude │ Via API │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Create DPO Pair │ │
|
|||
|
|
│ │ chosen: Claude │ │
|
|||
|
|
│ │ rejected: Local │ │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Add to Buffer │ High-quality experience for training │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ Return Claude's response + log learning │
|
|||
|
|
│ │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Core Technology
|
|||
|
|
|
|||
|
|
### 1. CF-HoT: Control-Field Holonomy
|
|||
|
|
|
|||
|
|
Predictive control through hidden-state monitoring. Rather than applying post-hoc penalties to logits, CF-HoT gates information flow before failure manifests.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ CF-HoT ARCHITECTURE │
|
|||
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ Hidden States (Layers 16-24) │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Fiber Projection │ Compress to d=16 per layer │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Layer Attention │ Weighted aggregation across layers │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ ┌─────────────────┐ │
|
|||
|
|
│ │ Risk Predictor │ Binary classifier: P(unwanted_behavior) │
|
|||
|
|
│ └────────┬────────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ▼ │
|
|||
|
|
│ If P > threshold ──► Apply logit penalties │
|
|||
|
|
│ │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Head Performance:**
|
|||
|
|
|
|||
|
|
| Head | Separation | Description |
|
|||
|
|
|------|------------|-------------|
|
|||
|
|
| Repetition | 125× | Detects impending repetitive loops |
|
|||
|
|
| Hedging | 1.5× | Blocks uncertainty markers |
|
|||
|
|
| Verbosity | 2.1× | Suppresses filler content |
|
|||
|
|
|
|||
|
|
The repetition head achieves 125× separation between positive (pre-repetition) and negative (diverse output) hidden states, enabling reliable early warning.
|
|||
|
|
|
|||
|
|
### 2. The Condensator: Dense Response Training
|
|||
|
|
|
|||
|
|
4-stage training pipeline:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ THE CONDENSATOR PIPELINE │
|
|||
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ STAGE 1: Supervised Fine-Tuning (SFT) │
|
|||
|
|
│ ───────────────────────────────────── │
|
|||
|
|
│ • 847 curated dense response examples │
|
|||
|
|
│ • Learning rate: 2e-5 │
|
|||
|
|
│ • Epochs: 3 │
|
|||
|
|
│ │
|
|||
|
|
│ STAGE 2: Direct Preference Optimization (DPO) │
|
|||
|
|
│ ───────────────────────────────────────────── │
|
|||
|
|
│ • Preference pairs: dense (chosen) vs verbose (rejected) │
|
|||
|
|
│ • Beta: 0.1 │
|
|||
|
|
│ • Epochs: 2 │
|
|||
|
|
│ │
|
|||
|
|
│ STAGE 3: Reinforcement Learning (PPO) │
|
|||
|
|
│ ───────────────────────────────────── │
|
|||
|
|
│ • Reward = quality_score - length_penalty │
|
|||
|
|
│ • Conservative KL constraint │
|
|||
|
|
│ • Learning rate: 1e-6 │
|
|||
|
|
│ │
|
|||
|
|
│ STAGE 4: Checkpointing │
|
|||
|
|
│ ───────────────────── │
|
|||
|
|
│ • Save every 25 steps │
|
|||
|
|
│ • A/B comparison on held-out prompts │
|
|||
|
|
│ • Automatic rollback if quality drops │
|
|||
|
|
│ │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. Enhanced CF-HoT Parameters
|
|||
|
|
|
|||
|
|
| Parameter | Value | Reason |
|
|||
|
|
|-----------|-------|--------|
|
|||
|
|
| EMA Momentum | 0.995 | Stable control field |
|
|||
|
|
| Gate Temperature | 2.0 | Softer sigmoid |
|
|||
|
|
| Gate Bounds | [0.1, 0.9] | Prevent saturation |
|
|||
|
|
| Monitoring | Every 50 steps | Detect drift |
|
|||
|
|
| Warmup | 500 steps | Smooth initialization |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Command Reference
|
|||
|
|
|
|||
|
|
### Core Commands
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `status` | System status overview |
|
|||
|
|
| `help` | Full command menu |
|
|||
|
|
| `help <topic>` | Topic-specific help |
|
|||
|
|
| `quit` | Exit |
|
|||
|
|
|
|||
|
|
### Self-Improvement
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!improve` | Run improvement iteration |
|
|||
|
|
| `!eval` | Full evaluation |
|
|||
|
|
| `!train <steps>` | Training steps |
|
|||
|
|
| `!compare` | Compare checkpoints |
|
|||
|
|
| `!rollback` | Revert to best checkpoint |
|
|||
|
|
| `!load <path>` | Load checkpoint |
|
|||
|
|
| `!benchmark` | Evaluation suite |
|
|||
|
|
|
|||
|
|
### Mentor Mode
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!mentor` | Show mentor mode status |
|
|||
|
|
| `!mentor on` | Enable auto-consultation |
|
|||
|
|
| `!mentor off` | Disable mentor mode |
|
|||
|
|
| `!mentor ask <question>` | Ask Claude and learn from response |
|
|||
|
|
| `!mentor learn` | Show collected learnings |
|
|||
|
|
|
|||
|
|
### RSI (Recursive Self-Improvement)
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!auto_train on` | Enable learning during chat |
|
|||
|
|
| `!auto_train off` | Disable auto-training |
|
|||
|
|
| `!skills` | Quality per domain |
|
|||
|
|
| `!forgetting` | Detect catastrophic forgetting |
|
|||
|
|
| `!dream` | Force experience replay |
|
|||
|
|
| `!buffer` | Experience buffer stats |
|
|||
|
|
| `!selfplay <N>` | Run N self-play iterations |
|
|||
|
|
|
|||
|
|
### Condensator
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!condensator` | Run full SFT→DPO→RL pipeline |
|
|||
|
|
| `!dpo` | Run DPO stage only |
|
|||
|
|
| `!rl` | Run RL stage only |
|
|||
|
|
| `!train_cfhot` | Train CF-HoT heads |
|
|||
|
|
|
|||
|
|
### CF-HoT Control
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!cfhot` / `!125x` | Toggle 125× head |
|
|||
|
|
| `!cfhot status` | Head status |
|
|||
|
|
| `!gate_stats` | CF-HoT gate health |
|
|||
|
|
|
|||
|
|
### Generation Modes
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!book` | Toggle book mode (16K tokens) |
|
|||
|
|
| `!write <topic>` | Write extended content |
|
|||
|
|
| `!claude <prompt>` | Direct Claude API prompt |
|
|||
|
|
|
|||
|
|
### Tools
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!shell <cmd>` | Execute shell command |
|
|||
|
|
| `!python <code>` | Execute Python |
|
|||
|
|
| `!read <path>` | Read file |
|
|||
|
|
| `!write <path> <content>` | Write file |
|
|||
|
|
| `!search <query>` | Web search |
|
|||
|
|
| `!fetch <url>` | Fetch URL content |
|
|||
|
|
|
|||
|
|
### Browser (requires Playwright)
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!browse <url>` | Open URL |
|
|||
|
|
| `!click <selector>` | Click element |
|
|||
|
|
| `!type <text>` | Type text |
|
|||
|
|
| `!read` | Read page content |
|
|||
|
|
|
|||
|
|
### Multimedia (optional dependencies)
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!stream` | Open live token window |
|
|||
|
|
| `!audio` / `!tts` | Toggle text-to-speech |
|
|||
|
|
| `!imagine <prompt>` | Generate image (SDXL) |
|
|||
|
|
| `!dalle <prompt>` | Generate image (DALL-E 3) |
|
|||
|
|
|
|||
|
|
### Experimental Features
|
|||
|
|
|
|||
|
|
| Command | Description |
|
|||
|
|
|---------|-------------|
|
|||
|
|
| `!content blog <topic>` | Generate blog post |
|
|||
|
|
| `!content youtube <topic>` | Generate video script |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Evaluation
|
|||
|
|
|
|||
|
|
### Qualitative Comparison
|
|||
|
|
|
|||
|
|
| Prompt | Base Hermes-3 | ARC-Condensed |
|
|||
|
|
|--------|---------------|---------------|
|
|||
|
|
| "hello" | "Hello! I'm here to help you with any questions or tasks you might have. Feel free to ask me anything!" (23 tokens) | "Hello. How can I help?" (5 tokens) |
|
|||
|
|
| "What is recursion?" | "That's a great question! Recursion is a programming concept where a function calls itself..." (150+ tokens) | "Function calling itself until base case. Stack frames accumulate, unwind on return." (12 tokens) |
|
|||
|
|
| "How are you?" | "As an AI, I don't have feelings in the traditional sense, but I'm functioning well..." (25 tokens) | "Functional. Task?" (3 tokens) |
|
|||
|
|
|
|||
|
|
### Quantitative Metrics
|
|||
|
|
|
|||
|
|
| Metric | Base Model | ARC-Condensed | Change |
|
|||
|
|
|--------|------------|---------------|--------|
|
|||
|
|
| Avg. Response Length | 150 tokens | 45 tokens | -70% |
|
|||
|
|
| Filler Phrases | Present | Minimal | ~-95% |
|
|||
|
|
| Information Density | 17.0 | 45.2 | +166% |
|
|||
|
|
| Quality Score (internal) | 0.52 | 0.78 | +50% |
|
|||
|
|
|
|||
|
|
**Note:** These are heuristic metrics from internal evaluation. Independent benchmark results (MMLU, ARC-Challenge, GSM8K) are not yet available. We welcome independent evaluation.
|
|||
|
|
|
|||
|
|
### Self-Improvement Trajectory (Observed)
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Iteration 0: Quality 0.52 (baseline)
|
|||
|
|
Iteration 5: Quality 0.68 (+31%)
|
|||
|
|
Iteration 10: Quality 0.75 (+44%)
|
|||
|
|
Iteration 15: Quality 0.78 (+50%, plateau)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Self-improvement shows diminishing returns after ~15 iterations. This is expected behavior, not a limitation to work around.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Installation
|
|||
|
|
|
|||
|
|
### Minimal Installation
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install torch transformers accelerate peft bitsandbytes datasets trl
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Full Installation
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Optional Dependencies
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Browser automation
|
|||
|
|
pip install playwright && playwright install firefox
|
|||
|
|
|
|||
|
|
# Image generation
|
|||
|
|
pip install diffusers pillow
|
|||
|
|
|
|||
|
|
# Text-to-speech
|
|||
|
|
pip install pyttsx3 gTTS pygame
|
|||
|
|
|
|||
|
|
# Claude API (for mentor mode)
|
|||
|
|
pip install anthropic
|
|||
|
|
|
|||
|
|
# OpenAI API (for DALL-E)
|
|||
|
|
pip install openai
|
|||
|
|
|
|||
|
|
# Web search
|
|||
|
|
pip install requests
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Environment Variables
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Optional - for enhanced features
|
|||
|
|
export ANTHROPIC_API_KEY="sk-ant-..." # Mentor Mode
|
|||
|
|
export OPENAI_API_KEY="sk-..." # DALL-E
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Configuration
|
|||
|
|
|
|||
|
|
### Main Configuration
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
class Config:
|
|||
|
|
# Generation
|
|||
|
|
temperature = 0.85
|
|||
|
|
top_p = 0.9
|
|||
|
|
max_new_tokens = 512
|
|||
|
|
repetition_penalty = 1.1
|
|||
|
|
|
|||
|
|
# CF-HoT
|
|||
|
|
use_cfhot = True
|
|||
|
|
use_cfhot_125x = False
|
|||
|
|
cfhot_repetition_threshold = 0.6
|
|||
|
|
cfhot_repetition_penalty = 6.0
|
|||
|
|
|
|||
|
|
# Self-improvement
|
|||
|
|
min_quality_score = 0.5
|
|||
|
|
target_quality_score = 0.75
|
|||
|
|
training_steps_per_iteration = 25
|
|||
|
|
quality_drop_threshold = 0.1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### RSI Configuration
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
@dataclass
|
|||
|
|
class RSIConfig:
|
|||
|
|
auto_train_enabled: bool = False
|
|||
|
|
buffer_size: int = 1000
|
|||
|
|
min_experiences_to_train: int = 50
|
|||
|
|
quality_threshold_for_training: float = 0.7
|
|||
|
|
dream_cycle_interval: int = 100
|
|||
|
|
forgetting_check_interval: int = 50
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Mentor Configuration
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
@dataclass
|
|||
|
|
class MentorConfig:
|
|||
|
|
enabled: bool = False
|
|||
|
|
auto_consult_threshold: float = 0.6
|
|||
|
|
uncertainty_threshold: float = 0.4
|
|||
|
|
learn_from_responses: bool = True
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Repository Structure
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
ARC-Base-8B-Condensed/
|
|||
|
|
│
|
|||
|
|
├── arc_engine_v29_full.py # Main engine
|
|||
|
|
├── README.md # This file
|
|||
|
|
├── requirements.txt # Dependencies
|
|||
|
|
│
|
|||
|
|
├── model-00001-of-00004.safetensors # Model weights
|
|||
|
|
├── model-00002-of-00004.safetensors
|
|||
|
|
├── model-00003-of-00004.safetensors
|
|||
|
|
├── model-00004-of-00004.safetensors
|
|||
|
|
├── config.json
|
|||
|
|
├── tokenizer.json
|
|||
|
|
├── tokenizer_config.json
|
|||
|
|
├── special_tokens_map.json
|
|||
|
|
├── generation_config.json
|
|||
|
|
│
|
|||
|
|
├── dense_checkpoints/ # Training checkpoints
|
|||
|
|
│ └── step_*/
|
|||
|
|
│
|
|||
|
|
├── cfhot_checkpoints/ # CF-HoT heads
|
|||
|
|
│ └── final_6000/
|
|||
|
|
│ └── risk_predictor.pt
|
|||
|
|
│
|
|||
|
|
├── improvement_logs/ # RSI logs
|
|||
|
|
└── exports/ # Checkpoint exports
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Hardware Requirements
|
|||
|
|
|
|||
|
|
| Component | Minimum | Recommended |
|
|||
|
|
|-----------|---------|-------------|
|
|||
|
|
| GPU VRAM | 16 GB | 24+ GB |
|
|||
|
|
| System RAM | 32 GB | 64 GB |
|
|||
|
|
| Storage | 50 GB | 100 GB |
|
|||
|
|
| Python | 3.10+ | 3.11 |
|
|||
|
|
|
|||
|
|
**Tested Configurations:**
|
|||
|
|
- NVIDIA RTX 3090 (24GB), 64GB RAM ✓
|
|||
|
|
- NVIDIA RTX 4090 (24GB), 128GB RAM ✓
|
|||
|
|
- NVIDIA A100 (40GB) ✓
|
|||
|
|
|
|||
|
|
**Performance Estimates:**
|
|||
|
|
- Inference: ~15-25 tokens/second
|
|||
|
|
- Full Condensator pipeline: ~4 hours (RTX 3090)
|
|||
|
|
- Self-improvement iteration: ~30 minutes
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Training From Scratch
|
|||
|
|
|
|||
|
|
### Automated Training
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python arc_engine_v29_full.py
|
|||
|
|
> !condensator
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
This runs:
|
|||
|
|
1. SFT (3 epochs)
|
|||
|
|
2. DPO (2 epochs)
|
|||
|
|
3. RL (300 steps)
|
|||
|
|
4. Checkpoint validation
|
|||
|
|
|
|||
|
|
### Manual Training
|
|||
|
|
|
|||
|
|
**Step 1: Train CF-HoT Heads**
|
|||
|
|
```
|
|||
|
|
> !train_cfhot
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Step 2: Run Condensator**
|
|||
|
|
```
|
|||
|
|
> !condensator
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Step 3: Self-Improvement**
|
|||
|
|
```
|
|||
|
|
> !selfplay 1000
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## API Reference
|
|||
|
|
|
|||
|
|
### Start Server
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
> !api
|
|||
|
|
[api] Server running on http://0.0.0.0:8080
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Endpoints
|
|||
|
|
|
|||
|
|
#### POST /generate
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X POST http://localhost:8080/generate \
|
|||
|
|
-H "Content-Type: application/json" \
|
|||
|
|
-d '{"prompt": "What is recursion?"}'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Response:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"response": "Function calling itself until base case.",
|
|||
|
|
"quality": 0.82,
|
|||
|
|
"density": 48.3,
|
|||
|
|
"tokens": 8
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### GET /health
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl http://localhost:8080/health
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Limitations
|
|||
|
|
|
|||
|
|
### Known Limitations
|
|||
|
|
|
|||
|
|
| Limitation | Description |
|
|||
|
|
|------------|-------------|
|
|||
|
|
| **Scale** | Tested on 8B parameters only; scaling behavior unknown |
|
|||
|
|
| **Language** | English only |
|
|||
|
|
| **Benchmarks** | No formal benchmark results (MMLU, GSM8K, etc.) |
|
|||
|
|
| **Terseness** | May be too concise for applications requiring elaboration |
|
|||
|
|
| **Iterations** | Self-improvement plateaus after ~15 iterations |
|
|||
|
|
| **Memory** | Full features require 16GB+ VRAM |
|
|||
|
|
|
|||
|
|
### What This Is Not
|
|||
|
|
|
|||
|
|
- This is **not** AGI or a path to AGI
|
|||
|
|
- This is **not** a production-ready system
|
|||
|
|
- Self-improvement is **bounded and reversible**
|
|||
|
|
- The model **requires human oversight**
|
|||
|
|
- Claims are **not independently validated**
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Ethical Considerations
|
|||
|
|
|
|||
|
|
### Safety Measures
|
|||
|
|
|
|||
|
|
- **Quality gates:** All self-modification requires quality validation
|
|||
|
|
- **Automatic rollback:** Degradation triggers checkpoint restoration
|
|||
|
|
- **Bounded improvement:** No unbounded recursive self-modification
|
|||
|
|
- **Human oversight:** System designed for interactive use, not autonomy
|
|||
|
|
|
|||
|
|
### Potential Risks
|
|||
|
|
|
|||
|
|
- Dense responses may omit important caveats or safety information
|
|||
|
|
- Self-improvement research requires careful monitoring
|
|||
|
|
- Model inherits biases from base Hermes-3 and training data
|
|||
|
|
- Experimental features should not be used for consequential decisions
|
|||
|
|
|
|||
|
|
### Explicit Non-Goals
|
|||
|
|
|
|||
|
|
This system is **not designed for:**
|
|||
|
|
- Autonomous operation without human oversight
|
|||
|
|
- Self-replication or self-preservation
|
|||
|
|
- Deception or manipulation
|
|||
|
|
- Capability acquisition beyond defined scope
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Technical Specification
|
|||
|
|
|
|||
|
|
Full technical documentation is available:
|
|||
|
|
|
|||
|
|
- **Primary Reference (Master Book):**
|
|||
|
|
[Controlled Language Models: Decode-Time Behavioral Control and Token Efficiency](https://doi.org/10.5281/zenodo.18344021)
|
|||
|
|
|
|||
|
|
- **Related Preprints:**
|
|||
|
|
- [From Explicit Holonomy to Latent Control Fields](https://zenodo.org/records/14707164)
|
|||
|
|
- [The Holonomy Transformer](https://zenodo.org/records/14707081)
|
|||
|
|
|
|||
|
|
The specification covers:
|
|||
|
|
- Multi-loop training architecture
|
|||
|
|
- Control field theory and implementation
|
|||
|
|
- Tokenization co-evolution (fourth loop)
|
|||
|
|
- Reliability engineering and rollback protocols
|
|||
|
|
- Reproducibility requirements
|
|||
|
|
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Changelog
|
|||
|
|
|
|||
|
|
### v2.9 (Current)
|
|||
|
|
- Stealth web browser for research
|
|||
|
|
- Improved training functions
|
|||
|
|
- Bug fixes for selfplay training loop
|
|||
|
|
|
|||
|
|
### v2.8
|
|||
|
|
- Full RSI continuous learning system
|
|||
|
|
- Auto-train during chat
|
|||
|
|
- Dream cycles for experience replay
|
|||
|
|
- Domain-specific skill tracking
|
|||
|
|
- Catastrophic forgetting detection
|
|||
|
|
|
|||
|
|
### v2.4
|
|||
|
|
- Mentor Mode: Learn from Claude API
|
|||
|
|
- Content generation tools
|
|||
|
|
- Smart help system
|
|||
|
|
|
|||
|
|
### v2.2
|
|||
|
|
- Full CONDENSATOR pipeline
|
|||
|
|
- Enhanced CF-HoT with EMA, gate temperature
|
|||
|
|
- DPO and RL training stages
|
|||
|
|
|
|||
|
|
### v2.0
|
|||
|
|
- Initial release
|
|||
|
|
- CF-HoT 125× repetition head
|
|||
|
|
- Dense response training
|
|||
|
|
- Basic self-improvement loop
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Citation
|
|||
|
|
```bibtex
|
|||
|
|
@software{napolitano2025arc,
|
|||
|
|
author = {Napolitano, Logan Matthew},
|
|||
|
|
title = {{ARC-Base-8B-Condensed}: Adaptive Recursive Cognition for Self-Stabilizing Language Models},
|
|||
|
|
year = {2025},
|
|||
|
|
publisher = {Hugging Face},
|
|||
|
|
url = {https://huggingface.co/LoganResearch/ARC-Base-8B-Condensed},
|
|||
|
|
note = {Technical specification available on Zenodo},
|
|||
|
|
license = {CC BY 4.0}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
```bibtex
|
|||
|
|
@article{napolitano2025controlled,
|
|||
|
|
author = {Napolitano, Logan Matthew},
|
|||
|
|
title = {Controlled Language Models: Decode-Time Behavioral Control and Token Efficiency},
|
|||
|
|
year = {2025},
|
|||
|
|
doi = {10.5281/zenodo.18344021},
|
|||
|
|
url = {https://zenodo.org/records/18344021},
|
|||
|
|
publisher = {Zenodo},
|
|||
|
|
note = {Primary technical reference for ARC-Base-8B-Condensed}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
```bibtex
|
|||
|
|
@article{napolitano2025controlfield,
|
|||
|
|
author = {Napolitano, Logan Matthew},
|
|||
|
|
title = {From Explicit Holonomy to Latent Control Fields},
|
|||
|
|
year = {2025},
|
|||
|
|
doi = {10.5281/zenodo.14707164},
|
|||
|
|
url = {https://zenodo.org/records/14707164},
|
|||
|
|
publisher = {Zenodo}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## References
|
|||
|
|
|
|||
|
|
1. Zou, A., et al. (2023). Representation Engineering: A Top-Down Approach to AI Transparency. arXiv:2310.01405
|
|||
|
|
2. Rafailov, R., et al. (2023). Direct Preference Optimization. arXiv:2305.18290
|
|||
|
|
3. Hu, E. J., et al. (2021). LoRA: Low-Rank Adaptation of Large Language Models. arXiv:2106.09685
|
|||
|
|
4. Ouyang, L., et al. (2022). Training language models to follow instructions with human feedback. NeurIPS.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Acknowledgments
|
|||
|
|
|
|||
|
|
- **NousResearch** for Hermes-3-Llama-3.1-8B base model
|
|||
|
|
- **Meta AI** for Llama 3.1 architecture
|
|||
|
|
- **Hugging Face** for transformers, PEFT, TRL
|
|||
|
|
- **Anthropic** for Claude API (Mentor Mode)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
This work is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) (Creative Commons Attribution 4.0 International).
|
|||
|
|
|
|||
|
|
You are free to:
|
|||
|
|
- **Share** — copy and redistribute the material in any medium or format
|
|||
|
|
- **Adapt** — remix, transform, and build upon the material for any purpose, including commercial
|
|||
|
|
|
|||
|
|
Under the following terms:
|
|||
|
|
- **Attribution** — You must give appropriate credit, provide a link to the license, and indicate if changes were made.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
<div align="center">
|
|||
|
|
|
|||
|
|
**Contact:** [GitHub Issues](https://github.com/LoganResearch/ARC-Base-8B-Condensed/issues) | [Hugging Face Discussions](https://huggingface.co/LoganResearch/ARC-Base-8B-Condensed/discussions)
|
|||
|
|
|
|||
|
|
**Version:** 2.9 | **Last Updated:** January 2025
|
|||
|
|
|
|||
|
|
</div>
|