#!/usr/bin/env python3 """ app.py — BeRestoral """ import html import json import math import re from pathlib import Path from typing import Any, Dict, Optional import numpy as np import torch import torch.nn as nn import uvicorn from fastapi import FastAPI, Request from fastapi.staticfiles import StaticFiles from fastapi.templating import Jinja2Templates from pydantic import BaseModel from transformers import AutoModelForMaskedLM, AutoTokenizer app = FastAPI(title="BeRestoral") app.mount("/static", StaticFiles(directory="static"), name="static") templates = Jinja2Templates(directory="templates") device = torch.device("cpu") MODEL_PATH_BPE = "MaximEremeev/RoFormer-slav" MODEL_PATH_CHAR = "MaximEremeev/DualEmb-slav" PROBE_DIR = Path("probes") BIN_START = 1050 BIN_SIZE = 50 N_BINS = 9 BINS = [(BIN_START + i * BIN_SIZE, BIN_START + (i + 1) * BIN_SIZE - 1) for i in range(N_BINS)] BIN_MIDPOINTS = np.array([(lo + hi) / 2 for lo, hi in BINS]) BIN_LABELS = [f"{lo}–{hi}" for lo, hi in BINS] CATEGORY_LABELS = ["letters", "records", "religious", "other"] CATEGORY_LABELS_RU = ["письма", "деловые записи", "религиозные тексты", "другое"] print("Loading BPE model (RoFormer)...") tokenizer_bpe = AutoTokenizer.from_pretrained(MODEL_PATH_BPE, trust_remote_code=True) tokenizer_bpe.add_special_tokens({"additional_special_tokens": ["[GAP]"]}) model_bpe = AutoModelForMaskedLM.from_pretrained(MODEL_PATH_BPE, trust_remote_code=True).to(device) model_bpe.eval() print("Loading char model (DualEmbLM)...") from huggingface_hub import hf_hub_download model_char = AutoModelForMaskedLM.from_pretrained( MODEL_PATH_CHAR, trust_remote_code=True).to(device) model_char.eval() _char_vocab_path = hf_hub_download(repo_id=MODEL_PATH_CHAR, filename="char_vocab.json") _word_vocab_path = hf_hub_download(repo_id=MODEL_PATH_CHAR, filename="word_vocab.json") char_vocab = json.loads(Path(_char_vocab_path).read_text(encoding="utf-8")) word_vocab = json.loads(Path(_word_vocab_path).read_text(encoding="utf-8")) id_to_char = {v: k for k, v in char_vocab.items()} EMBED_DIM = 512 class LinearProbe(nn.Module): def __init__(self, in_dim: int, out_dim: int, dropout: float = 0.1): super().__init__() self.net = nn.Sequential( nn.LayerNorm(in_dim), nn.Dropout(dropout), nn.Linear(in_dim, out_dim), ) def forward(self, x): return self.net(x) print("Loading probe classifiers...") probe_category = LinearProbe(EMBED_DIM, len(CATEGORY_LABELS)) probe_date = LinearProbe(EMBED_DIM, N_BINS) probe_category.load_state_dict(torch.load( PROBE_DIR / "RoFormer_category_masked_probe.pth", map_location=device, weights_only=True)) probe_date.load_state_dict(torch.load( PROBE_DIR / "RoFormer_date_masked_probe.pth", map_location=device, weights_only=True)) probe_category.eval() probe_date.eval() print("All models loaded.") SPECIAL_RE = re.compile(r"(\[GAP\]|\[MASK\]|\[PAD\]|\[UNK\]|\[CLS\]|\[SEP\]|[+:·])") def split_special(text: str) -> list[str]: return [p for p in SPECIAL_RE.split(text) if p] def align_char_to_word(text: str, char_v: dict, word_v: dict, max_len: int = 256): c_unk = char_v["[UNK]"]; c_sep = char_v["[SEP]"]; c_cls = char_v["[CLS]"] w_unk = word_v.get("[UNK_WORD]", 0) input_ids, word_ids = [c_cls], [word_v.get("[CLS]", w_unk)] for part in split_special(text.strip()): if SPECIAL_RE.fullmatch(part): input_ids.append(char_v.get(part, c_unk)) word_ids.append(word_v.get(part, w_unk)) continue for chunk in re.split(r"(\s+)", part): if not chunk: continue if chunk.isspace(): for ch in chunk: input_ids.append(char_v.get(ch, c_unk)); word_ids.append(w_unk) else: wid = word_v.get(chunk, w_unk) for ch in chunk: input_ids.append(char_v.get(ch, c_unk)); word_ids.append(wid) input_ids.append(c_sep); word_ids.append(word_v.get("[SEP]", w_unk)) if len(input_ids) > max_len: input_ids, word_ids = input_ids[:max_len], word_ids[:max_len] input_ids[-1] = c_sep; word_ids[-1] = word_v.get("[SEP]", w_unk) max_char_id = model_char.config.vocab_char_size - 1 max_word_id = model_char.config.vocab_word_size - 1 return { "input_ids": [x if x <= max_char_id else c_unk for x in input_ids], "word_ids": [x if x <= max_word_id else w_unk for x in word_ids], } def get_roformer_embedding(text: str) -> torch.Tensor: """Mean pooling over non-padding tokens from RoFormer encoder. text should already contain BPE mask tokens where lacunae are.""" clean = re.sub(r"\s+", " ", text).strip() enc = tokenizer_bpe(clean, return_tensors="pt", truncation=True, max_length=512, return_attention_mask=True) enc = {k: v.to(device) for k, v in enc.items()} with torch.no_grad(): out = model_bpe(**enc, output_hidden_states=True) hidden = out.hidden_states[-1] mask = enc["attention_mask"].unsqueeze(-1).float() emb = (hidden * mask).sum(dim=1) / mask.sum(dim=1) return emb.squeeze(0) def classify(text: str) -> dict: emb = get_roformer_embedding(text).unsqueeze(0) with torch.no_grad(): cat_logits = probe_category(emb)[0] date_logits = probe_date(emb)[0] cat_probs = torch.softmax(cat_logits, dim=-1).cpu().numpy().tolist() date_probs = torch.softmax(date_logits, dim=-1).cpu().numpy().tolist() best_cat = int(np.argmax(cat_probs)) pred_year = float(np.dot(date_probs, BIN_MIDPOINTS)) return { "category": CATEGORY_LABELS[best_cat], "category_ru": CATEGORY_LABELS_RU[best_cat], "category_probs": {CATEGORY_LABELS[i]: round(p, 4) for i, p in enumerate(cat_probs)}, "pred_year": round(pred_year), "date_probs": [round(p, 4) for p in date_probs], "bin_labels": BIN_LABELS, } def generate_sequential(text: str, is_char: bool, top_k: int = 5, temperature: float = 1.0) -> dict: if is_char: encoded = align_char_to_word(text, char_vocab, word_vocab) input_ids = torch.tensor(encoded["input_ids"]).to(device) word_ids = torch.tensor(encoded["word_ids"]).to(device) mask_token_id = char_vocab["[MASK]"] mask_str = "[MASK]" model = model_char else: inputs = tokenizer_bpe(text, return_tensors="pt").to(device) input_ids = inputs["input_ids"][0] word_ids = None mask_token_id = tokenizer_bpe.mask_token_id mask_str = tokenizer_bpe.mask_token model = model_bpe original_mask_indices = torch.where(input_ids == mask_token_id)[0].tolist() if not original_mask_indices: return {"variants": [], "steps": []} current_states = [{"input_ids": input_ids.clone(), "log_prob": 0.0, "inserted_tokens": {}}] unfilled_masks = original_mask_indices.copy() steps = [] # For char_pos: track how many masks have been filled so far # to compute offset correctly masks_filled_count = 0 mask_str_len = len(mask_str) with torch.no_grad(): while unfilled_masks: probe_ids = current_states[0]["input_ids"].unsqueeze(0).to(device) if is_char: outputs = model(input_ids=probe_ids, word_ids=word_ids.unsqueeze(0)) else: outputs = model(input_ids=probe_ids) logits = outputs.logits[0] best_mask_idx, highest_prob = None, -1.0 for m_idx in unfilled_masks: probs = torch.softmax(logits[m_idx] / max(0.01, temperature), dim=-1) p = torch.max(probs).item() if p > highest_prob: highest_prob, best_mask_idx = p, m_idx unfilled_masks.remove(best_mask_idx) steps.append({"pos": best_mask_idx, "confidence": round(highest_prob * 100, 1)}) batch_ids = torch.stack([s["input_ids"] for s in current_states]).to(device) if is_char: batch_wids = word_ids.unsqueeze(0).expand(len(current_states), -1).to(device) outputs = model(input_ids=batch_ids, word_ids=batch_wids) else: outputs = model(input_ids=batch_ids) mask_logits = outputs.logits[:, best_mask_idx, :] probs_k = torch.softmax(mask_logits / max(0.01, temperature), dim=-1) top_probs, top_ids = torch.topk(probs_k, top_k, dim=-1) new_candidates = [] for si, state in enumerate(current_states): for i in range(top_k): tid = top_ids[si, i].item() prob = top_probs[si, i].item() new_ids = state["input_ids"].clone() new_ids[best_mask_idx] = tid new_tok = dict(state["inserted_tokens"]) new_tok[best_mask_idx] = tid new_candidates.append({ "input_ids": new_ids, "log_prob": state["log_prob"] + math.log(max(prob, 1e-9)), "inserted_tokens": new_tok, }) current_states = sorted(new_candidates, key=lambda x: x["log_prob"], reverse=True)[:top_k] _best_id = current_states[0]["inserted_tokens"].get(best_mask_idx) if is_char: _pred = id_to_char.get(_best_id, "") else: _pred = tokenizer_bpe.decode( [_best_id], clean_up_tokenization_spaces=False ).replace("Ġ", "").replace("##", "").strip() if _best_id else "" # Build partial sentence using direct token index addressing best_state = current_states[0] if is_char: # input_ids: [CLS, tok1, tok2, ..., SEP] — skip CLS(0) and SEP(-1) current_tokens = [id_to_char.get(tid.item(), "") for tid in input_ids[1:-1]] # Fill in predictions for op in original_mask_indices: fid = best_state["inserted_tokens"].get(op) idx_in_tokens = op - 1 # offset for [CLS] if fid is not None and 0 <= idx_in_tokens < len(current_tokens): current_tokens[idx_in_tokens] = id_to_char.get(fid, "") # Build marked string target_idx = best_mask_idx - 1 parts = [] for i, tok in enumerate(current_tokens): if tok in ("[MASK]", "[GAP]", "[PAD]", "[UNK]", "[CLS]", "[SEP]"): parts.append("[MASK]" if tok == "[MASK]" else tok) elif i == target_idx: parts.append(f"[[R]]{tok}[[/R]]") else: parts.append(tok) _partial_marked = "".join(parts) else: # BPE: input_ids includes special tokens, decode each current_tokens = [tokenizer_bpe.decode([tid.item()], clean_up_tokenization_spaces=False) for tid in input_ids] for op in original_mask_indices: fid = best_state["inserted_tokens"].get(op) if fid is not None and 0 <= op < len(current_tokens): current_tokens[op] = tokenizer_bpe.decode( [fid], clean_up_tokenization_spaces=False) target_idx = best_mask_idx parts = [] for i, tok in enumerate(current_tokens): clean = tok.replace("Ġ", " ").replace("##", "") if tok == tokenizer_bpe.mask_token: parts.append("[MASK]") elif i == target_idx: parts.append(f"[[R]]{clean}[[/R]]") elif tok in (tokenizer_bpe.cls_token, tokenizer_bpe.sep_token, tokenizer_bpe.pad_token): pass # skip special tokens else: parts.append(clean) _partial_marked = re.sub(r" +", " ", "".join(parts)).strip() steps[-1]["token"] = _pred steps[-1]["partial_sentence"] = _partial_marked variants = [] escaped_mask = html.escape(mask_str) for state in current_states: ordered_ids = [state["inserted_tokens"][i] for i in original_mask_indices] full_sentence = html.escape(text) if is_char: inserted = "".join(id_to_char.get(t, "") for t in ordered_ids).strip() for tid in ordered_ids: ch = id_to_char.get(tid, "") tok = " " if ch == " " else html.escape(ch) full_sentence = full_sentence.replace( escaped_mask, f'{tok}', 1) else: inserted = tokenizer_bpe.decode(ordered_ids, clean_up_tokenization_spaces=True).strip() for tid in ordered_ids: tok = html.escape(tokenizer_bpe.decode([tid]) .replace("Ġ","").replace("##","").replace(" ","")) full_sentence = full_sentence.replace( escaped_mask, f'{tok}', 1) full_sentence = re.sub(r"\s+", " ", full_sentence.strip()) variants.append({ "word": inserted or "...", "score": round(math.exp(state["log_prob"]) * 100, 2), "full_sentence": full_sentence, "raw_log_prob": state["log_prob"], }) return {"variants": variants, "steps": steps} class RestoreRequest(BaseModel): text: str mode: str = "char" top_k: int = 5 temperature: float = 1.0 @app.get("/") async def read_root(request: Request): return templates.TemplateResponse(request=request, name="index.html") @app.post("/api/restore") async def restore_text(req: RestoreRequest) -> Dict[str, Any]: try: is_char = req.mode == "char" mask = "[MASK]" if is_char else tokenizer_bpe.mask_token text = req.text.replace("#", "[GAP]") # Lowering everything except special tokens parts = SPECIAL_RE.split(text) text = "".join(p if SPECIAL_RE.fullmatch(p) else p.lower() for p in parts if p) n_gaps = text.count("-") + text.count("[GAP]") # Classification — always use BPE mask regardless of mode bpe_mask = tokenizer_bpe.mask_token masked_for_classify = re.sub(r"-", bpe_mask, text) masked_for_classify = re.sub(r" +", " ", masked_for_classify).strip() classification = classify(masked_for_classify) # Restoration query = re.sub(r" +", " ", text.replace("-", mask)).strip() _res = generate_sequential(query, is_char, req.top_k, req.temperature) return { "status": "success", "results": [_res["variants"]], "steps": [_res["steps"]], "n_gaps": n_gaps, "classification": classification, } except Exception as e: import traceback return {"status": "error", "message": str(e), "traceback": traceback.format_exc()} if __name__ == "__main__": import os port = int(os.environ.get("PORT", 7860)) uvicorn.run(app, host="0.0.0.0", port=port)