vinguyen0891 commited on
Commit
ca4c3ce
·
verified ·
1 Parent(s): 056f824

Upgrade to Vivy-V-Robotics-Micro-Edge (Vivy-V Optimized Thinking Core): Open-source weights + encrypted .vcore architecture & archive legacy Vivy.v6

Browse files
LEGACY_VIVY_V6_ARCHIVE_STAMP.json ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "model_id": "Vivy-V-Robotics-Micro-Edge",
3
+ "legacy_v6_id": "Vivy-R-Robotics-Micro-Edge (v7.4)",
4
+ "legacy_v6_status": "ARCHIVED_LEGACY_VIVY_V6",
5
+ "active_generation": "Vivy-V (Upgraded Version \u2014 Optimized Thinking Core)",
6
+ "open_source_weights": true,
7
+ "architecture_encrypted": true,
8
+ "open_source_architecture": false
9
+ }
Modelfile ADDED
@@ -0,0 +1,11 @@
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Modelfile.vivy-v — Vivy-V-Robotics-Micro-Edge
2
+ # Generation: Vivy-V (Upgraded Version — Optimized Thinking Core)
3
+ # Legacy Supersession: Vivy-R-Robotics-Micro-Edge (v7.4) [ARCHIVED_LEGACY_VIVY_V6]
4
+ # Weights Policy: Open-Source Full Weights (vivy-v-robotics-micro-edge-q4_k_m.gguf + vivy-v-robotics-micro-edge_weights.safetensors, sha256=a8d391d7481d6821de83dbad65ac9a49c41e97a7f8a4a47262ed98de83e1e4d1)
5
+ # Architecture Policy: Encrypted Vivy-V Architecture (vivy-v-robotics-micro-edge_arch.vcore, format=VIVY_V_ARCH_ENC_V1, sha256=b03579f1300a9cc8ce2693ea1749ee17e659cfe1623005a3dc31afa77641c466)
6
+ FROM ./vivy-v-robotics-micro-edge-q4_k_m.gguf
7
+ ADAPTER ./vivy-v-robotics-micro-edge_weights.safetensors
8
+ PARAMETER temperature 0.15
9
+ PARAMETER top_p 0.90
10
+ PARAMETER num_ctx 32768
11
+ SYSTEM """You are Vivy-V-Robotics-Micro-Edge (Vivy-V generation), an upgraded AI model with an optimized thinking core for accurate, structured, and reliable reasoning."""
Modelfile.vivy-v ADDED
@@ -0,0 +1,11 @@
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Modelfile.vivy-v — Vivy-V-Robotics-Micro-Edge
2
+ # Generation: Vivy-V (Upgraded Version — Optimized Thinking Core)
3
+ # Legacy Supersession: Vivy-R-Robotics-Micro-Edge (v7.4) [ARCHIVED_LEGACY_VIVY_V6]
4
+ # Weights Policy: Open-Source Full Weights (vivy-v-robotics-micro-edge-q4_k_m.gguf + vivy-v-robotics-micro-edge_weights.safetensors, sha256=a8d391d7481d6821de83dbad65ac9a49c41e97a7f8a4a47262ed98de83e1e4d1)
5
+ # Architecture Policy: Encrypted Vivy-V Architecture (vivy-v-robotics-micro-edge_arch.vcore, format=VIVY_V_ARCH_ENC_V1, sha256=b03579f1300a9cc8ce2693ea1749ee17e659cfe1623005a3dc31afa77641c466)
6
+ FROM ./vivy-v-robotics-micro-edge-q4_k_m.gguf
7
+ ADAPTER ./vivy-v-robotics-micro-edge_weights.safetensors
8
+ PARAMETER temperature 0.15
9
+ PARAMETER top_p 0.90
10
+ PARAMETER num_ctx 32768
11
+ SYSTEM """You are Vivy-V-Robotics-Micro-Edge (Vivy-V generation), an upgraded AI model with an optimized thinking core for accurate, structured, and reliable reasoning."""
README.md CHANGED
@@ -1,82 +1,70 @@
1
  ---
2
- license: other
3
- license_name: vcesl-1.0-commercial-enterprise
4
- library_name: vivy-core
 
 
5
  tags:
6
- - robotics
7
- - embedded-ai
8
- - edge-robotics
9
- - microduck
10
- - sim-to-real
11
- - low-resource
12
- - real-time-50hz
13
  ---
14
 
15
- # Vivy-R-Robotics-Micro-Edge — Ultra-Compact, Flexible & Blazingly Fast Robotics Core for Constrained Hardware
16
 
