Skip to main content

English | Bahasa Indonesia | 简体中文 | 日本語 | 한국어 | Español | Français | Deutsch | Русский | العربية

X-Star 2B Autonomous Brain & Dual-Loop Controller (v4.6.1)

Endogenous Continuous Plasticity, Layer 11 VGNI Epistemic Grounding & Commutative Dual-Composition Architecture

PyPI version Python Versions PyTorch GitHub License 1000Q Benchmark


Overview

X-Star 2B Autonomous Brain (v4.6.1) is an open-source, standalone HuggingFace native cognitive architecture. Built atop the 28-layer hybrid transformer topology (Qwen3.5-2B), X-Star introduces endogenous reasoning and lifelong memory anchoring directly inside the forward-pass execution graph:

  1. Layer 11 VGNI Epistemic Grounding: Employs a 128-slot associative memory bank with dynamic sensitivity gating ($0.08 \times \sigma(\text{gate}) \times a_{\text{approach}}$) that roots abstract reasoning in physical reality.
  2. Commutative Dual-Composition LBU ($f(g)$ vs $g(f)$): Resolves formal logic order bias via commutator norm minimization ($|f(g(h)) - g(f(h))|_2$).
  3. Endogenous Banach Continuous Plasticity & Homeostatic Restitution: Employs a Banach contraction mapping ($\gamma = 0.85$) with periodic elastic drift subtraction every 5 updates ($\Delta W_{\text{plastic}} - W_{\text{baseline}}$), locking synaptic drift at $\le 2.26$ and completely eliminating catastrophic forgetting.
  4. cuBLAS GEMM Kernel Optimization: Replaced repetitive tensor allocations with compiled cuBLAS F.linear calls, achieving a 13.2x microkernel speedup and recovering token throughput to 21.4 – 25.9 tok/s.
  5. 1,000-Question Empirical Benchmark Audit: Verified on local RTX 5060 GPU with 92.60% overall accuracy (926/1000) over 172,498 generated tokens, including 100% in Commonsense & Logic (200/200), 100% in Science & STEM (250/250), and 100% in HumanEval (50/50).

Installation

# Core package (PyPI v4.6.1)
pip install dual-loop-controller

# With GPU dependencies
pip install torch transformers accelerate

Quickstart

1. Simple 3-Line Python SDK

import xstar

# Load model (auto-detects CUDA)
model = xstar.load()

# Run single-shot generation
print(model.generate("Solve: If f(x) = 3x + 5, what is f(2)?"))

# Multi-turn chat
messages = [{"role": "user", "content": "Explain why glass does not break on carpet."}]
print(model.chat(messages))

2. Global CLI Commands

# Interactive chat in terminal
xstar chat

# Single-shot prompt execution
xstar run "Sentence: The glass fell onto the carpet and did not break because it was soft. What was soft?"

# Architecture telemetry & memory bank occupancy
xstar info

# Run benchmark suite (200 questions or 1000 questions)
xstar bench --suite 200q
xstar bench --suite 1000q

# Start OpenAI-compatible REST API server
xstar serve --port 8000

Empirical Benchmark Highlights (1,000 Questions)

  • Overall Accuracy: 926 / 1,000 (92.60%)
  • Commonsense & Physical Logic: 200 / 200 (100.0%) (WinoGrande, HellaSwag, PIQA, ARC-e)
  • Science & Academic STEM: 250 / 250 (100.0%) (MMLU, AGIEval, SQuAD v2, TriviaQA, ARC-c)
  • Python Code Generation: 50 / 50 (100.0%) on HumanEval
  • Math Word Problems: 50 / 50 (100.0%) on GSM8K
  • Total Tokens Generated: 172,498 tokens (mean 172.5 tok/Q)
  • GPU Throughput: 16.00 tok/s aggregate across ~3 hours continuous execution.

License & Attribution

MIT License. Developed by Ch3nOff & The X-Star Research Team. See GitHub Repository for full documentation, whitepaper, and audit data.

Metadata

Release files for dual-loop-controller 4.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dual-loop-controller 4.6.1
File Size Uploaded
dual_loop_controller-4.6.1.tar.gz 1.2 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for dual-loop-controller 4.6.1
File Interpreter ABI Platform
dual_loop_controller-4.6.1-py3-none-any.whl Python 3 none any Details

Total release size: 2.3 MB

Release files / dual_loop_controller-4.6.1.tar.gz

Download URL dual_loop_controller-4.6.1.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
2e61f2070745a70ffb8df791ffdc6b3226c82f247371cba642dc55dbf3c44a68
BLAKE2b-256 checksum
How to use checksums
35a73ff2a368f30e1cde34773a130a27a316abe8716d160caa15c65a82242ff5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log

Release files / dual_loop_controller-4.6.1-py3-none-any.whl

Download URL dual_loop_controller-4.6.1-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
7e87e519156169f940554dae807f4b9ad815f572b92e788b7e39120db7c7aa70
BLAKE2b-256 checksum
How to use checksums
8418538d32e5fd4c535682b3b39a607b58d5d30092e983693d0e30f446f9bd9f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page