Update README.md
Browse files
README.md
CHANGED
|
@@ -1,186 +1,163 @@
|
|
| 1 |
-
# Zen LM ๐
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
|
| 5 |
-
|
| 6 |
|
| 7 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 8 |
|
| 9 |
-
|
| 10 |
|
| 11 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 12 |
|
| 13 |
-
##
|
| 14 |
|
| 15 |
-
|
| 16 |
-
-
|
| 17 |
-
-
|
| 18 |
-
|
|
|
|
|
|
|
| 19 |
|
| 20 |
-
###
|
| 21 |
-
- **100% local processing** - your data never leaves your device
|
| 22 |
-
- No accounts, no telemetry, no tracking
|
| 23 |
-
- Open source and auditable
|
| 24 |
|
| 25 |
-
|
| 26 |
-
-
|
| 27 |
-
|
| 28 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 29 |
|
| 30 |
-
###
|
| 31 |
-
- Apache 2.0 licensed
|
| 32 |
-
- No premium tiers or API fees
|
| 33 |
-
- Supported by grants, not your data
|
| 34 |
|
| 35 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 36 |
|
| 37 |
-
|
| 38 |
-
|-------|------|-------------|-----------|
|
| 39 |
-
| [**zen-nano-instruct**](https://huggingface.co/zenlm/zen-nano-instruct) | 4B | Ultra-fast instruction following |  |
|
| 40 |
-
| [**zen-nano-thinking**](https://huggingface.co/zenlm/zen-nano-thinking) | 4B | Transparent chain-of-thought reasoning |  |
|
| 41 |
-
| [**zen-nano-instruct-4bit**](https://huggingface.co/zenlm/zen-nano-instruct-4bit) | 1.5GB | Quantized for mobile/edge |  |
|
| 42 |
-
| [**zen-nano-thinking-4bit**](https://huggingface.co/zenlm/zen-nano-thinking-4bit) | 1.5GB | Quantized reasoning model |  |
|
| 43 |
-
| [**zen-identity**](https://huggingface.co/datasets/zenlm/zen-identity) | Dataset | Training conversations |  |
|
| 44 |
|
| 45 |
-
|
|
|
|
|
|
|
|
|
|
| 46 |
|
| 47 |
-
###
|
| 48 |
-
```python
|
| 49 |
-
from transformers import AutoModelForCausalLM, AutoTokenizer
|
| 50 |
|
| 51 |
-
|
| 52 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 53 |
|
| 54 |
-
|
| 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 |
-
|
| 61 |
-
|
| 62 |
-
|
|
|
|
| 63 |
|
| 64 |
-
|
| 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 |
-
#
|
| 75 |
-
./llama-cli -m zen-nano-instruct-Q4_K_M.gguf -p "Your prompt here" -n 512
|
| 76 |
-
```
|
| 77 |
-
|
| 78 |
-
## ๐ Performance
|
| 79 |
|
| 80 |
-
|
| 81 |
-
|
| 82 |
-
|
| 83 |
-
|
| 84 |
-
|
| 85 |
-
|
| 86 |
-
|
| 87 |
-
|
| 88 |
-
|
| 89 |
-
|
| 90 |
-
|
| 91 |
-
|
| 92 |
-
|
| 93 |
-
|
| 94 |
-
|
| 95 |
-
|
| 96 |
-
|
| 97 |
-
|
| 98 |
-
|
| 99 |
-
|
| 100 |
-
|
| 101 |
-
|
| 102 |
-
|
| 103 |
-
|
| 104 |
-
|
| 105 |
-
|
| 106 |
-
-
|
| 107 |
-
|
| 108 |
-
|
| 109 |
-
-
|
| 110 |
-
|
| 111 |
-
|
| 112 |
-
-
|
| 113 |
-
|
| 114 |
-
|
| 115 |
-
|
| 116 |
-
|
| 117 |
-
-
|
| 118 |
-
|
| 119 |
-
|
| 120 |
-
|
| 121 |
-
|
| 122 |
-
|
| 123 |
-
|
| 124 |
-
-
|
| 125 |
-
|
| 126 |
-
|
| 127 |
-
|
| 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|