WebScraper991923 commited on
Commit
9889592
·
verified ·
1 Parent(s): d633c72

Upload folder using huggingface_hub

Browse files
Files changed (5) hide show
  1. CHECKLIST.txt +83 -0
  2. LICENSE +111 -0
  3. README.md +19 -0
  4. feature_config.json +19 -0
  5. price_model.onnx +3 -0
CHECKLIST.txt ADDED
@@ -0,0 +1,83 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ RESI miner bundle — USD ONNX + subnet feature_config (14-feature schema)
2
+ ================================================================================
3
+
4
+ A) Training (must match validator: ONNX outputs USD, MAPE vs dollar price)
5
+
6
+ 1. Default train_real_estate.py exports a **single fused ONNX**: raw features
7
+ (same order as feature_config) → StandardScaler inside the graph → trees →
8
+ optional expm1 → USD tensor ``price_usd``. You do **not** need --no-log-target
9
+ for a valid miner model if you keep default fusion (log1p training + expm1
10
+ fused). Input name is ``float_input`` for fused exports.
11
+
12
+ Alternative — train directly in dollars (no log head in ONNX):
13
+
14
+ MPLBACKEND=Agg python train_real_estate.py \\
15
+ --data training_data.json \\
16
+ --catboost \\
17
+ --out artifacts_miner_usd \\
18
+ --no-log-target
19
+
20
+ Legacy unfused tree-only ONNX (no scaler / no expm1 in graph):
21
+
22
+ ... --no-onnx-fusion
23
+
24
+ Use --all / --xgboost / --lightgbm instead of --catboost if you prefer.
25
+
26
+ 2. Keep the same feature columns as this bundle: train with DEFAULT redundant
27
+ dropping (omit --no-drop-redundant) so you have exactly the 14 features
28
+ listed in miner_submission/feature_config.json.
29
+
30
+ If you train with --no-drop-redundant (17 columns), regenerate the JSON:
31
+
32
+ MPLBACKEND=Agg python train_real_estate.py ... --no-drop-redundant \\
33
+ --write-miner-feature-config miner_submission/feature_config.json
34
+
35
+ B) Export files for chain / HF repo
36
+
37
+ 3. Copy the chosen ONNX to your repo as model.onnx (e.g. from
38
+ artifacts_miner_usd/catboost_price_model.onnx).
39
+
40
+ 4. Commit miner_submission/feature_config.json alongside the model (same
41
+ feature order as training / encoder).
42
+
43
+ 5. ONNX input: one float tensor, shape [N, 14], columns in the exact order
44
+ of "features" in feature_config.json. Fused models use input ``float_input``.
45
+ Output is typically a single tensor; fused USD models name it ``price_usd``
46
+ (take index 0 if your runner binds by position).
47
+
48
+ C) Validate JSON against subnet rules (optional)
49
+
50
+ cd /home/RESI-models
51
+ .venv/bin/python -c "
52
+ from pathlib import Path
53
+ from real_estate.data.config_encoder import load_feature_config
54
+ load_feature_config(Path('/home/46/miner_submission/feature_config.json'))
55
+ print('feature_config.json OK')
56
+ "
57
+
58
+ D) Do not rely on target_transform.json on-chain — the validator does not apply
59
+ expm1; the model must emit dollars.
60
+
61
+ E) You cannot change the eval system — submission-only rules
62
+
63
+ The validator always: encodes raw API fields → float32 matrix (same order as
64
+ your feature_config) → ONNX → treats outputs as USD for MAPE.
65
+
66
+ Therefore you MUST NOT depend on any extra JSON, hooks, or server-side
67
+ preprocessing. Everything the model needs must be inside model.onnx OR you
68
+ must train without that preprocessing:
69
+
70
+ • Feature normalization (z-score, min-max): only valid if you fuse those ops
71
+ into the ONNX graph ahead of the trees. Default train_real_estate.py does
72
+ this (StandardScaler → trees → optional expm1). Training with a sklearn
73
+ scaler but submitting plain tree ONNX on raw inputs = wrong.
74
+
75
+ • log1p(price) training: only valid if the ONNX output is already USD, i.e.
76
+ expm1 is in the graph (default fused export) or you use --no-log-target.
77
+
78
+ • For gradient-boosted trees on tabular data, raw features + USD target is
79
+ usually enough; focus on data and regularization rather than z-score unless
80
+ you invest in ONNX fusion tools.
81
+
82
+ Minimum viable submission: model.onnx (raw in → USD out) + feature_config.json
83
+ matching column order; no other files required by default.
LICENSE ADDED
@@ -0,0 +1,111 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Business Source License 1.1
2
+
3
+ **Licensor:** RESI
4
+ **Licensed Work:** Subnet 46 Validator Software, Incentive Mechanism, Agent Codebase, and associated Model Weights distributed by RESI (the "Licensed Work").
5
+ **Additional Use Grant:** You may use the Licensed Work in production solely for operating a Miner or Validator node within Bittensor Network's Subnet 46, in accordance with the Bittensor protocol rules.
6
+ **Change Date:** January 1, 2030
7
+ **Change License:** Apache License 2.0
8
+
9
+ ---
10
+
11
+ ## Notice
12
+
13
+ Copyright © 2026 RESI. All rights reserved.
14
+
15
+ ---
16
+
17
+ ## Terms and Conditions
18
+
19
+ ### 1. Grant of Rights
20
+
21
+ Subject to the terms and conditions of this License, Licensor hereby grants you a worldwide, royalty-free, non-exclusive license to:
22
+
23
+ a) Copy, modify, and create derivative works of the Licensed Work;
24
+ b) Redistribute the Licensed Work and derivative works; and
25
+ c) Make non-production use of the Licensed Work.
26
+
27
+ Licensor also grants you the Additional Use Grant specified above.
28
+
29
+ ### 2. Restrictions
30
+
31
+ You may **NOT** use the Licensed Work for any of the following purposes without obtaining a separate commercial license from RESI:
32
+
33
+ a) **Competitive Products:** Operating a commercial product or service that competes with RESI or Subnet 46, including but not limited to:
34
+ - Software-as-a-Service (SaaS) offerings
35
+ - API services or hosted platforms
36
+ - Commercial AI model evaluation or scoring services
37
+ - Any service that uses the Licensed Work's methodology outside the Bittensor Network
38
+
39
+ b) **Commercial Distribution:** Selling, licensing, or distributing the Licensed Work or derivative works as a commercial product outside the Bittensor Network;
40
+
41
+ c) **Model Training:** Using the Licensed Work to train, fine-tune, or improve AI models for commercial purposes outside of Subnet 46 mining or validation activities;
42
+
43
+ d) **Unauthorized Production Use:** Any production use outside of the expressly permitted Bittensor Subnet 46 participation.
44
+
45
+ ### 3. Permitted Uses
46
+
47
+ The following uses are **permitted** without obtaining a commercial license:
48
+
49
+ a) Operating Miner or Validator nodes on Bittensor Subnet 46;
50
+ b) Non-production research, testing, development, and evaluation;
51
+ c) Educational and academic purposes;
52
+ d) Contributing improvements back to RESI (subject to the Contributor Agreement);
53
+ e) Internal business evaluation (non-production environments only).
54
+
55
+ ### 4. Change License
56
+
57
+ On the Change Date specified above (January 1, 2030), this Business Source License will automatically terminate, and the Licensed Work will become available under the terms of the Change License (Apache License 2.0).
58
+
59
+ ### 5. Trademark Rights
60
+
61
+ This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Licensed Work.
62
+
63
+ ### 6. Disclaimer of Warranty
64
+
65
+ THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE LICENSOR, CONTRIBUTORS, OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE LICENSED WORK.
66
+
67
+ ### 7. Limitation of Liability
68
+
69
+ TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE LICENSED WORK, EVEN IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
70
+
71
+ ### 8. Termination
72
+
73
+ This License and the rights granted hereunder will terminate automatically if you fail to comply with its terms. Upon termination, you must cease all use and distribution of the Licensed Work. Sections 6 (Disclaimer), 7 (Limitation of Liability), and 9 (General) shall survive any termination.
74
+
75
+ ### 9. General
76
+
77
+ a) **Governing Law:** This License shall be governed by and construed in accordance with the laws of Wyoming, United States, excluding its conflicts of law provisions.
78
+
79
+ b) **Severability:** If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable.
80
+
81
+ c) **Entire Agreement:** This License constitutes the entire agreement between the parties with respect to the Licensed Work.
82
+
83
+ d) **Modifications:** Licensor reserves the right to release the Licensed Work under different license terms or to stop distributing the Licensed Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
84
+
85
+ ---
86
+
87
+ ## Commercial Licensing
88
+
89
+ For commercial use outside the scope of the Additional Use Grant, please contact:
90
+
91
+ **Email:** legal@resilabs.ai
92
+ **Website:** www.resilabs.ai
93
+
94
+ ---
95
+
96
+ ## Contributing
97
+
98
+ If you wish to contribute to this project or submit models to Subnet 46, please review:
99
+
100
+ - **Contributor Agreement:** [CONTRIBUTOR_AGREEMENT.md](./CONTRIBUTOR_AGREEMENT.md)
101
+ - **Terms of Service:** [TERMS_OF_SERVICE.md](./TERMS_OF_SERVICE.md)
102
+
103
+ ---
104
+
105
+ ## Questions?
106
+
107
+ For questions about this license, please contact legal@resilabs.ai
108
+
109
+ ---
110
+
111
+ **Note:** This license is based on the Business Source License 1.1. For more information about BSL, visit: https://mariadb.com/bsl11/
README.md ADDED
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: other
3
+ license_name: resi-exclusive
4
+ license_link: https://huggingface.co/resi-ai/model-license/blob/main/LICENSE
5
+ tags:
6
+ - real-estate
7
+ - onnx
8
+ - bittensor
9
+ - resi
10
+ ---
11
+ # RESI Real Estate Price Prediction Model
12
+
13
+ ONNX model for US residential real estate price prediction.
14
+
15
+ ## Model Details
16
+ - **Input**: 12 float32 features (property attributes, location, census data)
17
+ - **Output**: Predicted price in USD
18
+ - **Format**: ONNX (compatible with onnxruntime 1.20.1)
19
+ - **License**: MIT
feature_config.json ADDED
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "version": "1.0",
3
+ "features": [
4
+ "living_area_sqft",
5
+ "lot_size_sqft",
6
+ "bedrooms",
7
+ "bathrooms",
8
+ "latitude",
9
+ "longitude",
10
+ "home_type_SINGLE_FAMILY",
11
+ "home_type_MULTI_FAMILY",
12
+ "home_type_MANUFACTURED",
13
+ "home_type_LOT",
14
+ "home_type_HOME_TYPE_UNKNOWN",
15
+ "home_type_nan",
16
+ "year_built",
17
+ "stories"
18
+ ]
19
+ }
price_model.onnx ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:7e4aaf8f620abe3c36acdee39a70b9bee472449effd0071d9fa211a385efe787
3
+ size 1837709