com-junkawasaki commited on
Commit
2feeca2
·
verified ·
1 Parent(s): 9fa0640

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +243 -0
README.md ADDED
@@ -0,0 +1,243 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ base_model: Qwen/Qwen3-VL-8B
3
+ language: en
4
+ library_name: mlx
5
+ license: apache-2.0
6
+ pipeline_tag: text-generation
7
+ tags:
8
+ - mlx
9
+ - apple-silicon
10
+ - qlora
11
+ - gftd
12
+ - qwen3-vl
13
+ - knowledge-distillation
14
+ - maxwell
15
+ - field-theory
16
+ - mathematical-elegance
17
+ ---
18
+
19
+ # Model Card for Model ID
20
+
21
+ <!-- Provide a quick summary of what the model is/does. -->
22
+
23
+
24
+
25
+ ## Model Details
26
+
27
+ ### Model Description
28
+
29
+ <!-- Provide a longer summary of what this model is. -->
30
+
31
+ # gftd/maxwell-260213
32
+
33
+ **Maxwell Electromagnetic Reasoning Model** - A model whose reasoning is informed by James Clerk Maxwell's philosophy: field-based thinking, mathematical elegance, unification of forces, gradient reasoning, and statistical mechanics.
34
+
35
+ ## Philosophy: James Clerk Maxwell
36
+ Maxwell unified electricity, magnetism, and light into a single theory of electromagnetic fields. This model applies Maxwell's thinking to computation: problems are fields, solutions follow gradients, symmetry reveals structure, and unification of patterns is the highest goal. Like Maxwell's demon, it understands that information has physical consequences.
37
+
38
+ ## Training Details
39
+ - **Framework**: Apple MLX (mlx-lm QLoRA)
40
+ - **Base Model**: Qwen/Qwen3-VL-8B
41
+ - **Teacher**: Claude Opus 4.6 (via OpenRouter)
42
+ - **LoRA Config**: rank=64, alpha=128, layers=16, bits=4
43
+ - **Dataset**: 100 samples across 6 categories
44
+
45
+ ## Capabilities
46
+ - Go/Rust/Svelte/Python code generation
47
+ - MCP tool selection and operation (93+ tools)
48
+ - 8-step reasoning chains
49
+ - Web browser interaction
50
+ - Dapr patterns (Actors, Workflows, State, PubSub)
51
+ - GFTD Performers API operations
52
+
53
+ ## Usage (MLX)
54
+ ```python
55
+ from mlx_lm import load, generate
56
+ model, tokenizer = load("gftd/maxwell-260213")
57
+ response = generate(model, tokenizer, prompt="Write a Go HTTP handler", max_tokens=512)
58
+ ```
59
+
60
+ ## License
61
+ Apache 2.0
62
+
63
+
64
+ - **Developed by:** [More Information Needed]
65
+ - **Funded by [optional]:** [More Information Needed]
66
+ - **Shared by [optional]:** [More Information Needed]
67
+ - **Model type:** [More Information Needed]
68
+ - **Language(s) (NLP):** en
69
+ - **License:** apache-2.0
70
+ - **Finetuned from model [optional]:** Qwen/Qwen3-VL-8B
71
+
72
+ ### Model Sources [optional]
73
+
74
+ <!-- Provide the basic links for the model. -->
75
+
76
+ - **Repository:** [More Information Needed]
77
+ - **Paper [optional]:** [More Information Needed]
78
+ - **Demo [optional]:** [More Information Needed]
79
+
80
+ ## Uses
81
+
82
+ <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
83
+
84
+ ### Direct Use
85
+
86
+ <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
87
+
88
+ [More Information Needed]
89
+
90
+ ### Downstream Use [optional]
91
+
92
+ <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
93
+
94
+ [More Information Needed]
95
+
96
+ ### Out-of-Scope Use
97
+
98
+ <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
99
+
100
+ [More Information Needed]
101
+
102
+ ## Bias, Risks, and Limitations
103
+
104
+ <!-- This section is meant to convey both technical and sociotechnical limitations. -->
105
+
106
+ [More Information Needed]
107
+
108
+ ### Recommendations
109
+
110
+ <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
111
+
112
+ Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.
113
+
114
+ ## How to Get Started with the Model
115
+
116
+ Use the code below to get started with the model.
117
+
118
+ [More Information Needed]
119
+
120
+ ## Training Details
121
+
122
+ ### Training Data
123
+
124
+ <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
125
+
126
+ [More Information Needed]
127
+
128
+ ### Training Procedure
129
+
130
+ <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
131
+
132
+ #### Preprocessing [optional]
133
+
134
+ [More Information Needed]
135
+
136
+
137
+ #### Training Hyperparameters
138
+
139
+ - **Training regime:** [More Information Needed] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
140
+
141
+ #### Speeds, Sizes, Times [optional]
142
+
143
+ <!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
144
+
145
+ [More Information Needed]
146
+
147
+ ## Evaluation
148
+
149
+ <!-- This section describes the evaluation protocols and provides the results. -->
150
+
151
+ ### Testing Data, Factors & Metrics
152
+
153
+ #### Testing Data
154
+
155
+ <!-- This should link to a Dataset Card if possible. -->
156
+
157
+ [More Information Needed]
158
+
159
+ #### Factors
160
+
161
+ <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
162
+
163
+ [More Information Needed]
164
+
165
+ #### Metrics
166
+
167
+ <!-- These are the evaluation metrics being used, ideally with a description of why. -->
168
+
169
+ [More Information Needed]
170
+
171
+ ### Results
172
+
173
+ [More Information Needed]
174
+
175
+ #### Summary
176
+
177
+
178
+
179
+ ## Model Examination [optional]
180
+
181
+ <!-- Relevant interpretability work for the model goes here -->
182
+
183
+ [More Information Needed]
184
+
185
+ ## Environmental Impact
186
+
187
+ <!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
188
+
189
+ Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
190
+
191
+ - **Hardware Type:** [More Information Needed]
192
+ - **Hours used:** [More Information Needed]
193
+ - **Cloud Provider:** [More Information Needed]
194
+ - **Compute Region:** [More Information Needed]
195
+ - **Carbon Emitted:** [More Information Needed]
196
+
197
+ ## Technical Specifications [optional]
198
+
199
+ ### Model Architecture and Objective
200
+
201
+ [More Information Needed]
202
+
203
+ ### Compute Infrastructure
204
+
205
+ [More Information Needed]
206
+
207
+ #### Hardware
208
+
209
+ [More Information Needed]
210
+
211
+ #### Software
212
+
213
+ [More Information Needed]
214
+
215
+ ## Citation [optional]
216
+
217
+ <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
218
+
219
+ **BibTeX:**
220
+
221
+ [More Information Needed]
222
+
223
+ **APA:**
224
+
225
+ [More Information Needed]
226
+
227
+ ## Glossary [optional]
228
+
229
+ <!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
230
+
231
+ [More Information Needed]
232
+
233
+ ## More Information [optional]
234
+
235
+ [More Information Needed]
236
+
237
+ ## Model Card Authors [optional]
238
+
239
+ [More Information Needed]
240
+
241
+ ## Model Card Contact
242
+
243
+ [More Information Needed]