Upload configs/README.md with huggingface_hub

b5974c4 verified 7 days ago

8.77 kB

	# 🧠 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)
	# NeuralAI → Hugging Face sync is live

	# 🧠 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)
	# NeuralAI → Hugging Face sync is live