NeuralAI / configs /README.md

Upload configs/README.md with huggingface_hub

b5974c4 verified 7 days ago

preview code

Raw

History Blame Contribute Delete

8.77 kB

🧠 NeuralAI: The Generative AI Engine

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

NeuralAI Core: Handles chat state, direct model inference, terminal session proxying, and tool orchestration.
NeuralDrive (Cloud Storage): The intelligent data layer for all projects, featuring isolated user storage, automatic versioning, and semantic mapping.
Diffusion Engine: An integrated generative diffusion layer for producing visual branding assets, UI mockups, and visual logic maps.
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

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

<!-- 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 | GitHub

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

Software Downloads: The latest beta builds (v0.1-Beta) of NeuralLabs are available at: 👉 https://zo.pub/deandrewharris/neurallabs-beta

NeuralAI → Hugging Face sync is live