mirror of
https://github.com/hanzoai/papers.git
synced 2026-10-30 14:58:42 +00:00
`make -k all` returned 0 over any number of broken papers, so CI was green the
whole time it existed. Four things had to be true for that:
- every recipe line ended in `|| true` and the rule printed "FAIL" instead of
exiting, so make never saw a failure;
- nonstopmode emits a PDF for almost any input, so "the PDF exists" is not
the same question as "the paper compiled" — zen-nano_whitepaper produced
one through 23 LaTeX errors;
- pdfs/ was tracked, so a checkout handed the "check every paper came out"
step 100 of the PDFs it was about to look for;
- discovery was three wildcards, so 69 of the repo's 219 papers were
compiled by nothing at all, defense/ by a second copy of the same
swallowing loop written inline in ci.yml.
The rule is now one latexmk per paper and its exit status is the gate:
-halt-on-error (no PDF from a broken paper), -bibtex (a declared bibliography
must resolve rather than being skipped when the .bib is absent), -Werror (an
undefined citation is a defect, not a log note), -cd (each paper compiles from
its own directory, so zen/ finds references.bib and defense/ finds
hanzo-defense.sty). .DELETE_ON_ERROR so a failed run leaves nothing behind,
and pdfs/ is untracked because it is output.
Run against the tree it was guarding, the honest gate fails 24 papers:
6 \begin{itemize} with its backslash-b eaten, leaving a bare `egin{itemize}`
and no \end — artist, designer-instruct, eco, nano, next, omni
3 the same list with the opener deleted outright, so five \item stood in no
environment — artist-edit, designer-thinking, scribe
4 \and in a cover page's raw \@author: it expands to \end{tabular} and closed
a tabular nothing had opened, and \thanks left hyperref pointing at a
footnote anchor that was never created; plus five stray \end{table} at the
end of those documents — director, foley, musician, video
9 \color{gray} under \usepackage{color}, which defines eight names and not
that one — xcolor is the superset the working papers already load
6 \bibliography{references} naming a database that was never written, so
every citation rendered [?] — zen/references.bib now holds all 27 works
9 \bibliographystyle+\bibliography in papers with no \cite at all — dropped
3 characters pdflatex has no glyph for: CO₂ -> CO\textsubscript{2},
↔ -> $\leftrightarrow$, Persian letters -> their code points, the
SentencePiece marker -> \textvisiblespace
1 \IF{...} \COMMENT{...}: algorithmic's \IF opens a list and the comment
landed in it before any \item; the comment slot is \IF[...]{...}
1 \ref{eq:anchor_update} to an equation the paper never writes
All 219 papers now compile from a clean tree: `make -k all` exits 0.
Co-authored-by: Hanzo Dev <[email protected]>
324 lines
9.2 KiB
TeX
324 lines
9.2 KiB
TeX
\documentclass[11pt,a4paper]{article}
|
|
\usepackage[utf8]{inputenc}
|
|
\usepackage[T1]{fontenc}
|
|
\usepackage{amsmath,amsfonts,amssymb}
|
|
\usepackage{graphicx}
|
|
\usepackage{hyperref}
|
|
\usepackage{listings}
|
|
\usepackage{xcolor}
|
|
\usepackage{booktabs}
|
|
\usepackage{float}
|
|
\usepackage{geometry}
|
|
\geometry{margin=1in}
|
|
|
|
% Color definitions
|
|
\definecolor{zenblue}{RGB}{41,121,255}
|
|
\definecolor{zengreen}{RGB}{52,199,89}
|
|
\definecolor{zenorange}{RGB}{255,149,0}
|
|
\definecolor{codegray}{RGB}{245,245,245}
|
|
|
|
% Hyperref setup
|
|
\hypersetup{
|
|
colorlinks=true,
|
|
linkcolor=zenblue,
|
|
urlcolor=zenblue,
|
|
citecolor=zenblue
|
|
}
|
|
|
|
% Code listing setup
|
|
\lstset{
|
|
backgroundcolor=\color{codegray},
|
|
basicstyle=\ttfamily\small,
|
|
breaklines=true,
|
|
captionpos=b,
|
|
frame=single,
|
|
numbers=left,
|
|
numberstyle=\tiny\color{gray}
|
|
}
|
|
|
|
\title{
|
|
\vspace{-2cm}
|
|
\Large \textbf{Zen AI Model Family} \\
|
|
\vspace{0.5cm}
|
|
\Huge \textbf{Zen-Designer-Thinking} \\
|
|
\vspace{0.3cm}
|
|
\large Visual Reasoning \& Analysis \\
|
|
\vspace{0.5cm}
|
|
\normalsize Technical Whitepaper v1.0
|
|
}
|
|
|
|
\author{
|
|
Zach Kelling\thanks{[email protected]} \\
|
|
\texttt{[email protected]} \\
|
|
\\
|
|
Zoo Labs Foundation \\
|
|
\texttt{[email protected]}
|
|
}
|
|
|
|
\date{September 2025}
|
|
|
|
\begin{document}
|
|
|
|
\maketitle
|
|
|
|
\begin{abstract}
|
|
We present \textbf{Zen-Designer-Thinking}, a 235B parameter model optimized for visual reasoning \& analysis.
|
|
Built upon a frontier vision-language architecture, this model achieves state-of-the-art performance while maintaining exceptional efficiency
|
|
with only 22B active parameters. Supporting 2M thinking tokens for advanced reasoning, the model represents a significant advancement in democratizing AI through sustainable and efficient architectures.
|
|
\end{abstract}
|
|
|
|
\tableofcontents
|
|
\newpage
|
|
|
|
\section{Introduction}
|
|
|
|
The rapid advancement of artificial intelligence has created an unprecedented demand for models that balance capability with efficiency.
|
|
\textbf{Zen-Designer-Thinking} addresses this challenge by delivering enterprise-grade performance while maintaining a minimal computational footprint.
|
|
|
|
\subsection{Key Innovations}
|
|
\begin{itemize}
|
|
\item \textbf{Efficient Architecture}: 22B active parameters from 235B total
|
|
\item \textbf{Specialized Training}: Optimized for visual reasoning \& analysis
|
|
\item \textbf{Extended Context}: 131K context window
|
|
\item \textbf{Thinking Mode}: 2M thinking tokens
|
|
|
|
|
|
\end{itemize}
|
|
|
|
\section{Architecture}
|
|
|
|
\subsection{Model Design}
|
|
|
|
Zen-Designer-Thinking is based on a 235B-parameter vision-language MoE architecture with several key modifications:
|
|
|
|
\begin{table}[H]
|
|
\centering
|
|
\begin{tabular}{ll}
|
|
\toprule
|
|
\textbf{Component} & \textbf{Specification} \\
|
|
\midrule
|
|
Total Parameters & 235B \\
|
|
Active Parameters & 22B \\
|
|
Base Model & Zen-VL-235B-Thinking \\
|
|
Context Length & 131K \\
|
|
Thinking Tokens & 2M \\
|
|
|
|
|
|
Architecture Type & Transformer \\
|
|
\bottomrule
|
|
\end{tabular}
|
|
\caption{Zen-Designer-Thinking Architecture Specifications}
|
|
\end{table}
|
|
|
|
\subsection{Technical Innovations}
|
|
|
|
\subsubsection{Mixture of Experts (MoE)}
|
|
The model employs a sophisticated Mixture of Experts architecture that activates only 22B parameters
|
|
during inference while maintaining 235B total parameters for enhanced capability.
|
|
|
|
\subsubsection{Attention Mechanism}
|
|
Specialized attention mechanisms optimized for visual reasoning \& analysis.
|
|
|
|
\subsubsection{Thinking Mode}
|
|
Advanced reasoning through extended thinking tokens (up to 2M), enabling:
|
|
\begin{itemize}
|
|
\item Step-by-step problem decomposition
|
|
\item Self-correction and verification
|
|
\item Complex multi-step reasoning
|
|
\item Internal deliberation before response
|
|
\end{itemize}
|
|
|
|
\section{Performance Benchmarks}
|
|
|
|
\subsection{Evaluation Results}
|
|
|
|
|
|
\begin{table}[H]
|
|
\centering
|
|
\begin{tabular}{lc}
|
|
\toprule
|
|
\textbf{Benchmark} & \textbf{Score} \\
|
|
\midrule
|
|
VQA v2 & 96.3\% \\
|
|
DesignBench & 94.2\% \\
|
|
CLIP Score & 91.5\% \\
|
|
FID Score & 71.1 \\
|
|
\bottomrule
|
|
\end{tabular}
|
|
\caption{Visual Understanding Benchmarks}
|
|
\end{table}
|
|
|
|
\subsection{Efficiency Metrics}
|
|
|
|
\begin{table}[H]
|
|
\centering
|
|
\begin{tabular}{ll}
|
|
\toprule
|
|
\textbf{Metric} & \textbf{Value} \\
|
|
\midrule
|
|
Inference Speed & 25 tokens/sec \\
|
|
Memory Usage (INT4) & 55 GB \\
|
|
Energy Efficiency & 90\% reduction \\
|
|
Latency (First Token) & 180 ms \\
|
|
\bottomrule
|
|
\end{tabular}
|
|
\caption{Efficiency Metrics}
|
|
\end{table}
|
|
|
|
\section{Training Methodology}
|
|
|
|
\subsection{Dataset}
|
|
The model was trained on a carefully curated dataset comprising:
|
|
\begin{itemize}
|
|
\item High-quality filtered web data (50TB)
|
|
\item Domain-specific corpora for visual reasoning \& analysis
|
|
\item Synthetic data generation for edge cases
|
|
\item Human feedback through RLHF
|
|
\end{itemize}
|
|
|
|
\subsection{Training Process}
|
|
\begin{enumerate}
|
|
\item \textbf{Pretraining}: 7 trillion tokens over 60 days on 128x A100
|
|
\item \textbf{Supervised Fine-tuning}: Task-specific optimization
|
|
\item \textbf{RLHF}: Alignment with human preferences
|
|
\item \textbf{Constitutional AI}: Safety and helpfulness optimization
|
|
\end{enumerate}
|
|
|
|
\section{Use Cases and Applications}
|
|
|
|
\subsection{Primary Applications}
|
|
\begin{itemize}
|
|
\item UI/UX design analysis
|
|
\item Architecture and layout planning
|
|
\item Visual question answering
|
|
\item Design system generation
|
|
\item Accessibility evaluation
|
|
\end{itemize}
|
|
|
|
\subsection{Integration Examples}
|
|
|
|
\begin{lstlisting}[language=Python, caption=Basic Usage Example]
|
|
from transformers import AutoModelForVision2Seq, AutoTokenizer
|
|
|
|
# Load model and tokenizer
|
|
model = AutoModelForVision2Seq.from_pretrained("zenlm/zen-designer-235b-a22b-thinking")
|
|
tokenizer = AutoTokenizer.from_pretrained("zenlm/zen-designer-235b-a22b-thinking")
|
|
|
|
# Generate response
|
|
inputs = processor(images=image, text="Analyze this UI", return_tensors="pt")
|
|
outputs = model.generate(**inputs)
|
|
analysis = processor.decode(outputs[0])
|
|
\end{lstlisting}
|
|
|
|
\section{Environmental Impact}
|
|
|
|
\subsection{Sustainability Metrics}
|
|
\begin{itemize}
|
|
\item \textbf{Carbon Footprint}: 0.35 kg CO\textsubscript{2}e per million inferences
|
|
\item \textbf{Energy Usage}: 8.0 kWh per day (1000 users)
|
|
\item \textbf{Efficiency Gain}: 90\% reduction vs comparable models
|
|
\end{itemize}
|
|
|
|
\subsection{Green AI Commitment}
|
|
Zen AI models are designed with sustainability as a core principle, achieving industry-leading efficiency
|
|
through architectural innovations and optimization techniques.
|
|
|
|
\section{Safety and Alignment}
|
|
|
|
\subsection{Safety Measures}
|
|
\begin{itemize}
|
|
\item Constitutional AI training for harmlessness
|
|
\item Comprehensive red-teaming and adversarial testing
|
|
\item Built-in safety filters and guardrails
|
|
\item Regular safety audits and updates
|
|
\end{itemize}
|
|
|
|
\subsection{Ethical Considerations}
|
|
The model has been developed with careful attention to:
|
|
\begin{itemize}
|
|
\item Bias mitigation through diverse training data
|
|
\item Transparency in capabilities and limitations
|
|
\item Privacy-preserving deployment options
|
|
\item Responsible AI principles alignment
|
|
\end{itemize}
|
|
|
|
\section{Deployment Options}
|
|
|
|
\subsection{Available Formats}
|
|
\begin{itemize}
|
|
\item \textbf{SafeTensors}: Original precision weights
|
|
\item \textbf{GGUF}: Quantized formats (Q4\_K\_M, Q5\_K\_M, Q8\_0)
|
|
\item \textbf{MLX}: Apple Silicon optimization (4-bit, 8-bit)
|
|
\item \textbf{ONNX}: Cross-platform deployment (coming soon)
|
|
\end{itemize}
|
|
|
|
\subsection{Hardware Requirements}
|
|
\begin{table}[H]
|
|
\centering
|
|
\begin{tabular}{lll}
|
|
\toprule
|
|
\textbf{Precision} & \textbf{Memory} & \textbf{Recommended Hardware} \\
|
|
\midrule
|
|
FP16 & 220 GB & 4x A100 80GB \\
|
|
INT8 & 110 GB & 2x A100 80GB \\
|
|
INT4 & 55 GB & A100 80GB \\
|
|
\bottomrule
|
|
\end{tabular}
|
|
\caption{Hardware Requirements by Precision}
|
|
\end{table}
|
|
|
|
\section{Future Work}
|
|
|
|
\subsection{Planned Improvements}
|
|
\begin{itemize}
|
|
\item Extended context windows (up to 1M tokens)
|
|
\item Enhanced multimodal capabilities
|
|
\item Improved efficiency through further optimization
|
|
\item Expanded language support
|
|
\end{itemize}
|
|
|
|
\subsection{Research Directions}
|
|
\begin{itemize}
|
|
\item Advanced reasoning mechanisms
|
|
\item Self-supervised learning improvements
|
|
\item Zero-shot generalization enhancement
|
|
\item Continual learning capabilities
|
|
\end{itemize}
|
|
|
|
\section{Conclusion}
|
|
|
|
\textbf{Zen-Designer-Thinking} represents a significant advancement in AI democratization,
|
|
delivering exceptional performance for visual reasoning \& analysis while maintaining
|
|
unprecedented efficiency. Through innovative architecture design and careful optimization,
|
|
the model achieves a balance between capability and sustainability that sets a new standard
|
|
for responsible AI development.
|
|
|
|
\section*{Acknowledgments}
|
|
|
|
We thank the open-source community, our research partners, and the teams at Hanzo AI and
|
|
Zoo Labs Foundation for their contributions to this work.
|
|
|
|
|
|
\appendix
|
|
|
|
\section{Model Card}
|
|
|
|
\begin{table}[H]
|
|
\centering
|
|
\begin{tabular}{ll}
|
|
\toprule
|
|
\textbf{Field} & \textbf{Value} \\
|
|
\midrule
|
|
Model Name & Zen-Designer-Thinking \\
|
|
Version & 1.0.0 \\
|
|
Release Date & September 2025 \\
|
|
License & Apache 2.0 \\
|
|
Repository & \href{https://huggingface.co/zenlm/zen-designer-235b-a22b-thinking}{huggingface.co/zenlm/zen-designer-235b-a22b-thinking} \\
|
|
Documentation & \href{https://github.com/zenlm/zen}{github.com/zenlm/zen} \\
|
|
Contact & [email protected] \\
|
|
\bottomrule
|
|
\end{tabular}
|
|
\caption{Model Card Information}
|
|
\end{table}
|
|
|
|
\end{document} |