Skip to main content

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

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

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.0) 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.0)
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.0

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.0
File Size Uploaded
dual_loop_controller-4.6.0.tar.gz 1.2 MB Details

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / dual_loop_controller-4.6.0.tar.gz

Download URL dual_loop_controller-4.6.0.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
41158c2351d1bd5edcb74e6cd3edaae0e38307f847cbd4a5a6ca9edad1214f56
BLAKE2b-256 checksum
How to use checksums
cf5344b4df7eaa849fca0b97f95b20d59fc9e848350af92c9ff1d5a1c815d7f1
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.0-py3-none-any.whl

Download URL dual_loop_controller-4.6.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
bac66bc7d2f285600753b52b59c48a600678943f5d4a1dc55c8f54ad750e1a74
BLAKE2b-256 checksum
How to use checksums
ca19a4ef395f72afe46bc663786cc3cae52fe9ae93988cd6bc8825b1de471492
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