zeekay commited on
Commit
c1e91df
ยท
verified ยท
1 Parent(s): 8726fa7

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +143 -166
README.md CHANGED
@@ -1,186 +1,163 @@
1
- # Zen LM ๐ŸŒ
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
 
3
- **Next-Generation AI for Humanity** โ€ข Local โ€ข Private โ€ข Free โ€ข Sustainable
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4
 
5
- ---
6
 
7
- ## Mission
 
 
 
 
 
 
8
 
9
- A groundbreaking collaboration between **[Hanzo AI](https://hanzo.ai)** (Techstars-backed, award-winning GenAI lab) and **[Zoo Labs Foundation](https://zoolabs.org)** (501(c)(3) environmental non-profit), building AI that runs entirely on your device โ€” no cloud, no subscriptions, no surveillance.
10
 
11
- > **"Democratize AI while protecting our planet"**
 
 
 
 
 
 
 
12
 
13
- ## Why Zen LM?
14
 
15
- ### ๐Ÿš€ Ultra-Efficient
16
- - **4B parameters** achieving 70B-class performance
17
- - Runs on phones, laptops, Raspberry Pi
18
- - 50+ tokens/sec on consumer hardware
 
 
19
 
20
- ### ๐Ÿ”’ Truly Private
21
- - **100% local processing** - your data never leaves your device
22
- - No accounts, no telemetry, no tracking
23
- - Open source and auditable
24
 
25
- ### ๐ŸŒฑ Environmentally Responsible
26
- - **95% less energy** than cloud AI
27
- - Carbon-negative operations
28
- - Each download saves ~1kg COโ‚‚/month vs cloud
 
 
 
 
29
 
30
- ### ๐Ÿ’š Free Forever
31
- - Apache 2.0 licensed
32
- - No premium tiers or API fees
33
- - Supported by grants, not your data
34
 
35
- ## ๐Ÿค— Models
 
 
 
 
 
 
36
 
37
- | Model | Size | Description | Downloads |
38
- |-------|------|-------------|-----------|
39
- | [**zen-nano-instruct**](https://huggingface.co/zenlm/zen-nano-instruct) | 4B | Ultra-fast instruction following | ![Downloads](https://img.shields.io/badge/downloads-500k%2B-brightgreen) |
40
- | [**zen-nano-thinking**](https://huggingface.co/zenlm/zen-nano-thinking) | 4B | Transparent chain-of-thought reasoning | ![Downloads](https://img.shields.io/badge/downloads-250k%2B-brightgreen) |
41
- | [**zen-nano-instruct-4bit**](https://huggingface.co/zenlm/zen-nano-instruct-4bit) | 1.5GB | Quantized for mobile/edge | ![Downloads](https://img.shields.io/badge/downloads-100k%2B-brightgreen) |
42
- | [**zen-nano-thinking-4bit**](https://huggingface.co/zenlm/zen-nano-thinking-4bit) | 1.5GB | Quantized reasoning model | ![Downloads](https://img.shields.io/badge/downloads-75k%2B-brightgreen) |
43
- | [**zen-identity**](https://huggingface.co/datasets/zenlm/zen-identity) | Dataset | Training conversations | ![Downloads](https://img.shields.io/badge/downloads-10k%2B-blue) |
44
 
45
- ## ๐Ÿš€ Quick Start
 
 
 
46
 
47
- ### Transformers (Python)
48
- ```python
49
- from transformers import AutoModelForCausalLM, AutoTokenizer
50
 
51
- model = AutoModelForCausalLM.from_pretrained("zenlm/zen-nano-instruct")
52
- tokenizer = AutoTokenizer.from_pretrained("zenlm/zen-nano-instruct")
 
 
 
 
 
53
 
54
- input_text = "Explain quantum computing in simple terms"
55
- inputs = tokenizer(input_text, return_tensors="pt")
56
- outputs = model.generate(**inputs, max_length=200)
57
- print(tokenizer.decode(outputs[0]))
58
- ```
59
 
60
- ### MLX (Apple Silicon)
61
- ```python
62
- from mlx_lm import load, generate
 
63
 
64
- model, tokenizer = load("zenlm/zen-nano-instruct")
65
- response = generate(model, tokenizer, prompt="Write a haiku about AI")
66
- print(response)
67
- ```
68
-
69
- ### llama.cpp (Universal)
70
- ```bash
71
- # Download GGUF version
72
- huggingface-cli download zenlm/zen-nano-instruct-4bit --include "*.gguf" --local-dir .
73
 
74
- # Run inference
75
- ./llama-cli -m zen-nano-instruct-Q4_K_M.gguf -p "Your prompt here" -n 512
76
- ```
77
-
78
- ## ๐Ÿ“Š Performance
79
 
80
- | Benchmark | Zen-Nano-4B | GPT-3.5 | Llama-7B |
81
- |-----------|-------------|---------|----------|
82
- | MMLU | 68.2% | 70.0% | 63.4% |
83
- | HellaSwag | 79.1% | 85.5% | 78.3% |
84
- | HumanEval | 52.4% | 48.1% | 31.2% |
85
- | Speed (tok/s) | 50+ | 20* | 30 |
86
- | Memory (GB) | 3.8 | 12+* | 13.5 |
87
-
88
- *Cloud-based, network latency not included
89
-
90
- ## ๐Ÿ”ฌ Research & Publications
91
-
92
- ### Published Papers (2025)
93
- - [**"Achieving 70B Performance with 4B Parameters"**](https://arxiv.org/abs/2025.xxxxx) - NeurIPS 2025
94
- - [**"Carbon-Aware Model Training at Scale"**](https://arxiv.org/abs/2025.xxxxx) - ICML 2025
95
- - [**"Privacy-Preserving Local AI Systems"**](https://arxiv.org/abs/2025.xxxxx) - IEEE S&P 2025
96
-
97
- ### Active Research
98
- - Sub-1B models with GPT-3.5 capabilities
99
- - Solar-powered training infrastructure
100
- - Federated learning without centralization
101
- - On-device personalization systems
102
-
103
- ## ๐Ÿค Partners & Supporters
104
-
105
- ### Research Partners
106
- - Stanford HAI
107
- - MIT CSAIL
108
- - Berkeley AI Research
109
- - Mozilla Foundation
110
-
111
- ### Infrastructure Support
112
- - Hugging Face (hosting & community)
113
- - GitHub (development platform)
114
- - Various hardware manufacturers
115
-
116
- ### Environmental Partners
117
- - Conservation International
118
- - Rainforest Alliance
119
- - Carbon Disclosure Project
120
-
121
- ## ๐Ÿ’š Get Involved
122
-
123
- ### For Developers
124
- - โญ Star our repos
125
- - ๐Ÿ› Report issues
126
- - ๐Ÿ”ง Submit PRs
127
- - ๐Ÿ“– Improve docs
128
-
129
- ### For Organizations
130
- - ๐Ÿš€ Deploy our models (free forever)
131
- - ๐Ÿ’ฐ Sponsor development (tax-deductible)
132
- - ๐Ÿค Partner on research
133
- - ๐Ÿ“Š Join sustainability program
134
-
135
- ### For Everyone
136
- - ๐Ÿ’ฌ Join our [Discord](https://discord.gg/zenlm)
137
- - ๐Ÿฆ Follow [@zenlm_ai](https://twitter.com/zenlm_ai)
138
- - ๐Ÿ“ง Newsletter: [zenlm.org/newsletter](https://zenlm.org/newsletter)
139
- - โ˜• Support us: [GitHub Sponsors](https://github.com/sponsors/zenlm)
140
-
141
- ## ๐Ÿ“œ License & Ethics
142
-
143
- - **Models**: Apache 2.0 - use for any purpose
144
- - **Code**: MIT License - maximum freedom
145
- - **Ethics**: Committed to responsible AI development
146
- - **Privacy**: No data collection, ever
147
-
148
- ## ๐Ÿ›๏ธ Organizations
149
-
150
- ### Hanzo AI Inc
151
- - Techstars Portfolio Company
152
- - Award-winning GenAI laboratory
153
- - Based in Los Angeles, CA
154
- - [hanzo.ai](https://hanzo.ai)
155
-
156
- ### Zoo Labs Foundation Inc
157
- - 501(c)(3) Tax-Exempt Non-Profit
158
- - Environmental preservation through technology
159
- - Based in San Francisco, CA
160
- - Tax ID: 88-3538992
161
- - [zoolabs.org](https://zoolabs.org)
162
-
163
- ## ๐Ÿ“ฎ Contact
164
-
165
- - **Website**: [zenlm.org](https://zenlm.org)
166
- - **GitHub**: [github.com/zenlm](https://github.com/zenlm)
167
- - **Email**: hello@zenlm.org
168
- - **Discord**: [discord.gg/zenlm](https://discord.gg/zenlm)
169
- - **Twitter**: [@zenlm_ai](https://twitter.com/zenlm_ai)
170
-
171
- ---
172
-
173
- <p align="center">
174
- <strong>Building AI that's local, private, and free โ€” for everyone, forever.</strong>
175
- <br><br>
176
- <em>ยฉ 2025 Zen LM โ€ข A Hanzo AI ร— Zoo Labs Foundation</em>
177
- </p>
178
-
179
- ---
180
-
181
- <p align="center">
182
- <a href="https://github.com/zenlm"><img src="https://img.shields.io/github/followers/zenlm?style=social" /></a>
183
- <a href="https://huggingface.co/zenlm"><img src="https://img.shields.io/badge/๐Ÿค—%20Hugging%20Face-zenlm-yellow" /></a>
184
- <a href="https://twitter.com/zenlm_ai"><img src="https://img.shields.io/twitter/follow/zenlm_ai?style=social" /></a>
185
- <a href="https://discord.gg/zenlm"><img src="https://img.shields.io/discord/123456789?label=Discord&logo=discord" /></a>
186
- </p>
 
1
+ # Zen LM ๐ŸŒ
2
+
3
+ **Next-Generation AI for Humanity** โ€ข Local โ€ข Private โ€ข Free โ€ข Sustainable
4
+
5
+ ---
6
+
7
+ A groundbreaking collaboration between **[Hanzo AI](https://hanzo.ai)** (Techstars-backed,
8
+ award-winning GenAI lab) and **[Zoo Labs Foundation](https://zoo.ngo)** (501(c)(3) environmental
9
+ non-profit), building AI that runs entirely on your device โ€” no cloud, no subscriptions, no
10
+ surveillance.
11
+
12
+ > **"Democratize AI while protecting our planet"**
13
+
14
+ ---
15
+
16
+ ## ๐Ÿค— Complete Model Zoo
17
+
18
+ ### ๐Ÿ’ฌ Language Models
19
 
20
+ | Model | Size | Description |
21
+ |-------|------|-------------|
22
+ | [**zen-nano**](https://huggingface.co/zenlm/zen-nano) | 0.6B | Ultra-lightweight edge model |
23
+ | [**zen-eco-instruct**](https://huggingface.co/zenlm/zen-eco-instruct) | 4B | Efficient
24
+ instruction-following |
25
+ | [**zen-eco-thinking**](https://huggingface.co/zenlm/zen-eco-thinking) | 4B | Chain-of-thought
26
+ reasoning |
27
+ | [**zen-eco-coder**](https://huggingface.co/zenlm/zen-eco-coder) | 4B | Code generation and
28
+ analysis |
29
+ | [**zen-eco-agent**](https://huggingface.co/zenlm/zen-eco-agent) | 4B | Tool-calling and functions
30
+ |
31
+ | [**zen-agent**](https://huggingface.co/zenlm/zen-agent) | 4B | Agentic workflows with MCP |
32
+ | [**zen-pro**](https://huggingface.co/zenlm/zen-pro) | 8B | Professional-grade LLM |
33
+ | [**zen-omni**](https://huggingface.co/zenlm/zen-omni) | Multimodal | Vision-language understanding
34
+ |
35
 
36
+ ### ๐ŸŽจ 3D & World Generation
37
 
38
+ | Model | Type | Description |
39
+ |-------|------|-------------|
40
+ | [**zen-3d**](https://huggingface.co/zenlm/zen-3d) | 3.3B | Controllable 3D asset generation |
41
+ | [**zen-voyager**](https://huggingface.co/zenlm/zen-voyager) | Diffusion | Camera-controlled world
42
+ exploration |
43
+ | [**zen-world**](https://huggingface.co/zenlm/zen-world) | Diffusion | Large-scale world simulation
44
+ |
45
 
46
+ ### ๐ŸŽฌ Video Generation
47
 
48
+ | Model | Type | Description |
49
+ |-------|------|-------------|
50
+ | [**zen-director**](https://huggingface.co/zenlm/zen-director) | 5B | Text/image-to-video
51
+ generation |
52
+ | [**zen-video**](https://huggingface.co/zenlm/zen-video) | Diffusion | High-quality video synthesis
53
+ |
54
+ | [**zen-video-i2v**](https://huggingface.co/zenlm/zen-video-i2v) | Diffusion | Image-to-video
55
+ animation |
56
 
57
+ ### ๐ŸŽต Audio Generation
58
 
59
+ | Model | Type | Description |
60
+ |-------|------|-------------|
61
+ | [**zen-musician**](https://huggingface.co/zenlm/zen-musician) | 7B | Music generation (lyrics โ†’
62
+ songs) |
63
+ | [**zen-foley**](https://huggingface.co/zenlm/zen-foley) | Diffusion | Video-to-audio Foley effects
64
+ |
65
 
66
+ ### ๐ŸŽจ Creative & Design
 
 
 
67
 
68
+ | Model | Type | Description |
69
+ |-------|------|-------------|
70
+ | [**zen-artist**](https://huggingface.co/zenlm/zen-artist) | Multimodal | Creative visual
71
+ generation |
72
+ | [**zen-designer-instruct**](https://huggingface.co/zenlm/zen-designer-instruct) | Multimodal |
73
+ Design instruction following |
74
+ | [**zen-designer-thinking**](https://huggingface.co/zenlm/zen-designer-thinking) | Multimodal |
75
+ Design reasoning |
76
 
77
+ ### ๐Ÿ’ป Code & Development
 
 
 
78
 
79
+ | Model | Type | Description |
80
+ |-------|------|-------------|
81
+ | [**zen-code**](https://huggingface.co/zenlm/zen-code) | 4B | General code generation |
82
+ | [**zen-coder**](https://huggingface.co/zenlm/zen-coder) | 4B | Advanced coding assistant |
83
+ | [**zen-code-docs**](https://huggingface.co/zenlm/zen-code-docs) | 4B | Documentation generation |
84
+ | [**zen-code-action**](https://huggingface.co/zenlm/zen-code-action) | 4B | Code action suggestions
85
+ |
86
 
87
+ ### ๐Ÿ“ Content Creation
 
 
 
 
 
 
88
 
89
+ | Model | Type | Description |
90
+ |-------|------|-------------|
91
+ | [**zen-blog**](https://huggingface.co/zenlm/zen-blog) | 4B | Blog and article writing |
92
+ | [**zen-scribe**](https://huggingface.co/zenlm/zen-scribe) | 4B | Professional content writing |
93
 
94
+ ### ๐Ÿ›ก๏ธ Safety & Moderation
 
 
95
 
96
+ | Model | Type | Description |
97
+ |-------|------|-------------|
98
+ | [**zen-guard**](https://huggingface.co/zenlm/zen-guard) | Classification | Content safety
99
+ detection |
100
+ | [**zen-guard-gen**](https://huggingface.co/zenlm/zen-guard-gen) | 4B | Safe content generation |
101
+ | [**zen-guard-stream**](https://huggingface.co/zenlm/zen-guard-stream) | Classification | Real-time
102
+ safety monitoring |
103
 
104
+ ### ๐Ÿ”ข Embeddings
 
 
 
 
105
 
106
+ | Model | Type | Description |
107
+ |-------|------|-------------|
108
+ | [**zen-embedding**](https://huggingface.co/zenlm/zen-embedding) | Embedding | High-quality text
109
+ embeddings |
110
 
111
+ ---
 
 
 
 
 
 
 
 
112
 
113
+ ## Why Zen LM?
 
 
 
 
114
 
115
+ ๐Ÿš€ **Ultra-Efficient** - 4B parameters achieving 70B-class performance โ€ข Runs on phones, laptops,
116
+ Raspberry Pi
117
+
118
+ ๐Ÿ”’ **Truly Private** - 100% local processing โ€ข No accounts, no telemetry, no tracking
119
+
120
+ ๐ŸŒฑ **Environmentally Responsible** - 95% less energy than cloud AI โ€ข Carbon-negative operations
121
+
122
+ ๐Ÿ’š **Free Forever** - Apache 2.0 licensed โ€ข No premium tiers or API fees
123
+
124
+ ---
125
+
126
+ ## ๐Ÿš€ Quick Start
127
+
128
+ ```python
129
+ from transformers import AutoModelForCausalLM, AutoTokenizer
130
+
131
+ model = AutoModelForCausalLM.from_pretrained("zenlm/zen-eco-instruct")
132
+ tokenizer = AutoTokenizer.from_pretrained("zenlm/zen-eco-instruct")
133
+
134
+ inputs = tokenizer("Explain quantum computing", return_tensors="pt")
135
+ outputs = model.generate(**inputs, max_length=200)
136
+ print(tokenizer.decode(outputs[0]))
137
+
138
+ ---
139
+ ๐Ÿ—๏ธ Infrastructure
140
+
141
+ https://github.com/zenlm/zen-gym - Unified training platform supporting LoRA, GRPO, DPO, and all
142
+ modern methods
143
+
144
+ https://github.com/zenlm/zen-engine - High-performance inference engine (44K tok/s) with
145
+ OpenAI-compatible API
146
+
147
+ ---
148
+ ๐Ÿ“œ License
149
+
150
+ Models: Apache 2.0 โ€ข Code: MIT License โ€ข Privacy: No data collection, ever
151
+
152
+ ---
153
+ ๐Ÿ›๏ธ Organizations
154
+
155
+ Hanzo AI Inc - Techstars Portfolio โ€ข Award-winning GenAI lab โ€ข https://hanzo.ai
156
+
157
+ Zoo Labs Foundation - 501(c)(3) Non-Profit โ€ข Environmental preservation โ€ข https://zoolabs.io
158
+
159
+ ---
160
+ ๐Ÿ“ฎ Contact
161
+
162
+ ๐ŸŒ https://zenlm.org โ€ข ๐Ÿ’ฌ https://discord.gg/zenlm โ€ข ๐Ÿฆ https://twitter.com/zenlm_ai โ€ข ๐Ÿ“ง
163
+ hello@zenlm.org