PaddleOCR-VL-MLX / complete_version.py
gamhtoi's picture
Upload PaddleOCR-VL-MLX - MLX optimized for Apple Silicon
d48a40f verified
#!/opt/homebrew/bin/python3
"""
PaddleOCR-VL MLX 完整版 - 加载所有权重
目标:达到原版准确度
作者: AI Assistant
日期: 2024-12-25
版本: v7.0 - 完整实现
"""
import mlx.core as mx
import mlx.nn as nn
from PIL import Image, ImageDraw
import numpy as np
import json
from pathlib import Path
from typing import Optional, List, Tuple
import time
# 导入基础组件
from mlx_components import (
RMSNorm, MLP, DecoderLayer
)
class VisionHeadAttention(nn.Module):
"""Vision Head 的注意力层 - 使用合并的 in_proj"""
def __init__(self, hidden_size: int = 1152):
super().__init__()
self.hidden_size = hidden_size
self.num_heads = 16
self.head_dim = hidden_size // self.num_heads # 72
# 合并的 Q,K,V 投影
self.in_proj = nn.Linear(hidden_size, 3 * hidden_size, bias=True)
self.out_proj = nn.Linear(hidden_size, hidden_size, bias=True)
def __call__(self, x: mx.array) -> mx.array:
B, L, D = x.shape
# 投影到 Q, K, V
qkv = self.in_proj(x) # [B, L, 3*D]
qkv = qkv.reshape(B, L, 3, self.num_heads, self.head_dim)
qkv = mx.transpose(qkv, (2, 0, 3, 1, 4)) # [3, B, H, L, D]
q, k, v = qkv[0], qkv[1], qkv[2]
# 注意力
attn = mx.matmul(q, mx.transpose(k, (0, 1, 3, 2))) / (self.head_dim ** 0.5)
attn = mx.softmax(attn, axis=-1)
out = mx.matmul(attn, v)
# 重塑和输出投影
out = mx.transpose(out, (0, 2, 1, 3))
out = out.reshape(B, L, D)
out = self.out_proj(out)
return out
class VisionHead(nn.Module):
"""Vision Head 层"""
def __init__(self, hidden_size: int = 1152):
super().__init__()
self.attention = VisionHeadAttention(hidden_size)
self.layernorm = nn.LayerNorm(hidden_size)
self.mlp = MLP(hidden_size, 4304)
self.probe = mx.zeros((1, 1, hidden_size))
def __call__(self, x: mx.array) -> mx.array:
# Attention with residual
residual = x
x = self.attention(x)
x = residual + x
# LayerNorm
x = self.layernorm(x)
# MLP with residual
residual = x
x = self.mlp(x)
x = residual + x
return x
class CompletePaddleOCRMLX:
"""完整的 PaddleOCR MLX - 加载所有权重"""
def __init__(self, model_dir: str):
self.model_dir = Path(model_dir)
print("🚀 初始化完整版 PaddleOCR MLX...")
print(f"📂 模型目录: {model_dir}")
# 加载配置
self.config = self._load_config()
# 加载 tokenizer
self.tokenizer = self._load_tokenizer()
# 创建模型
self.model = self._create_model()
# 加载所有权重
self._load_all_weights()
print("✅ 初始化完成!")
def _load_config(self) -> dict:
"""加载模型配置"""
config_path = self.model_dir / "config.json"
with open(config_path, 'r') as f:
config = json.load(f)
print(f"✅ 配置加载完成")
return config
def _load_tokenizer(self):
"""加载 tokenizer"""
try:
from transformers import AutoTokenizer
original_model_path = "/Users/gt/.lmstudio/hub/models/paddleocr-vl"
tokenizer = AutoTokenizer.from_pretrained(
original_model_path,
trust_remote_code=True
)
print(f"✅ Tokenizer 加载完成 (词汇表: {len(tokenizer)})")
return tokenizer
except Exception as e:
print(f"⚠️ Tokenizer 加载失败: {e}")
return None
def _create_model(self):
"""创建完整模型"""
print("🔄 创建完整模型...")
class CompleteModel(nn.Module):
"""完整的模型 - 包含所有层"""
def __init__(self, config):
super().__init__()
self.config = config
# 语言模型配置
self.hidden_size = config.get('hidden_size', 1024)
self.vocab_size = config.get('vocab_size', 103424)
self.intermediate_size = config.get('intermediate_size', 3072)
self.num_attention_heads = config.get('num_attention_heads', 16)
self.num_kv_heads = config.get('num_key_value_heads', 2)
self.num_hidden_layers = config.get('num_hidden_layers', 18)
self.head_dim = config.get('head_dim', 128)
# 视觉编码器配置
vision_config = config.get('vision_config', {})
self.vision_hidden_size = vision_config.get('hidden_size', 1152)
self.vision_num_layers = 27
# Patch embedding
self.patch_embedding = nn.Conv2d(
in_channels=3,
out_channels=self.vision_hidden_size,
kernel_size=14,
stride=14,
bias=True
)
# 位置嵌入
self.position_embedding = mx.zeros((729, self.vision_hidden_size))
# 视觉 Transformer 层
self.vision_layers = [
DecoderLayer(
hidden_size=self.vision_hidden_size,
num_heads=16,
intermediate_size=4304,
num_kv_heads=16,
head_dim=72,
)
for _ in range(self.vision_num_layers)
]
# 视觉编码器的归一化
self.vision_norm = RMSNorm(self.vision_hidden_size)
# Vision Head ⭐ 新增
self.vision_head = VisionHead(self.vision_hidden_size)
# Post LayerNorm ⭐ 新增
self.post_layernorm = nn.LayerNorm(self.vision_hidden_size)
# 视觉投影层 (mlp_AR)
self.vision_pre_norm = nn.LayerNorm(self.vision_hidden_size)
self.vision_linear_1 = nn.Linear(4608, 4608, bias=True)
self.vision_linear_2 = nn.Linear(4608, self.hidden_size, bias=True)
# Token 嵌入
self.embed_tokens = nn.Embedding(self.vocab_size, self.hidden_size)
# 语言模型 Decoder 层
self.layers = [
DecoderLayer(
hidden_size=self.hidden_size,
num_heads=self.num_attention_heads,
intermediate_size=self.intermediate_size,
num_kv_heads=self.num_kv_heads,
head_dim=self.head_dim,
)
for _ in range(self.num_hidden_layers)
]
# 最终归一化
self.norm = RMSNorm(self.hidden_size, eps=config.get('rms_norm_eps', 1e-6))
# LM head
self.lm_head = nn.Linear(self.hidden_size, self.vocab_size, bias=False)
def encode_image(self, pixel_values: mx.array) -> mx.array:
"""编码图像 - 完整流程"""
B, H, W, C = pixel_values.shape
# 1. Patch embedding
x = self.patch_embedding(pixel_values) # [B, 16, 16, 1152]
x = x.reshape(B, -1, self.vision_hidden_size) # [B, 256, 1152]
# 2. 位置嵌入
x = x + self.position_embedding[:256, :]
# 3. 视觉 Transformer 层
for layer in self.vision_layers:
x = layer(x, None)
# 4. 视觉归一化
x = self.vision_norm(x)
# 5. Vision Head ⭐ 新增
x = self.vision_head(x)
# 6. Post LayerNorm ⭐ 新增
x = self.post_layernorm(x)
# 7. 视觉投影层 (mlp_AR)
x = self.vision_pre_norm(x) # [B, 256, 1152]
# 8. Spatial merge
grid_size = 16
merge_size = 2
merged_grid_size = 8
x = x.reshape(B, grid_size, grid_size, self.vision_hidden_size)
x = x.reshape(B, merged_grid_size, merge_size, merged_grid_size, merge_size, self.vision_hidden_size)
x = mx.transpose(x, (0, 1, 3, 2, 4, 5))
x = x.reshape(B, 64, 4608)
# 9. Linear layers
x = self.vision_linear_1(x)
x = nn.gelu(x)
x = self.vision_linear_2(x)
return x
def forward(self, input_ids: mx.array, vision_embeds: Optional[mx.array] = None) -> mx.array:
"""前向传播"""
text_embeds = self.embed_tokens(input_ids)
if vision_embeds is not None:
# 添加 vision tokens
vision_start_id = mx.array([[101305]])
vision_start_embed = self.embed_tokens(vision_start_id)
vision_end_id = mx.array([[101306]])
vision_end_embed = self.embed_tokens(vision_end_id)
hidden_states = mx.concatenate([
vision_start_embed,
vision_embeds,
vision_end_embed,
text_embeds
], axis=1)
else:
hidden_states = text_embeds
for layer in self.layers:
hidden_states = layer(hidden_states, None)
hidden_states = self.norm(hidden_states)
logits = self.lm_head(hidden_states)
return logits
model = CompleteModel(self.config)
print("✅ 完整模型创建完成")
return model
def _load_all_weights(self):
"""加载所有权重"""
print("\n" + "="*60)
print("🔄 加载所有权重...")
print("="*60)
weights_path = self.model_dir / "paddleocr_vl_mlx.npz"
weights = mx.load(str(weights_path))
print(f"\n📂 加载了 {len(weights)} 个权重张量")
loaded_count = 0
try:
# 1. 视觉编码器权重 (与之前相同)
print(f"\n📸 加载视觉编码器权重...")
# Patch embedding
if 'visual.vision_model.embeddings.patch_embedding.weight' in weights:
w = weights['visual.vision_model.embeddings.patch_embedding.weight']
w_transposed = mx.transpose(w, (0, 2, 3, 1))
self.model.patch_embedding.weight = w_transposed
loaded_count += 1
if 'visual.vision_model.embeddings.patch_embedding.bias' in weights:
self.model.patch_embedding.bias = weights['visual.vision_model.embeddings.patch_embedding.bias']
loaded_count += 1
# 位置嵌入
if 'visual.vision_model.embeddings.position_embedding.weight' in weights:
self.model.position_embedding = weights['visual.vision_model.embeddings.position_embedding.weight']
loaded_count += 1
# 视觉 Transformer 层
for i in range(27):
layer = self.model.vision_layers[i]
prefix = f'visual.vision_model.encoder.layers.{i}'
for proj_name in ['q_proj', 'k_proj', 'v_proj']:
w_key = f'{prefix}.self_attn.{proj_name}.weight'
b_key = f'{prefix}.self_attn.{proj_name}.bias'
if w_key in weights:
proj = getattr(layer.self_attn, proj_name)
proj.weight = weights[w_key]
if b_key in weights:
proj.bias = weights[b_key]
loaded_count += 1
w_key = f'{prefix}.self_attn.out_proj.weight'
b_key = f'{prefix}.self_attn.out_proj.bias'
if w_key in weights:
layer.self_attn.o_proj.weight = weights[w_key]
if b_key in weights:
layer.self_attn.o_proj.bias = weights[b_key]
loaded_count += 1
if f'{prefix}.mlp.fc1.weight' in weights:
layer.mlp.gate_proj.weight = weights[f'{prefix}.mlp.fc1.weight']
loaded_count += 1
if f'{prefix}.mlp.fc2.weight' in weights:
layer.mlp.down_proj.weight = weights[f'{prefix}.mlp.fc2.weight']
loaded_count += 1
for norm_name, model_norm in [('layer_norm1', 'input_layernorm'), ('layer_norm2', 'post_attention_layernorm')]:
if f'{prefix}.{norm_name}.weight' in weights:
getattr(layer, model_norm).weight = weights[f'{prefix}.{norm_name}.weight']
loaded_count += 1
print(f"✅ 视觉编码器权重加载完成 (27 层)")
# 2. Vision Head ⭐ 新增
print(f"\n🎯 加载 Vision Head 权重...")
# Attention
if 'visual.vision_model.head.attention.in_proj_weight' in weights:
self.model.vision_head.attention.in_proj.weight = weights['visual.vision_model.head.attention.in_proj_weight']
loaded_count += 1
if 'visual.vision_model.head.attention.in_proj_bias' in weights:
self.model.vision_head.attention.in_proj.bias = weights['visual.vision_model.head.attention.in_proj_bias']
loaded_count += 1
if 'visual.vision_model.head.attention.out_proj.weight' in weights:
self.model.vision_head.attention.out_proj.weight = weights['visual.vision_model.head.attention.out_proj.weight']
loaded_count += 1
if 'visual.vision_model.head.attention.out_proj.bias' in weights:
self.model.vision_head.attention.out_proj.bias = weights['visual.vision_model.head.attention.out_proj.bias']
loaded_count += 1
# LayerNorm
if 'visual.vision_model.head.layernorm.weight' in weights:
self.model.vision_head.layernorm.weight = weights['visual.vision_model.head.layernorm.weight']
loaded_count += 1
if 'visual.vision_model.head.layernorm.bias' in weights:
self.model.vision_head.layernorm.bias = weights['visual.vision_model.head.layernorm.bias']
loaded_count += 1
# MLP
if 'visual.vision_model.head.mlp.fc1.weight' in weights:
self.model.vision_head.mlp.gate_proj.weight = weights['visual.vision_model.head.mlp.fc1.weight']
loaded_count += 1
if 'visual.vision_model.head.mlp.fc1.bias' in weights:
self.model.vision_head.mlp.gate_proj.bias = weights['visual.vision_model.head.mlp.fc1.bias']
loaded_count += 1
if 'visual.vision_model.head.mlp.fc2.weight' in weights:
self.model.vision_head.mlp.down_proj.weight = weights['visual.vision_model.head.mlp.fc2.weight']
loaded_count += 1
if 'visual.vision_model.head.mlp.fc2.bias' in weights:
self.model.vision_head.mlp.down_proj.bias = weights['visual.vision_model.head.mlp.fc2.bias']
loaded_count += 1
# Probe
if 'visual.vision_model.head.probe' in weights:
self.model.vision_head.probe = weights['visual.vision_model.head.probe']
loaded_count += 1
print(f"✅ Vision Head 权重加载完成 (11 个)")
# 3. Post LayerNorm ⭐ 新增
print(f"\n🎯 加载 Post LayerNorm 权重...")
if 'visual.vision_model.post_layernorm.weight' in weights:
self.model.post_layernorm.weight = weights['visual.vision_model.post_layernorm.weight']
loaded_count += 1
if 'visual.vision_model.post_layernorm.bias' in weights:
self.model.post_layernorm.bias = weights['visual.vision_model.post_layernorm.bias']
loaded_count += 1
print(f"✅ Post LayerNorm 权重加载完成 (2 个)")
# 4. mlp_AR (与之前相同)
print(f"\n🔗 加载视觉投影层 (mlp_AR)...")
mlp_ar_loaded = 0
if 'mlp_AR.pre_norm.weight' in weights:
self.model.vision_pre_norm.weight = weights['mlp_AR.pre_norm.weight']
mlp_ar_loaded += 1
if 'mlp_AR.pre_norm.bias' in weights:
self.model.vision_pre_norm.bias = weights['mlp_AR.pre_norm.bias']
mlp_ar_loaded += 1
if 'mlp_AR.linear_1.weight' in weights:
self.model.vision_linear_1.weight = weights['mlp_AR.linear_1.weight']
mlp_ar_loaded += 1
if 'mlp_AR.linear_1.bias' in weights:
self.model.vision_linear_1.bias = weights['mlp_AR.linear_1.bias']
mlp_ar_loaded += 1
if 'mlp_AR.linear_2.weight' in weights:
self.model.vision_linear_2.weight = weights['mlp_AR.linear_2.weight']
mlp_ar_loaded += 1
if 'mlp_AR.linear_2.bias' in weights:
self.model.vision_linear_2.bias = weights['mlp_AR.linear_2.bias']
mlp_ar_loaded += 1
print(f"✅ 视觉投影层加载完成 ({mlp_ar_loaded}/6 个)")
loaded_count += mlp_ar_loaded
# 5. 语言模型权重 (与之前相同)
print(f"\n📝 加载语言模型权重...")
if 'model.embed_tokens.weight' in weights:
self.model.embed_tokens.weight = weights['model.embed_tokens.weight']
loaded_count += 1
for i in range(18):
layer = self.model.layers[i]
prefix = f'model.layers.{i}'
for proj in ['q_proj', 'k_proj', 'v_proj', 'o_proj']:
if f'{prefix}.self_attn.{proj}.weight' in weights:
getattr(layer.self_attn, proj).weight = weights[f'{prefix}.self_attn.{proj}.weight']
loaded_count += 1
for proj in ['gate_proj', 'up_proj', 'down_proj']:
if f'{prefix}.mlp.{proj}.weight' in weights:
getattr(layer.mlp, proj).weight = weights[f'{prefix}.mlp.{proj}.weight']
loaded_count += 1
for norm in ['input_layernorm', 'post_attention_layernorm']:
if f'{prefix}.{norm}.weight' in weights:
getattr(layer, norm).weight = weights[f'{prefix}.{norm}.weight']
loaded_count += 1
if 'model.norm.weight' in weights:
self.model.norm.weight = weights['model.norm.weight']
loaded_count += 1
if 'lm_head.weight' in weights:
self.model.lm_head.weight = weights['lm_head.weight']
loaded_count += 1
print(f"✅ 语言模型权重加载完成")
print(f"\n✅ 总共成功加载 {loaded_count} 个权重")
except Exception as e:
print(f"\n❌ 权重加载失败: {e}")
import traceback
traceback.print_exc()
print("\n" + "="*60)
print(f"📊 权重加载完成: {loaded_count}/620")
print("="*60)
def preprocess_image(self, image_path: str) -> Tuple[mx.array, tuple]:
"""预处理图像"""
image = Image.open(image_path).convert('RGB')
original_size = image.size
target_size = (224, 224)
image = image.resize(target_size, Image.Resampling.BILINEAR)
image_array = np.array(image).astype(np.float32) / 255.0
mean = np.array([0.485, 0.456, 0.406])
std = np.array([0.229, 0.224, 0.225])
image_array = (image_array - mean) / std
image_array = np.expand_dims(image_array, 0)
return mx.array(image_array), original_size
def encode_prompt(self, prompt: str) -> mx.array:
"""编码提示文本"""
if self.tokenizer:
tokens = self.tokenizer.encode(prompt, add_special_tokens=True)
return mx.array([tokens])
else:
return mx.array([[1, 2, 3, 4, 5]])
def decode_tokens(self, token_ids: List[int]) -> str:
"""解码 token IDs 为文本"""
if self.tokenizer:
text = self.tokenizer.decode(token_ids, skip_special_tokens=True)
return text
else:
return f"[Token IDs: {token_ids[:10]}...]"
def generate(
self,
pixel_values: mx.array,
prompt: str = "Extract all text from this image.",
max_tokens: int = 100,
temperature: float = 0.0,
repetition_penalty: float = 2.0,
) -> str:
"""生成文本"""
print(f"\n🔮 开始生成...")
# 编码图像
start = time.time()
vision_embeds = self.model.encode_image(pixel_values)
print(f"✅ 图像编码: {vision_embeds.shape} ({time.time()-start:.2f}s)")
# 编码提示
start = time.time()
prompt_ids = self.encode_prompt(prompt)
print(f"✅ 提示编码: {prompt_ids.shape} ({time.time()-start:.2f}s)")
# 自回归生成
print(f"\n🔄 自回归生成 (max_tokens={max_tokens}, repetition_penalty={repetition_penalty})...")
start = time.time()
output_ids = []
current_ids = prompt_ids
eos_token_id = self.tokenizer.eos_token_id if self.tokenizer else 2
for i in range(max_tokens):
logits = self.model.forward(current_ids, vision_embeds)
next_token_logits = logits[:, -1, :]
# 应用 repetition penalty
if repetition_penalty != 1.0 and len(output_ids) > 0:
next_token_logits = mx.array(next_token_logits)
for token_id in set(output_ids):
next_token_logits[0, token_id] = next_token_logits[0, token_id] / repetition_penalty
if temperature == 0:
next_token = mx.argmax(next_token_logits, axis=-1)
else:
next_token_logits = next_token_logits / temperature
probs = mx.softmax(next_token_logits, axis=-1)
next_token = mx.random.categorical(probs)
next_token_id = int(next_token[0])
if next_token_id == eos_token_id:
print(f" 遇到 EOS token,停止生成")
break
output_ids.append(next_token_id)
current_ids = mx.concatenate([current_ids, mx.array([[next_token_id]])], axis=1)
if (i + 1) % 20 == 0:
print(f" 生成了 {i + 1} tokens...")
elapsed = time.time() - start
print(f"✅ 生成完成: {len(output_ids)} tokens ({elapsed:.2f}s, {len(output_ids)/elapsed:.1f} tokens/s)")
# 解码
result_text = self.decode_tokens(output_ids)
return result_text
def ocr(
self,
image_path: str,
prompt: str = "Extract all text from this image.",
max_tokens: int = 100,
repetition_penalty: float = 2.0,
) -> dict:
"""端到端 OCR"""
print("\n" + "="*60)
print("🚀 执行完整版 OCR")
print("="*60)
total_start = time.time()
# 预处理
pixel_values, original_size = self.preprocess_image(image_path)
print(f"📸 图像: {original_size} -> {pixel_values.shape}")
# 生成
result_text = self.generate(pixel_values, prompt, max_tokens, repetition_penalty=repetition_penalty)
total_time = time.time() - total_start
print(f"\n✅ OCR 完成 (总耗时: {total_time:.2f}s)")
print("="*60)
return {
'text': result_text,
'image_size': original_size,
'elapsed_time': total_time,
'status': 'success'
}
def main():
"""主函数"""
print("\n" + "="*60)
print("🎯 PaddleOCR MLX 完整版测试")
print("="*60)
print(f"目标: 达到原版准确度")
print(f"改进: 加载所有权重 + Vision Head")
print("="*60)
model_dir = "/Users/gt/.gemini/antigravity/scratch/paddleocr-mlx-conversion"
try:
# 初始化
ocr = CompletePaddleOCRMLX(model_dir)
# 创建测试图像
print("\n📋 创建测试图像...")
img = Image.new('RGB', (400, 200), color='white')
draw = ImageDraw.Draw(img)
draw.text((50, 80), "Hello MLX!", fill='black')
test_path = "/tmp/test_complete_mlx.png"
img.save(test_path)
print(f"✅ 测试图像: {test_path}")
# 运行 OCR
result = ocr.ocr(test_path, max_tokens=50, repetition_penalty=2.0)
# 显示结果
print(f"\n📝 OCR 结果:")
print(f"{'='*60}")
print(result['text'])
print(f"{'='*60}")
print(f"图像大小: {result['image_size']}")
print(f"耗时: {result['elapsed_time']:.2f}s")
print(f"\n🎉 完整版测试完成!")
except Exception as e:
print(f"\n❌ 错误: {e}")
import traceback
traceback.print_exc()
if __name__ == "__main__":
main()