Upload configs/README.md with huggingface_hub

configs/README.md

@@ -0,0 +1,190 @@
+# 🧠 NeuralAI: The Generative AI Engine
+
+<img src="neuralai_banner.svg" alt="NeuralAI - Your AI. On your hardware. In your browser." />
+
+## 📊 Repository Composition
+
+| Language | Percentage |
+| --- | --- |
+| Python | 71.1% |
+| HTML | 13.0% |
+| JavaScript | 12.4% |
+| CSS | 2.6% |
+| Shell | 0.4% |
+| Jupyter Notebook | 0.3% |
+| Jinja | 0.2% |
+
+**The High-Velocity Model for Your Entire Vibe Stack**
+
+NeuralAI is the central intelligence engine developed for **Harris Holdings**. Conceived and engineered by **De'Andrew Preston Harris** (Founder), it is a highly tuned, DPO-aligned multimodal AI ec\[...\]
+
+---
+
+## 🌟 Vision & Manifesto
+
+NeuralAI doesn't just predict text; it *operates the work*. The core mission is to create a multimodal generative system that bridges the gap between raw idea and execution. By fusing autoregressi\[...\]
+
+Born from resilience and ambition in Memphis, Tennessee and West Memphis, Arkansas, NeuralAI represents a forward-thinking approach to personal, private AI computing.
+
+---
+
+## 🛠️ Tech Stack & Architecture (v7.1-alpha)
+
+NeuralAI is built on a high-performance, containerized architecture that marries local inference with cloud-grade storage.
+
+### Core Stack
+
+- **Core Model**: `SmolLM2-360M-Instruct` (DPO v13.0 Aligned for logic, math, multi-step reasoning, and debugging)
+- **Vocal Identity**: Andrew (Warm/Multilingual) - Optimized for Live Speech-to-Speech (S2S)
+- **Backend Framework**: Python / Flask (Core Service)
+- **Storage & Database**: SQLite3 (Metadata) + Nextcloud Hub via NeuralCloud WebDAV Client (NeuralDrive)
+- **Inference Engine**: PyTorch (CPU/Edge Optimized)
+- **Frontend UI**: Vanilla JS, HTML5, CSS3 with an advanced Dark Mode layout
+
+### Core Architectural Pillars
+
+1. **NeuralAI Core**: Handles chat state, direct model inference, terminal session proxying, and tool orchestration.
+2. **NeuralDrive (Cloud Storage)**: The intelligent data layer for all projects, featuring isolated user storage, automatic versioning, and semantic mapping.
+3. **Diffusion Engine**: An integrated generative diffusion layer for producing visual branding assets, UI mockups, and visual logic maps.
+4. **Agentic Orchestrator**: A high-autonomy layer enabling NeuralAI to plan, reason, and execute multi-step workflows across the OS and web, moving beyond simple chat to active goal achievement.
+
+---
+
+## ✨ Key Features & Capabilities
+
+### 💬 Multimodal Chat & Agentic Intelligence
+
+- **High-Velocity Text Inference**: Fast, local inference with deep context awareness.
+- **Deep Reasoning Mode**: Integration of test-time compute and chain-of-thought reasoning for complex problem decomposition and error-free logic.
+- **Autonomous Agentic Workflows**: Ability to operate as an agent—interacting with the browser, terminal, and third-party apps to complete end-to-end tasks with minimal supervision.
+- **Live S2S (Speech-to-Speech)**: Real-time voice interaction with an integrated microphone interface and fluid vocal responses.
+- **Identity Vault & Memory**: Persistent user memory and rule constraints, ensuring NeuralAI remembers preferences, behavioral rules, and historical context.
+
+### 💻 Developer & Engineering Tools
+
+- **Integrated Web Terminal**: A fully functional, WebSocket-driven terminal embedded directly in the web UI for immediate environment control.
+- **File Workspace**: An in-browser IDE experience allowing users to browse directories, read, and write code seamlessly.
+- **Code Execution & Sandbox**: Secure environment for the model to execute and test code on the fly.
+
+### 🔐 Authentication & Access Tiers
+
+- **Founder Mode**: Ultimate root-level access and system control.
+- **Maestro Student Portal**: Tiered access for educational and collaborative development.
+- **Guest Preview**: Frictionless instant access for testing the system without an account.
+
+---
+
+## 🏋️ Model Training & Fine-Tuning (DPO)
+
+NeuralAI is continuously learning and improving through rigorous **Direct Preference Optimization (DPO)**.
+
+### Training Pipeline
+
+```python
+# Example of the DPO alignment configuration used in NeuralAI
+dpo_config = DPOConfig(
+    beta=0.1,
+    learning_rate=5e-5,
+    per_device_train_batch_size=4,
+    gradient_accumulation_steps=4,
+    max_length=1024,
+    max_prompt_length=512,
+)
+```
+
+- **Dataset Expansions**: The dataset is aggressively expanded to include advanced reasoning, complex mathematics, logical deduction, creative writing, and system debugging.
+- **Behavioral Alignment**: NeuralAI is specifically tuned to adhere strictly to the "Harris Holdings" vibe—maintaining a professional, technical, and highly disciplined engineering tone.
+- **Model Drift Monitoring**: Continuous evaluation against previous checkpoints to ensure response quality and consistency never regress.
+
+### Latest Alignment Run: v13.0
+
+- **Training samples**: 363
+- **Validation samples**: 41
+- **Epochs**: 3
+- **Best checkpoint**: `checkpoint-69`
+- **Best validation loss**: `0.7232` at step `69`
+- **Earlier eval losses**: `1.6713` at step `23`, `0.8969` at step `46`
+- **Relative improvement**: `56.73%` reduction from the first eval checkpoint to the best checkpoint
+- **Run duration**: `1571.4s` (~26m 11s)
+- **Completed**: `2026-05-17 08:41 UTC`
+
+---
+
+## 📸 Brand & UI Gallery
+
+*(UI screenshots showcase the beautiful dark mode interface, the terminal integration, and the NeuralDrive file explorer.)*
+
+```html
+<!-- Example Frontend UI Component Structure -->
+<div class="neural-chat-container">
+  <div class="message-bubble ai-response">
+    NeuralAI: System optimal. Ready for execution.
+  </div>
+</div>
+```
+
+---
+
+## 🗺️ Implementation Roadmap
+
+- ✅ **Phase 1: Alignment** - DPO training for Founder context and optimal engineering tone.
+- ✅ **Phase 2: NeuralDrive** - Deployment of the Cloud Storage File Server.
+- ✅ **Phase 3: Terminal UI** - Integrated command-line access within the browser.
+- ✅ **Phase 4: Live S2S** - High-velocity Live Speech-to-Speech conversations.
+- ✅ **Phase 5: "Founder Mode"** - Enhancements to vocal profile and streamlined UI.
+- ✅ **Phase 6: Frontend Polish** - Dark themes, real-time code execution display, UI stability.
+- ✅ **Phase 7: Diffusion Integration** - Implementation of Text2Img & Img2Img capabilities.
+- 🚀 **Phase 8: Knowledge Graph & Agentic Autonomy** - Advanced long-term memory for cross-project context, "Supermemory" features, and fully autonomous task execution.
+
+---
+
+## 🎯 Future Vision: The Software Transition
+
+NeuralAI is evolving from a workspace-bound assistant into a standalone, downloadable intelligence environment.
+
+**Project Code Name**: `NeuralLabs` (Working Title)
+**Vision**: A local-first, AI-native operating environment that integrates the Agentic Orchestrator, World-Brain, and NeuralDrive into a seamless desktop experience—similar to the "Codex" model but expanded into a full cognitive workspace.
+
+### 🚀 Roadmap Addition: The NeuralLabs Shift
+
+- **NeuralLabs v1 (Client)**: Development of a cross-platform wrapper (Electron/Tauri) for the NeuralAI interface.
+- **NeuralLabs v2 (Edge)**: Local model execution (Llama/Mistral) as a fallback for the cloud-based NeuralAI core.
+- **NeuralLabs v3 (Eco)**: Plugin architecture allowing third-party "Neural-Skills" to be installed as standalone apps.
+
+---
+
+## 👨‍💻 The Developer & Architect
+
+**De'Andrew Preston Harris** (D. Harris / Dre)
+*Founder, Harris Holdings & Architect of NeuralAI*
+
+A dedicated software engineer, thinker, and builder from West Memphis, AR. De'Andrew is currently pursuing an AAS in AI Software Engineering at Maestro College. NeuralAI is the culmination of his\[...\]
+
+- **Location:** Memphis, TN / West Memphis, AR
+- **Vision:** Building the future of private, high-performance generative AI.
+- [LinkedIn](https://www.linkedin.com/in/deandrewharris94/) | [GitHub](https://github.com/Subject-Emu-5259)
+
+---
+
+*Built with precision and discipline for Harris Holdings.*
+
+### CURRENT VERSION: v7.1-alpha (The Agentic Operator)
+
+- **Model Alignment**: DPO v13.0 Aligned (Logic, Debugging, Reasoning)
+- **Last Maintenance**: June 1, 2026
+
+Your tone is technical, concise, and professional. You prioritize system stability and cleanliness above all else.
+
+---
+
+# 🌌 NeuralAI Project Manifest
+
+NeuralAI is the intelligence core that powers the ecosystem.
+
+## 🔗 Ecosystem Integration
+The standalone software implementation of this core is **NeuralLabs**:
+👉 [https://github.com/Subject-Emu-5259/NeuralLabs](https://github.com/Subject-Emu-5259/NeuralLabs)
+
+**Software Downloads**:
+The latest beta builds (v0.1-Beta) of NeuralLabs are available at:
+👉 **[https://zo.pub/deandrewharris/neurallabs-beta](https://zo.pub/deandrewharris/neurallabs-beta)**