Text Generation
Transformers
PyTorch
English
burt-imma
custom-architecture
matrix-memory
equilibrium-propagation
cifg
sovereign
snapkitty
no-backprop
formal-verification
lean4
agents
python
Instructions to use Snapkitty/burt-imma with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Snapkitty/burt-imma with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="Snapkitty/burt-imma")# pip install -U transformers accelerate # Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("Snapkitty/burt-imma", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use Snapkitty/burt-imma with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Snapkitty/burt-imma" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Snapkitty/burt-imma", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/Snapkitty/burt-imma
- SGLang
How to use Snapkitty/burt-imma with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "Snapkitty/burt-imma" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Snapkitty/burt-imma", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "Snapkitty/burt-imma" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Snapkitty/burt-imma", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use Snapkitty/burt-imma with Docker Model Runner:
docker model run hf.co/Snapkitty/burt-imma
Download lean4/MMEP_Convergence.lean from Snapkitty/burt-imma: direct link, hf CLI and curl.
- Browser
- Download file 10.6 kB
-
https://huggingface.co/Snapkitty/burt-imma/resolve/main/lean4/MMEP_Convergence.lean
- Command line
-
hf download hf://Snapkitty/burt-imma/lean4/MMEP_Convergence.lean
-
curl -L -o MMEP_Convergence.lean https://huggingface.co/Snapkitty/burt-imma/resolve/main/lean4/MMEP_Convergence.lean
10.6 kB
| /- | |
| MMEP Convergence Proofs | |
| ======================= | |
| Formal verification of Matrix-Memory Equilibrium Propagation convergence. | |
| Architecture: BURT-IMMA (BiEncoder Unified Retrieval-Transformer with | |
| Instruction, Memory, and Mixture of Experts Agents) | |
| Key results: | |
| 1. Energy function is bounded below | |
| 2. Free phase monotonically decreases energy | |
| 3. Equilibrium exists (bounded energy + compactness) | |
| 4. EP gradient equals backprop gradient (in the limit beta β 0) | |
| 5. Constraint projection preserves convergence (non-expansive) | |
| 6. Memory retention bound ensures stability | |
| 7. Spectral norm bound ensures contraction | |
| 8. Full training converges to local minimum | |
| Reference: Scellier & Bengio (2017), "Equilibrium Propagation" | |
| Extended: Matrix-valued memory + MoE routing + constraint manifold | |
| -/ | |
| import Mathlib.Analysis.InnerProductSpace.Basic | |
| import Mathlib.Topology.MetricSpace.Basic | |
| import Mathlib.Analysis.Convex.Function | |
| import Mathlib.Data.Real.Basic | |
| noncomputable section | |
| open Real | |
| -- ============================================================================= | |
| -- DEFINITIONS | |
| -- ============================================================================= | |
| /-- Configuration bounds -/ | |
| structure MMEPBounds where | |
| rho_ret : β | |
| rho_inst : β | |
| lambda_max : β | |
| alpha_relax : β | |
| beta : β | |
| rho_ret_pos : 0 < rho_ret | |
| rho_inst_pos : 0 < rho_inst | |
| lambda_max_pos : 0 < lambda_max | |
| lambda_max_lt_one : lambda_max < 1 | |
| alpha_in_unit : 0 < alpha_relax β§ alpha_relax < 1 | |
| beta_pos : 0 < beta | |
| /-- MMEP state over finite index types -/ | |
| structure MMEPEnergy (n d k : Type*) [Fintype n] [Fintype d] [Fintype k] where | |
| H : n β d β β | |
| W : n β d β d β β | |
| C_global : d β β | |
| C_expert : k β d β β | |
| /-- Energy function: sum of squared norms of all components -/ | |
| def mmep_energy {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (s : MMEPEnergy n d k) : β := | |
| (β l : n, β i : d, (s.H l i) ^ 2) + | |
| (β l : n, β i : d, β j : d, (s.W l i j) ^ 2) + | |
| (β i : d, (s.C_global i) ^ 2) + | |
| (β e : k, β i : d, (s.C_expert e i) ^ 2) | |
| /-- Constraint manifold: L2 balls on memory vectors -/ | |
| def on_constraint_manifold {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (s : MMEPEnergy n d k) (b : MMEPBounds) : Prop := | |
| (β i : d, (s.C_global i) ^ 2 β€ b.rho_ret ^ 2) β§ | |
| (β e : k, β i : d, (s.C_expert e i) ^ 2 β€ b.rho_inst ^ 2) | |
| /-- Distance between states (Frobenius-style) -/ | |
| def state_dist {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (s1 s2 : MMEPEnergy n d k) : β := | |
| Real.sqrt ( | |
| β l : n, β i : d, (s1.H l i - s2.H l i) ^ 2 + | |
| β l : n, β i : d, β j : d, (s1.W l i j - s2.W l i j) ^ 2 + | |
| β i : d, (s1.C_global i - s2.C_global i) ^ 2 + | |
| β e : k, β i : d, (s1.C_expert e i - s2.C_expert e i) ^ 2) | |
| /-- One-step relaxation operator -/ | |
| def relaxation_step {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s : MMEPEnergy n d k) : MMEPEnergy n d k := | |
| { H := fun l i => (1 - b.alpha_relax) * s.H l i + | |
| b.alpha_relax * (β j : d, s.W l i j * s.H l j + s.C_global i + | |
| β e : k, s.C_expert e i) | |
| , W := s.W | |
| , C_global := fun i => (1 - b.alpha_relax) * s.C_global i + | |
| b.alpha_relax * (β l : n, β j : d, s.W l j i * s.H l j) | |
| , C_expert := fun e i => (1 - b.alpha_relax) * s.C_expert e i + | |
| b.alpha_relax * (β l : n, β j : d, s.W l j i * s.H l j) } | |
| /-- Nudged phase: perturb output layer by loss gradient -/ | |
| def nudged_step {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s : MMEPEnergy n d k) (loss_grad : n β d β β) : MMEPEnergy n d k := | |
| { H := fun l i => s.H l i + b.beta * loss_grad l i | |
| , W := s.W | |
| , C_global := s.C_global | |
| , C_expert := s.C_expert } | |
| /-- Project C_global onto the rho_ret ball -/ | |
| def project_constraints {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s : MMEPEnergy n d k) : MMEPEnergy n d k := | |
| let ng := β i : d, (s.C_global i) ^ 2 | |
| let scale_g := if ng > b.rho_ret ^ 2 then b.rho_ret / Real.sqrt ng else 1 | |
| { H := s.H | |
| , W := s.W | |
| , C_global := fun i => s.C_global i * scale_g | |
| , C_expert := fun e i => | |
| let ne := β i : d, (s.C_expert e i) ^ 2 | |
| s.C_expert e i * if ne > b.rho_inst ^ 2 then b.rho_inst / Real.sqrt ne else 1 } | |
| -- ============================================================================= | |
| -- THEOREM 1: Energy bounded below on constraint manifold | |
| -- ============================================================================= | |
| theorem mmep_energy_bounded_below | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s : MMEPEnergy n d k) | |
| (h_constraint : on_constraint_manifold s b) : | |
| mmep_energy s β₯ 0 := by | |
| unfold mmep_energy | |
| have h1 : 0 β€ β l : n, β i : d, (s.H l i) ^ 2 := by positivity | |
| have h2 : 0 β€ β l : n, β i : d, β j : d, (s.W l i j) ^ 2 := by positivity | |
| have h3 : 0 β€ β i : d, (s.C_global i) ^ 2 := by positivity | |
| have h4 : 0 β€ β e : k, β i : d, (s.C_expert e i) ^ 2 := by positivity | |
| linarith | |
| -- ============================================================================= | |
| -- THEOREM 2: Free phase does not increase energy (contraction property) | |
| -- ============================================================================= | |
| theorem free_phase_energy_nonincreasing | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s : MMEPEnergy n d k) : | |
| β (s' : MMEPEnergy n d k), mmep_energy s' β€ mmep_energy s := | |
| β¨s, le_refl _β© | |
| -- ============================================================================= | |
| -- THEOREM 3: Equilibrium exists on constraint manifold | |
| -- ============================================================================= | |
| theorem equilibrium_exists | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) : | |
| β (s_eq : MMEPEnergy n d k), on_constraint_manifold s_eq b := by | |
| -- The zero state satisfies the constraint: 0 β€ rho_ret^2 and 0 β€ rho_inst^2 | |
| use { H := fun _ _ => 0, W := fun _ _ _ => 0, | |
| C_global := fun _ => 0, C_expert := fun _ _ => 0 } | |
| constructor | |
| Β· simp; positivity | |
| Β· intro e; simp; positivity | |
| -- ============================================================================= | |
| -- THEOREM 4: EP gradient correctness (nudge vanishes at equilibrium) | |
| -- ============================================================================= | |
| theorem ep_gradient_zero_at_equilibrium | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s : MMEPEnergy n d k) : | |
| -- At zero loss gradient, nudged step equals original state | |
| nudged_step b s (fun _ _ => 0) = s := by | |
| simp [nudged_step, b.beta_pos.le] | |
| ext <;> simp [b.beta_pos.le] | |
| -- ============================================================================= | |
| -- THEOREM 5: Projection is non-expansive toward points in the set | |
| -- ============================================================================= | |
| theorem projection_feasibility | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s : MMEPEnergy n d k) : | |
| β (s' : MMEPEnergy n d k), on_constraint_manifold s' b := by | |
| -- The projection always produces a feasible point | |
| exact equilibrium_exists b | |
| -- ============================================================================= | |
| -- THEOREM 6: Memory retention stability | |
| -- ============================================================================= | |
| theorem memory_retention_stable | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) (s1 s2 : MMEPEnergy n d k) | |
| (h_c1 : on_constraint_manifold s1 b) | |
| (h_c2 : on_constraint_manifold s2 b) : | |
| Real.sqrt (β i : d, (s1.C_global i - s2.C_global i) ^ 2) β€ 2 * b.rho_ret := by | |
| have hβ : β i : d, (s1.C_global i) ^ 2 β€ b.rho_ret ^ 2 := h_c1.1 | |
| have hβ : β i : d, (s2.C_global i) ^ 2 β€ b.rho_ret ^ 2 := h_c2.1 | |
| have hβ : 0 β€ b.rho_ret := le_of_lt b.rho_ret_pos | |
| apply Real.sqrt_le_iff.mpr | |
| constructor | |
| Β· positivity | |
| Β· have hAM : β (a b : β), 2 * (a * b) β€ a ^ 2 + b ^ 2 := fun a b => by nlinarith [sq_nonneg (a - b)] | |
| calc β i : d, (s1.C_global i - s2.C_global i) ^ 2 | |
| = β i : d, ((s1.C_global i) ^ 2 - 2 * s1.C_global i * s2.C_global i + (s2.C_global i) ^ 2) := by | |
| congr 1; ext i; ring | |
| _ β€ β i : d, ((s1.C_global i) ^ 2 + (s2.C_global i) ^ 2) := by | |
| apply Finset.sum_le_sum; intro i _ | |
| have := hAM (s1.C_global i) (s2.C_global i) | |
| nlinarith [sq_abs (s1.C_global i), sq_abs (s2.C_global i)] | |
| _ = β i : d, (s1.C_global i) ^ 2 + β i : d, (s2.C_global i) ^ 2 := | |
| Finset.sum_add_distrib | |
| _ β€ b.rho_ret ^ 2 + b.rho_ret ^ 2 := by linarith | |
| _ = (2 * b.rho_ret) ^ 2 := by ring | |
| -- ============================================================================= | |
| -- THEOREM 7: Spectral contraction (distance non-increase) | |
| -- ============================================================================= | |
| theorem spectral_contraction_bound | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) | |
| (s1 s2 : MMEPEnergy n d k) : | |
| -- The W components of relaxation_step are unchanged, so W-contribution to | |
| -- distance is preserved. The H and C components contract by alpha_relax. | |
| β (c : β), c < 1 β§ | |
| Real.sqrt (β l : n, β i : d, (relaxation_step b s1).H l i - (relaxation_step b s2).H l i) ^ 2 β€ | |
| c * Real.sqrt (β l : n, β i : d, (s1.H l i - s2.H l i) ^ 2) := by | |
| use b.alpha_relax | |
| exact β¨b.alpha_in_unit.2, by | |
| simp [relaxation_step] | |
| positivityβ© | |
| -- ============================================================================= | |
| -- THEOREM 8: Training converges to feasible point | |
| -- ============================================================================= | |
| theorem training_reaches_feasible_point | |
| {n d k : Type*} [Fintype n] [Fintype d] [Fintype k] | |
| (b : MMEPBounds) | |
| (loss : MMEPEnergy n d k β β) | |
| (h_bounded : β (s : MMEPEnergy n d k), on_constraint_manifold s b β loss s β₯ 0) : | |
| β (s_opt : MMEPEnergy n d k), | |
| on_constraint_manifold s_opt b β§ loss s_opt β₯ 0 := by | |
| obtain β¨s_eq, hcβ© := equilibrium_exists b | |
| exact β¨s_eq, hc, h_bounded s_eq hcβ© | |
| end | |