Frankai123 commited on
Commit
41e8e95
·
verified ·
1 Parent(s): 8225dea

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +190 -3
README.md CHANGED
@@ -1,3 +1,190 @@
1
- ---
2
- license: mit
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ language:
4
+ - en
5
+ - zh
6
+ metrics:
7
+ - accuracy
8
+ base_model:
9
+ - Qwen/Qwen3-14B
10
+ pipeline_tag: text-generation
11
+ library_name: transformers
12
+ tags:
13
+ - blockchain
14
+ - conversational
15
+ - web3
16
+ - qwen3
17
+ eval_results:
18
+ - task: domain-specific evaluation
19
+ dataset: DMindAI/DMind_Benchmark
20
+ metric: normalized web3 score
21
+ score: 74.12
22
+ model: DMind-1-mini
23
+ model_rank: 2 / 24
24
+ ---
25
+
26
+ <p align="center">
27
+ <img src="figures/dmind-ai-logo.png" width="300" alt="DMind Logo" />
28
+ </p>
29
+ <hr>
30
+ <div align="center" style="line-height: 1;">
31
+ <a href="https://dmind.ai/" target="_blank" style="margin: 2px;">
32
+ <img alt="DMind Website" src="https://img.shields.io/badge/DMind-Homepage-blue?logo=data:image/svg+xml;base64,)" style="display: inline-block; vertical-align: middle;"/>
33
+ </a>
34
+ <a href="https://huggingface.co/datasets/DMindAI/DMind-1-mini" target="_blank" style="margin: 2px;">
35
+ <img alt="Hugging Face" src="https://img.shields.io/badge/HuggingFace-DMind-ffd21f?color=ffd21f&logo=huggingface" style="display: inline-block; vertical-align: middle;"/>
36
+ </a>
37
+ <a href="https://x.com/dmind_ai" target="_blank" style="margin: 2px;">
38
+ <img alt="X" src="https://img.shields.io/badge/X-@dmind-1DA1F2?logo=x" style="display: inline-block; vertical-align: middle;"/>
39
+ </a>
40
+ <a href="https://openrouter.ai/chat" target="_blank" style="margin: 2px;">
41
+ <img alt="Chat" src="https://img.shields.io/badge/🤖%20Chat-DMind--1--mini-536af5?color=536af5&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
42
+ </a>
43
+ <a href="https://discord.gg/xxwmPHU3" target="_blank" style="margin: 2px;">
44
+ <img alt="Discord" src="https://img.shields.io/badge/Discord-DMind-7289da?logo=discord&logoColor=white&color=7289da" style="display: inline-block; vertical-align: middle;"/>
45
+ </a>
46
+ <a href="https://opensource.org/licenses/MIT" target="_blank" style="margin: 2px;">
47
+ <img alt="Code License: MIT" src="https://img.shields.io/badge/Code%20License-MIT-yellow.svg" style="display: inline-block; vertical-align: middle;"/>
48
+ </a>
49
+ </div>
50
+
51
+
52
+ ## Table of Contents
53
+ - [Introduction](#introduction)
54
+ - [1. Model Overview](#1-model-overview)
55
+ - [2. Evaluation Results](#2-evaluation-results)
56
+ - [3. Use Cases](#3-use-cases)
57
+ - [4. Quickstart](#4-quickstart)
58
+ - [4.1 Model Downloads](#41-model-downloads)
59
+ - [4.2 OpenRouter API](#42-openrouter-api)
60
+ - [4.3 OpenRouter Web Chat](#43-openrouter-web-chat)
61
+ - [License](#license)
62
+ - [Contact](#contact)
63
+
64
+ ## Introduction
65
+
66
+ We introduce **DMind-1**, a domain-specialized LLM fine-tuned for the Web3 ecosystem via supervised instruction tuning and reinforcement learning from human feedback (RLHF).
67
+
68
+ To support real-time and resource-constrained applications, we further introduce **DMind-1-mini**, a compact variant distilled from both DMind-1 and a generalist LLM using a multi-level distillation framework. It retains key domain reasoning abilities while operating with significantly lower computational overhead.
69
+
70
+ **DMind-1** and **DMind-1-mini** represent a robust foundation for intelligent agents in the Web3 ecosystem.
71
+
72
+ ## 1. Model Overview
73
+
74
+ ### DMind-1-mini
75
+
76
+ To address scenarios requiring lower latency and faster inference, we introduce **DMind-1-mini**, a lightweight distilled version of DMind-1 based on Qwen3-14B. DMind-1-mini is trained using knowledge distillation and our custom **DeepResearch** framework, drawing from two teacher models:
77
+ - **DMind-1** (Qwen3-32B): Our specialized Web3 domain model
78
+ - **GPT-o3 + DeepResearch**: A general-purpose SOTA LLM, with its outputs processed through our DeepResearch framework for Web3 domain alignment
79
+
80
+ The **Distillation pipeline** combines:
81
+
82
+ - **Web3-specific data distillation**: High-quality instruction-following and QA examples generated by the teacher models
83
+
84
+ - **Distribution-level supervision**: The student model learns to approximate the teachers' output distributions through soft-label guidance, preserving nuanced prediction behavior and confidence calibration
85
+
86
+ - **Intermediate representation transfer**: Knowledge is transferred by aligning intermediate representations between teacher and student models, promoting deeper structural understanding beyond surface-level mimicry
87
+
88
+ This multi-level distillation strategy enables DMind-1-mini to maintain high Web3 task performance while significantly reducing computational overhead and latency, making it suitable for real-time applications such as instant Q&A, on-chain analytics, and lightweight agent deployment.
89
+
90
+
91
+ ## 2. Evaluation Results
92
+
93
+ ![DMind-1 Web3 Performance](figures/dmind-1-web3-performance.jpeg)
94
+
95
+ We evaluate **DMind-1** and **DMind-1-mini** using the DMind Benchmark, a domain-specific evaluation suite tailored to assess large language models in the Web3 context. The benchmark spans 1,917 expert-reviewed questions across nine critical categories—including Blockchain Fundamentals, Infrastructure, Smart Contracts, DeFi, DAO, NFT, Token Economics, Meme, and Security. It combines multiple-choice and subjective open-ended tasks, simulating real-world challenges and requiring deep contextual understanding, which provides a comprehensive assessment of both factual knowledge and advanced reasoning.
96
+ Under this rigorous evaluation:
97
+ - DMind-1 ranked 1st among 24 leading models, outperforming both proprietary (e.g., Grok-3) and open-source (e.g., DeepSeek-R1) LLMs, with a normalized Web3 score of 77.44
98
+ - DMind-1-mini also performed strongly, ranking 2nd overall with a normalized Web3 score of 74.12. This demonstrates the effectiveness of our compact distillation pipeline
99
+
100
+
101
+ ## 3. Use Cases
102
+ - **Expert-Level Question & Answering**: Provides accurate, context-aware answers on blockchain, DeFi, smart contracts, and related Web3 topics
103
+ - **Compliance-Aware Support**: Assists in drafting or reviewing content within regulatory and legal contexts
104
+ - **Content Generation in Domain**: Produces Web3-specific blog posts, documentation, and tutorials tailored to developers and users
105
+ - **DeFi Strategy Suggestions**: Generates insights and recommendations for yield farming, liquidity provision, and portfolio strategies based on user-provided data
106
+ - **Risk Management**: Suggests strategies aligned with user risk profiles for more informed decision-making in volatile markets
107
+
108
+ ## 4. Quickstart
109
+
110
+ ### 4.1 Model Downloads
111
+
112
+ | **Model** | **Base Model** | **Download** |
113
+ |:--------------:|:--------------:|:----------------------------------------------------------------------------:|
114
+ | DMind-1-mini | Qwen3-14B | [Hugging Face Link](https://huggingface.co/dmind-ai/dmind-1-mini) |
115
+
116
+
117
+ ### 4.2 OpenRouter API
118
+
119
+ You can access **DMind-1-mini** via the OpenRouter API. Simply specify the desired model in the `model` field of your request payload.
120
+
121
+ **API Endpoint:**
122
+ ```
123
+ https://openrouter.ai/api/v1/chat/completions
124
+ ```
125
+
126
+ **Authentication:**
127
+ - Obtain your API key from [OpenRouter](https://openrouter.ai/)
128
+ - Include it in the `Authorization` header as `Bearer YOUR_API_KEY`
129
+
130
+ **Model Identifiers:**
131
+ - `DMind-1-mini` — Full-size expert model
132
+
133
+ **Example Request (Python):**
134
+ ```python
135
+ import requests
136
+
137
+ headers = {
138
+ "Authorization": "Bearer YOUR_API_KEY",
139
+ "Content-Type": "application/json"
140
+ }
141
+
142
+ data = {
143
+ "model": "DMind-1-mini",
144
+ "messages": [
145
+ {"role": "user", "content": "Explain DeFi in simple terms."}
146
+ ]
147
+ }
148
+
149
+ response = requests.post(
150
+ "https://openrouter.ai/api/v1/chat/completions",
151
+ headers=headers,
152
+ json=data
153
+ )
154
+ print(response.json())
155
+ ```
156
+
157
+ **Example Request (cURL):**
158
+ ```bash
159
+ curl https://openrouter.ai/api/v1/chat/completions \
160
+ -H "Authorization: Bearer YOUR_API_KEY" \
161
+ -H "Content-Type: application/json" \
162
+ -d '{
163
+ "model": "DMind-1-mini",
164
+ "messages": [{"role": "user", "content": "What is a smart contract?"}]
165
+ }'
166
+ ```
167
+
168
+ **Notes:**
169
+ - Replace `YOUR_API_KEY` with your actual OpenRouter API key.
170
+ - Change the `model` field to `DMind-1-mini` as needed.
171
+ - Both models support the same API structure for easy integration.
172
+
173
+ ### 4.3 OpenRouter Web Chat
174
+
175
+ You can try **DMind-1-mini** instantly using the [OpenRouter Web Chat](https://openrouter.ai/chat).
176
+
177
+ - Select your desired model from the dropdown menu (**DMind-1-mini**).
178
+ - Enter your prompt and interact with the model in real time.
179
+
180
+ [![OpenRouter Chat](https://img.shields.io/badge/🤖%20Try%20on-OpenRouter%20Chat-536af5?color=536af5&logoColor=white)](https://openrouter.ai/chat)
181
+
182
+ ## License
183
+ - The code repository and model weights for DMind-1-mini is released under the MIT License.
184
+ - Commercial use, modification, and derivative works (including distillation and fine-tuning) are permitted.
185
+ - **Base Models:**
186
+ - DMind-1-mini is derived from Qwen3-14B, originally licensed under the [Qwen License](https://github.com/QwenLM/Qwen3).
187
+ - Please ensure compliance with the original base model licenses when using or distributing derivatives.
188
+
189
+ ## Contact
190
+ For questions or support, please contact [email protected]