Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,251 @@
+---
+language:
+- en
+- zh
+license: apache-2.0
+library_name: transformers
+tags:
+- web3
+- finance
+- defi
+- chain-of-thought
+- sft
+- security-audit
+- on-device-ai
+metrics:
+- accuracy
+- ponzi-detection-rate
+- code-security-score
+pipeline_tag: text-generation
+inference: false
+base_model:
+- openai/gpt-oss-20b
+---
+
+# <span style="color: #7FFF7F;">DMind-3 GGUF Models</span>
+
+
+## <span style="color: #7F7FFF;">Model Generation Details</span>
+
+This model was generated using [llama.cpp](https://github.com/ggerganov/llama.cpp) at commit [`05fa625ea`](https://github.com/ggerganov/llama.cpp/commit/05fa625eac5bbdbe88b43f857156c35501421d6e).
+
+
+
+
+
+---
+
+## <span style="color: #7FFF7F;">Quantization Beyond the IMatrix</span>
+
+I've been experimenting with a new quantization approach that selectively elevates the precision of key layers beyond what the default IMatrix configuration provides.
+
+In my testing, standard IMatrix quantization underperforms at lower bit depths, especially with Mixture of Experts (MoE) models. To address this, I'm using the `--tensor-type` option in `llama.cpp` to manually "bump" important layers to higher precision. You can see the implementation here:  
+👉 [Layer bumping with llama.cpp](https://github.com/Mungert69/GGUFModelBuilder/blob/main/model-converter/tensor_list_builder.py)
+
+While this does increase model file size, it significantly improves precision for a given quantization level.
+
+### **I'd love your feedback—have you tried this? How does it perform for you?**
+
+
+
+
+---
+
+<a href="https://readyforquantum.com/huggingface_gguf_selection_guide.html" style="color: #7FFF7F;">
+  Click here to get info on choosing the right GGUF model format
+</a>
+
+---
+
+
+
+<!--Begin Original Model Card-->
+
+
+# 🔮 DMind-3: The Age of Foresight
+
+*From local logic to global foresight. In a world of isolated systems, the one who sees the whole board wins.*
+
+We have armed the individual with a shield (`DMind-3-nano`) and a brain (`DMind-3-mini`). We have enabled sovereign intelligence to defend and to reason. Yet, in the interconnected chaos of global markets, even the sharpest mind can be blindsided by a tsunami forming on the other side of the world. Local optimization is not enough. True sovereignty requires not just reaction, but **pre-emption**.
+
+Web3 is a single, planet-scale financial machine. Capital flows like weather patterns, and risks cascade across protocols like lightning. To navigate this reality, one cannot merely analyze a single smart contract or a single chain. One must perceive the entire system—its flows, its pressures, its emergent properties. This requires a perspective that transcends the local, a form of intelligence that can synthesize global, cross-domain information into actionable foresight.
+
+DMind-3 is our answer. It is not an incremental upgrade; it is a categorical leap. While `nano` provides intuition and `mini` provides logic, `max` delivers **foresight**. It is the Oracle in the cloud, the strategic command center that sees the entire battlefield. It was built not to answer questions, but to question the answers, to model the unseen, and to chart a course through the complexity of a new financial era.
+
+🛡️ `DMind-3-nano` is your Shield. ⚔️ `DMind-3-mini` is your Spear. 🔮 `DMind-3` is your Oracle.
+
+Welcome to the Age of Foresight.
+
+---
+
+## 🏛️ DMind-3: The Macro-Strategic Financial Engine
+
+### 1. Evolution & Legacy
+
+The DMind-3 series was conceived as a complete, multi-layered cognitive architecture for the sovereign individual. `Nano` secures the present transaction. `Mini` formulates the immediate strategy. `Max` defines the long-term campaign.
+
+This final piece of the trilogy moves beyond the tactical and into the strategic. It was born from the recognition that the most significant opportunities and the most devastating risks in Web3 are systemic. They are not found in code, but in the interplay between code, capital, and human psychology at a global scale. DMind-3 is engineered to be a **Macro-Strategic Financial Engine**, providing institutional-grade foresight as a utility for developers, funds, and the agent ecosystems built upon the DMind stack.
+
+### 2. ⚙️ Model Details
+
+| Property | Value |
+|---|---|
+| **Model Name** | DMind-3 |
+| **Organization** | DMindAI |
+| **Base Architecture** | gpt-oss-20b (Customized Transformer w/ Multi-Scale RoPE) |
+| **Parameter Count** | 21 Billion |
+| **Precision** | BF16 / FP16 (Native) |
+| **Context Window** | 256k tokens |
+| **Deployment** | Cloud API & Private Enterprise VPC |
+
+### 3. 🔬 Methodology: Hierarchical Predictive Synthesis (HPS)
+
+DMind-3 introduces **Hierarchical Predictive Synthesis (HPS)**. While C³-SFT (used in `mini`) teaches the model to correct its own reasoning, HPS teaches it to synthesize multiple, conflicting, time-variant data streams into a coherent probabilistic forecast. It operates on a nested hierarchy of abstraction, from raw on-chain events to complex macroeconomic indicators.
+
+![Figure 1](./Figures/Figure1.png)
+
+**(Figure 1: The HPS training paradigm, showing multi-level data fusion and probabilistic future state generation)**
+
+**Mathematical Formalization**
+
+The HPS objective function seeks to minimize the divergence between the model's predicted distribution of future states and the actual observed outcomes, weighted by strategic importance:
+
+$$
+\mathcal{L}_{\text{HPS}}(\theta) = - \mathbb{E}_{\mathcal{D}} \left[ \sum_{t=1}^{T} \sum_{i=1}^{M} \omega_i \cdot \log P_\theta(S'_{t+1} \mid S_t, A_t, M_i) \right] + \lambda \sum_{l=1}^{L} \| \Omega_l(\theta) - \Omega_l(\theta_{\text{ref}}) \|_F
+$$
+
+where:
+
+| Symbol | Description |
+|---|---|
+| \\(S_t\\) | The state of the global market at time \\(t\\) |
+| \\(A_t\\) | The set of all actions (transactions, governance votes) at time \\(t\\) |
+| \\(M_i\\) | The \\(i\\)-th modality of data (e.g., on-chain, news, social sentiment) |
+| \\(\omega_i\\) | The attention weight assigned to the strategic importance of modality \\(i\\) |
+| \\(\Omega_l\\) | The parameter matrix at layer \\(l\\) of the network, regularized to prevent catastrophic forgetting |
+
+**Dual-State Inference Mechanism**
+
+Similar to `DMind-3-mini`, the model supports a dual-state inference mechanism triggered by a special token:
+
+$$
+\hat{y} = 
+\begin{cases} 
+\operatorname*{arg\,max}\limits_{y} P_\theta(y \mid x, \mathcal{C}_{\text{global}}) & \text{if } \tau = \emptyset \quad (\text{Standard Mode}) \\
+\operatorname*{arg\,max}\limits_{y} P_\theta(y \mid x, \mathcal{C}_{\text{global}}, \mathcal{R}_{\text{risk}}, \mathcal{H}_{\text{hist}}) & \text{if } \tau = \texttt{<FORESIGHT>} \quad (\text{Strategic Mode})
+\end{cases}
+$$
+
+This forces the model to not just predict, but to weigh the importance of different data sources when constructing its view of the future.
+
+### 4. 💡 Intended Use: Institutional-Grade Web3 Intelligence
+
+DMind-3 is designed to power the next generation of DeFi analytics, risk management platforms, and autonomous agent orchestrators.
+
+**Key Capabilities:**
+- 🔮 **Macro-Strategic Foresight**: Identify emerging cross-chain narratives, predict market regime shifts, and model the impact of major economic events on crypto asset correlations.
+- 🏛️ **Automated Institutional Research**: Generate deep, data-driven reports on novel protocols, perform automated tokenomics valuation, and assess long-term protocol viability.
+- 🌊 **Systemic Risk Assessment**: Model contagion risk across DeFi, detect liquidity black holes before they form, and run stress tests on entire ecosystems based on simulated market shocks.
+- 🤖 **Agent Fleet Orchestration**: Serve as the central "strategic brain" for fleets of `mini` and `nano` agents, providing high-level directives and market context.
+
+### 5. 📚 The Brain, Shield & Oracle Ecosystem
+
+The DMind-3 series is a vertically integrated stack designed for sovereign intelligence.
+
+![Figure 2](./Figures/Figure2.png)
+
+**(Figure 2: The full DMind-3 Cognitive Architecture, from on-device reflexes to cloud-native foresight)**
+
+- **The Oracle (DMind-3)**: Runs in the cloud. Provides macro-strategic foresight, systemic risk analysis, and orchestrates the agent fleet.
+- **The Brain (DMind-3-mini)**: Runs on your local high-performance machine. Executes complex, bespoke strategies and performs deep, focused research under the Oracle's guidance.
+- **The Shield (DMind-3-nano)**: Runs in your browser or wallet. Provides real-time, intuitive transaction security and intent recognition, acting as the final line of defense.
+
+### 6. 📚 Training Data
+
+DMind-3 was trained on a corpus of over 500,000 curated, high-signal documents and a multi-terabyte stream of structured on-chain data.
+
+| Data Source | Proportion | Description |
+|---|---|---|
+| **Institutional Alpha Reports** | 35% | Comprehensive reports from premier crypto-native funds and TradFi institutions, deconstructed into causal models. |
+| **Global Macroeconomic Data** | 25% | Time-series data from sources like the Federal Reserve (FRED), World Bank, and IMF, correlated with on-chain metrics. |
+| **Cross-Chain Indexed Data** | 20% | A complete, indexed history of transactions, state changes, and logs across all major EVM chains, Solana, and Cosmos ecosystems. |
+| **Financial Post-Mortems & Audits** | 10% | In-depth analysis of systemic failures, economic exploits, and protocol hacks, focusing on pre-mortem indicators and contagion pathways. |
+| **Geopolitical & Regulatory Feeds** | 10% | Real-time feeds on global regulatory changes, policy proposals, and geopolitical events impacting digital asset markets. |
+
+### 7. 🏆 Performance Benchmarks
+
+Evaluated on three key benchmarks: **DMind Benchmark** (Web3 Native Logic), **FinanceQA** (Financial Domain Knowledge), and **AIME 2025** (Advanced Mathematical Reasoning).
+
+![Figure 3: Performance Benchmarks](./Figures/Figure3.png)
+
+**(Figure 3: LLM Performance Evaluation - 3 Benchmarks: DMind Benchmark, FinanceQA, AIME 2025)**
+
+The evaluation compares DMind-3 (21B) against top-tier frontier models (GPT-5.1, Claude Sonnet 4.5) and other efficient models. Despite its optimized size, the Max model demonstrates exceptional efficiency, particularly in specialized domain tasks where it outperforms significantly larger generalist models.
+
+
+### 8. ⚖️ Limitations & Disclaimer
+
+- **Not a Financial Advisor (NFA)**: DMind-3 is a powerful analytical tool for generating insights and modeling risks. It is not a registered financial advisor. All outputs should be independently verified and are not a solicitation to trade.
+- **Probabilistic Nature**: All forecasts are probabilistic and based on the data available up to the knowledge cutoff. The model cannot predict black swan events and is subject to the inherent unpredictability of markets.
+- **Knowledge Cutoff**: The core model has a knowledge cutoff of June 2025. While it can process real-time data provided via the API, its foundational understanding is based on its training corpus.
+
+---
+
+<!--End Original Model Card-->
+
+---
+
+# <span id="testllm" style="color: #7F7FFF;">🚀 If you find these models useful</span>
+
+Help me test my **AI-Powered Quantum Network Monitor Assistant** with **quantum-ready security checks**:  
+
+👉 [Quantum Network Monitor](https://readyforquantum.com/?assistant=open&utm_source=huggingface&utm_medium=referral&utm_campaign=huggingface_repo_readme)  
+
+
+The full Open Source Code for the Quantum Network Monitor Service available at my github repos ( repos with NetworkMonitor in the name) : [Source Code Quantum Network Monitor](https://github.com/Mungert69). You will also find the code I use to quantize the models if you want to do it yourself [GGUFModelBuilder](https://github.com/Mungert69/GGUFModelBuilder)
+
+💬 **How to test**:  
+ Choose an **AI assistant type**:  
+   - `TurboLLM` (GPT-4.1-mini)  
+   - `HugLLM` (Hugginface Open-source models)  
+   - `TestLLM` (Experimental CPU-only)  
+
+### **What I’m Testing**  
+I’m pushing the limits of **small open-source models for AI network monitoring**, specifically:  
+- **Function calling** against live network services  
+- **How small can a model go** while still handling:  
+  - Automated **Nmap security scans**  
+  - **Quantum-readiness checks**  
+  - **Network Monitoring tasks**  
+
+🟡 **TestLLM** – Current experimental model (llama.cpp on 2 CPU threads on huggingface docker space):  
+- ✅ **Zero-configuration setup**  
+- ⏳ 30s load time (slow inference but **no API costs**) . No token limited as the cost is low.
+- 🔧 **Help wanted!** If you’re into **edge-device AI**, let’s collaborate!  
+
+### **Other Assistants**  
+🟢 **TurboLLM** – Uses **gpt-4.1-mini** :
+- **It performs very well but unfortunatly OpenAI charges per token. For this reason tokens usage is limited. 
+- **Create custom cmd processors to run .net code on Quantum Network Monitor Agents**
+- **Real-time network diagnostics and monitoring**
+- **Security Audits**
+- **Penetration testing** (Nmap/Metasploit)  
+
+🔵 **HugLLM** – Latest Open-source models:  
+- 🌐 Runs on Hugging Face Inference API. Performs pretty well using the lastest models hosted on Novita.
+
+### 💡 **Example commands you could test**:  
+1. `"Give me info on my websites SSL certificate"`  
+2. `"Check if my server is using quantum safe encyption for communication"`  
+3. `"Run a comprehensive security audit on my server"`
+4. '"Create a cmd processor to .. (what ever you want)" Note you need to install a [Quantum Network Monitor Agent](https://readyforquantum.com/Download/?utm_source=huggingface&utm_medium=referral&utm_campaign=huggingface_repo_readme) to run the .net code on. This is a very flexible and powerful feature. Use with caution!
+
+### Final Word
+
+I fund the servers used to create these model files, run the Quantum Network Monitor service, and pay for inference from Novita and OpenAI—all out of my own pocket. All the code behind the model creation and the Quantum Network Monitor project is [open source](https://github.com/Mungert69). Feel free to use whatever you find helpful.
+
+If you appreciate the work, please consider [buying me a coffee](https://www.buymeacoffee.com/mahadeva) ☕. Your support helps cover service costs and allows me to raise token limits for everyone.
+
+I'm also open to job opportunities or sponsorship.
+
+Thank you! 😊