17
- **`Vivy-R-Robotics-Micro-Edge`** (`R-ROBOTICS-MICRO-EDGE`) is an ultra-lightweight embedded robotics edition of **Vivy**, engineered specifically so researchers, makers, and robotics developers can run **high-agility, real-time 50 Hz control on severely resource-constrained hardware**—or test and study it directly on any standard CPU without requiring dedicated GPUs or expensive robot rigs.
18
-
19
- > **Interactive 50 Hz Browser Explorer (No Hardware Required):** Try the live multi-morphology 50 Hz control loop and trajectory oscilloscope directly in your browser at [**`https://huggingface.co/spaces/vinguyen0891/Vivy-Micro-Edge-50Hz-Explorer`**](https://huggingface.co/spaces/vinguyen0891/Vivy-Micro-Edge-50Hz-Explorer).
 
 
 
20
 
21
  ---
22
 
23
- ## Why `Vivy-R-Robotics-Micro-Edge`?
 
 
24
 
25
- 1. **Ultra-Compact Footprint (`93.58 KB` on disk / `96.08 KB` active RAM):**
26
- - Contains **`24,597` parameters** (`98,388` bytes uncompressed FP32 RAM), **`123,170x` smaller** than standard 3B desktop robotics models.
27
- - Fits effortlessly inside CPU L2 cache on **`512 MB – 1 GB RAM`** single-board computers (`Radxa Zero 3W RK3566`, `Raspberry Pi Zero 2 W`, `Milk-V Duo S RISC-V`, `NVIDIA Jetson Orin Nano`).
28
- 2. **Blazingly Fast Real-Time Execution (`0.1353 ms` mean latency at 50 Hz):**
29
- - Executes a complete 50 Hz (`20.0 ms` frame budget) control tick in **`0.1353 ms` mean / `0.6089 ms` p99** on a single CPU thread (**`395x` faster** than the `20.0 ms` real-time deadline, with zero GPU required).
30
- 3. **Highly Flexible Across Skills & Robot Morphologies:**
31
- - Seamlessly handles **8 dynamic locomotion, fall-recovery, and manipulation skills** (`Omnidirectional Rough-Terrain Walk`, `Push/Fall Stand-Up Recovery`, `Supine/Prone 180° Rise`, `Sit/Stand`, `Ground Pick`, `Ball Kick`, `360° Forward Roulade`, and `Roller-Skate Locomotion`) with `±1°` gear backlash and battery voltage-sag resilience.
32
- - Adapts across **4 embedded robot morphologies** (`14-DoF Biped`, `12-DoF Mini-Quadruped`, `6-DoF Embedded Arm`, and `23-DoF Compact Humanoid`) using the same sub-100 KB `.vcore` package.
33
- 4. **Encrypted 3-Cores-in-1 `.vcore` Container (`VIVY_CORE_TRI_ENC_V1`):**
34
- - Packaged in the proprietary `.vcore` binary format (`vivy_r_robotics_micro_edge.vcore`, `SHA-256 = 126dc69d58756cd6d95d74e63a258df84e9f2404c1dfa8436e3d46ddbfe040ee`, `open_source_weights = False`) with in-memory verification.
35
 
36
  ---
37
 
38
- ## Key Specifications
 
 
39
 
40
- | Metric | `Vivy-R-Robotics-Micro-Edge` | Advantage on Constrained Hardware |
41
- |---|---|---|
42
- | **Model Format** | `.vcore` (`VIVY_CORE_TRI_ENC_V1`) | Self-contained 3-Cores-in-1 binary |
43
- | **File Size** | **`95,824` bytes (`93.58 KB`)** | Instant load on Flash / SD / eMMC |
44
- | **Active RAM Footprint** | **`98,388` bytes (`96.08 KB`)** | Runs comfortably on `512 MB` – `1 GB` RAM boards |
45
- | **Total Parameters** | **`24,597`** | `123,170.7x` smaller than 3B models |
46
- | **Control Frequency** | **`50 Hz` (`dt = 20.0 ms`)** | Compatible with `1 Mbps` Dynamixel / CAN-FD buses |
47
- | **Single-Thread CPU Latency** | **`0.1353 ms` mean / `0.6089 ms` p99** | `395x` faster than the `20.0 ms` real-time budget |
48
- | **Sim-to-Real Task Pass Rate** | **`8 / 8` (`100.0%`)** | Walk, StandUp, SitStand, GroundPick, BallKick, Roulade, Rollers |
49
 
50
  ---
51
 
52
- ## Multi-Morphology Flexibility Benchmark (50 Hz Real-Time Loop)
53
 
54
- | Morphology ID | Robot Configuration | Tensor I/O | Mean Latency | P99 Latency | Real-Time Headroom | Target Constrained Hardware |
55
- |---|---|---|---|---|---|---|
56
- | `microduck_biped_14dof` | Microduck 14-DoF Biped (+1 Mouth Servo) | `61 -> 14` | `0.0651 ms` | `0.1714 ms` | `307.2x` faster | Radxa Zero 3W (RK3566 1 GB RAM) + 15x Dynamixel XL330 |
57
- | `mini_quadruped_12dof` | Agile Mini-Quadruped 12-DoF (3-DoF x 4 Legs) | `48 -> 12` | `0.0913 ms` | `0.2512 ms` | `219.1x` faster | Raspberry Pi Zero 2 W (512 MB RAM) / CAN-FD Servo Bus |
58
- | `embedded_arm_6dof` | Lightweight 6-DoF Embedded Manipulator Arm | `28 -> 6` | `0.0839 ms` | `0.1733 ms` | `238.3x` faster | Milk-V Duo S (RISC-V 512 MB RAM) / UART Bus |
59
- | `compact_humanoid_23dof` | Compact 23-DoF Agile Humanoid | `88 -> 23` | `0.3010 ms` | `3.6760 ms` | `66.4x` faster | NVIDIA Jetson Orin Nano (4 GB) / RK3588S Edge SBC |
60
 
61
- ---
 
 
62
 
63
- ## Quickstart — Download & Research Without Specialized Hardware
 
 
64
 
65
- You do **not** need physical robot hardware or a dedicated GPU to inspect and benchmark `Vivy-R-Robotics-Micro-Edge`. Download this repository and run the self-contained research script on any laptop, desktop, or embedded SBC:
66
 
67
  ```bash
68
- # 1. Download from HuggingFace Hub
69
- pip install -U huggingface_hub
70
- hf download vinguyen0891/Vivy-R-Robotics-Micro-Edge --local-dir ./Vivy-R-Robotics-Micro-Edge
71
-
72
- # 2. Run the zero-dependency 50 Hz verification & multi-morphology benchmark
73
- cd Vivy-R-Robotics-Micro-Edge
74
- python run_vivy_micro_edge_research_demo.py
75
  ```
76
 
77
- ### Included Files in This Research Bundle
78
- - `vivy_r_robotics_micro_edge.vcore` — Encrypted 3-Cores-in-1 ultra-compact model (`95,824` bytes).
79
- - `vivy-r-robotics-micro-edge.manifest.json` — Hardware compatibility, latency, and SHA-256 manifest.
80
- - `run_vivy_micro_edge_research_demo.py` — Standalone zero-dependency 50 Hz benchmark & container verifier.
81
- - `embedded_cross_compile_targets.json` — Target matrix for `ARM64`, `ARMv7`, `RISC-V 64`, and `x86_64`.
82
- - `c_abi_header/vivy_micro_edge_abi.h` — C11/C++ header for native firmware integration.
 
1
  ---
2
+ license: apache-2.0
3
+ library_name: gguf
4
+ base_model: Qwen/Qwen2.5-3B-Instruct
5
+ language:
6
+ - en
7
  tags:
8
+ - vivy-v
9
+ - upgraded-thinking-core
10
+ - open-weights
11
+ - gguf
12
+ - safetensors
 
 
13
  ---
14
 
15
+ # Vivy-V-Robotics-Micro-Edge — Vivy-V Upgraded Generation (Optimized Thinking Core)
16
 
17
+ - **Model Family:** `Vivy-V`
18
+ - **Model ID:** `Vivy-V-Robotics-Micro-Edge`
19
+ - **Domain Focus:** Embedded Constrained-Hardware Control Thinking Core
20
+ - **Parameter Class:** 0.50B Embedded + Vivy-V Micro Core
21
+ - **Release Policy:** **Open-Source Model Weights (`Apache-2.0`)** + **Encrypted Proprietary `Vivy-V` Architecture (`.vcore`)**
22
+ - **Legacy Lineage Stamp:** Replaces `Vivy-R-Robotics-Micro-Edge (v7.4)` (`[ARCHIVED_LEGACY_VIVY_V6]`)
23
 
24
  ---
25
 
26
+ ## Overview
27
+
28
+ **`Vivy-V-Robotics-Micro-Edge`** is the upgraded **`Vivy-V`** generation release featuring an **optimized thinking core** for faster decision-making, lower runtime memory overhead, and higher response consistency.
29
 
30
+ All legacy **`Vivy.v6`** releases (`Vivy-R-Robotics-Micro-Edge (v7.4)`) have been officially archived and stamped as legacy versions (`[ARCHIVED_LEGACY_VIVY_V6]`).
 
 
 
 
 
 
 
 
 
31
 
32
  ---
33
 
34
+ ## Model Files & Packaging Structure
35
+
36
+ In accordance with the `Vivy-V` release policy, **model weights are open-source** while the **internal `Vivy-V` thinking-core architecture is cryptographically encapsulated**:
37
 
38
+ | File | Role | Open-Source / Encrypted | Format |
39
+ |---|---|---|---|
40
+ | `vivy-v-robotics-micro-edge-q4_k_m.gguf` | Complete full-weight quantized backbone (`Q4_K_M`) | **Open-Source Weights (`Apache-2.0`)** | `GGUF v3` |
41
+ | `vivy-v-robotics-micro-edge_weights.safetensors` | Complete `Vivy-V` fine-tuned weight tensors (`weights.layer_*`, SHA-256: `a8d391d7481d6821...`) | **Open-Source Weights (`Apache-2.0`)** | `.safetensors` |
42
+ | `vivy-v-robotics-micro-edge_arch.vcore` | Encrypted `Vivy-V` thinking-core architecture & routing topology (SHA-256: `b03579f1300a9cc8...`) | **Encrypted Architecture (`VIVY_V_ARCH_ENC_V1`)** | `.vcore` (`VCORE3`) |
43
+ | `Modelfile` / `Modelfile.vivy-v` | Complete model definition linking full weights and adapter tensors | **Open-Source Configuration** | `Modelfile` |
 
 
 
44
 
45
  ---
46
 
47
+ ## Quick Start
48
 
49
+ ### 1. Run with `llama.cpp` or `Ollama` (`Modelfile`)
 
 
 
 
 
50
 
51
+ ```bash
52
+ # Build model from the complete Modelfile
53
+ ollama create vivy-v-robotics-micro-edge:vivy-v -f Modelfile
54
 
55
+ # Run interactive inference
56
+ ollama run vivy-v-robotics-micro-edge:vivy-v
57
+ ```
58
 
59
+ ### 2. Direct `llama-server` Execution
60
 
61
  ```bash
62
+ llama-server -m ./vivy-v-robotics-micro-edge-q4_k_m.gguf --port 8080 -c 8192
 
 
 
 
 
 
63
  ```
64
 
65
+ ---
66
+
67
+ ## Version History & Legacy Archive Notice
68
+
69
+ - **`Vivy-V` (`Current Active Release`):** Upgraded generation featuring an optimized thinking core, full open-source weights (`.gguf` + `.safetensors` + `Modelfile`), and encrypted `Vivy-V` architecture (`.vcore`).
70
+ - **`Vivy.v6` (`[ARCHIVED_LEGACY_VIVY_V6]`):** All prior `Vivy.v6` / `R`-Series versions (`v6.0` – `v7.4`) are archived as historical legacy releases.
config.json ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "model_id": "Vivy-V-Robotics-Micro-Edge",
3
+ "generation": "Vivy-V",
4
+ "summary": "Upgraded Vivy-V version with an optimized thinking core.",
5
+ "parameter_class": "0.50B Embedded + Vivy-V Micro Core",
6
+ "declared_parameters": 495000000,
7
+ "open_source_weights": true,
8
+ "weights_license": "apache-2.0",
9
+ "architecture_encrypted": true,
10
+ "open_source_architecture": false,
11
+ "architecture_format": "VIVY_V_ARCH_ENC_V1 (.vcore)",
12
+ "legacy_vivy_v6_reference": {
13
+ "legacy_id": "Vivy-R-Robotics-Micro-Edge (v7.4)",
14
+ "status": "ARCHIVED_LEGACY_VIVY_V6"
15
+ },
16
+ "files": {
17
+ "gguf_weights": "vivy-v-robotics-micro-edge-q4_k_m.gguf",
18
+ "gguf_size_bytes": 491400032,
19
+ "safetensors_weights": "vivy-v-robotics-micro-edge_weights.safetensors",
20
+ "safetensors_size_bytes": 927148,
21
+ "safetensors_sha256": "a8d391d7481d6821de83dbad65ac9a49c41e97a7f8a4a47262ed98de83e1e4d1",
22
+ "safetensors_tensor_count": 108,
23
+ "encrypted_architecture_vcore": "vivy-v-robotics-micro-edge_arch.vcore",
24
+ "encrypted_architecture_size_bytes": 6613,
25
+ "encrypted_architecture_sha256": "b03579f1300a9cc8ce2693ea1749ee17e659cfe1623005a3dc31afa77641c466",
26
+ "modelfile": "Modelfile"
27
+ }
28
+ }
vivy-v-robotics-micro-edge_arch.vcore ADDED
Binary file (6.61 kB). View file
 
vivy-v-robotics-micro-edge_weights.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:a8d391d7481d6821de83dbad65ac9a49c41e97a7f8a4a47262ed98de83e1e4d1
3
+ size 927148