Soft Algebra Optimizer for Quantum & Complex Optimization
Project description
Mobiu-Q v2.7
Mobiu-Q wraps your existing optimizer with Soft Algebra to filter noise and improve convergence. Same API, better results.
๐ What's New in v2.7
- MobiuOptimizer: Universal wrapper - auto-detects PyTorch optimizers!
- Hybrid Mode: Cloud intelligence + local PyTorch performance
- Zero Friction: One-line integration for PyTorch users
- Full Backward Compatibility: All existing code continues to work
โก Quick Start
PyTorch Users (NEW in v2.7!)
import torch
from mobiu_q import MobiuOptimizer
# Your existing code
model = MyModel()
base_opt = torch.optim.Adam(model.parameters(), lr=0.0003)
# Wrap with Mobiu-Q (one line!)
opt = MobiuOptimizer(base_opt, method="adaptive")
# Training loop stays the same
for epoch in range(100):
loss = criterion(model(x), y)
loss.backward()
opt.step(loss.item()) # Pass loss for Soft Algebra
opt.zero_grad()
opt.end()
Quantum Users (unchanged)
from mobiu_q import MobiuQCore
opt = MobiuQCore(method="standard")
for step in range(100):
params = opt.step(params, energy_fn)
opt.end()
๐ Verified Benchmark Results
All benchmarks compare Optimizer + Soft Algebra vs Optimizer alone. Same learning rate, same seeds, fair A/B test.
๐ฎ Reinforcement Learning
| Environment | Improvement | p-value | Win Rate |
|---|---|---|---|
| LunarLander-v3 | +129.7% | <0.001 | 96.7% |
| MuJoCo InvertedPendulum | +118.6% | 0.001 | 100% |
| MuJoCo Hopper | +41.2% | 0.007 | 80% |
๐ Classical Optimization
| Function | Improvement | Description |
|---|---|---|
| Rosenbrock | +75.8% | Valley navigation |
| Beale | +62.0% | Plateau escape |
| Sphere | +31.1% | Convex baseline |
โ๏ธ Quantum VQE - Condensed Matter
| Model | Improvement |
|---|---|
| SSH Model (Topological) | +61.0% |
| XY Model | +60.8% |
| Ferro Ising | +45.1% |
| Transverse Ising | +42.0% |
| Heisenberg XXZ | +20.8% |
| Kitaev Chain | +20.4% |
| Hubbard Dimer | +14.1% |
โ๏ธ Quantum VQE - Chemistry
| Molecule | Improvement |
|---|---|
| FakeFez Hโ | +52.4% (p=0.043) |
| He Atom | +51.2% |
| Hโ Molecule | +46.6% |
| Hโโบ Chain | +42.0% |
| LiH Molecule | +41.4% |
| BeHโ Molecule | +37.8% |
๐ฏ QAOA (Combinatorial Optimization)
| Problem | Improvement | Wins |
|---|---|---|
| FakeFez MaxCut | +45.1% | p=0.0003 |
| Vertex Cover | +31.9% | 51/60 |
| Max Independent Set | +31.9% | 51/60 |
| MaxCut | +21.5% | 45/60 |
๐ฐ Finance (QUBO)
| Problem | Improvement |
|---|---|
| Credit Risk | +52.3% |
| Portfolio Optimization | +51.7% |
๐ Drug Discovery
| Task | Improvement | Config |
|---|---|---|
| Binding Affinity | +12.2% | AMSGrad + standard |
๐ฆ Installation
pip install mobiu-q
๐ง Configuration
๐ See CONFIGURATION_GUIDE.md for complete details
Which Class to Use?
| Use Case | Class | Mode |
|---|---|---|
| PyTorch (RL, LLM, Deep Learning) | MobiuOptimizer |
Hybrid |
| Quantum (VQE, QAOA) | MobiuQCore |
Cloud |
| NumPy optimization | MobiuQCore |
Cloud |
Methods
| Method | Best For | Default LR |
|---|---|---|
standard |
VQE, Chemistry, Finance | 0.01 |
deep |
QAOA, Noisy Hardware | 0.1 |
adaptive |
RL, LLM, High-variance | 0.0003 |
Base Optimizers
| Optimizer | Best For |
|---|---|
Adam |
Default, most cases |
AdamW |
LLM, weight decay |
SGD |
QAOA |
AMSGrad |
Drug Discovery |
NAdam |
Alternative to Adam |
Momentum |
RL alternative |
LAMB |
Large batch |
Important: Optimizer names are case-sensitive!
๐ MobiuOptimizer (v2.7)
The new MobiuOptimizer auto-detects your optimizer type:
from mobiu_q import MobiuOptimizer
# PyTorch optimizer โ Hybrid mode (recommended for RL/LLM)
base_opt = torch.optim.Adam(model.parameters())
opt = MobiuOptimizer(base_opt, method="adaptive")
# NumPy params โ Cloud mode (same as MobiuQCore)
params = np.random.randn(10)
opt = MobiuOptimizer(params, method="standard")
How Hybrid Mode Works
โโโโโโโโโโโโโโโโโโโ loss/return โโโโโโโโโโโโโโโโโโโ
โ Local PyTorch โ โโโโโโโโโโโโโโโโโโโถโ Mobiu Cloud โ
โ โ โ โ
โ โข Gradients โ adaptive_lr โ โข Soft Algebra โ
โ โข Weight Updateโ โโโโโโโโโโโโโโโโโโโโ โข Super-Eq ฮโ โ
โ โข Momentum โ โ โข Trust Ratio โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
Benefits:
- โ PyTorch handles precision & GPU acceleration
- โ Cloud provides Soft Algebra intelligence
- โ Minimal network overhead (only sends loss value)
- โ No momentum state corruption
๐ ๏ธ Troubleshooting
If optimization is not improving or diverging:
1. Switch Base Optimizer
opt = MobiuQCore(license_key="KEY", base_optimizer="NAdam")
opt = MobiuQCore(license_key="KEY", base_optimizer="Momentum")
2. Switch Method
| If This Fails | Try This |
|---|---|
standard |
adaptive |
adaptive |
deep |
deep |
standard |
3. Switch Mode (Quantum)
opt = MobiuQCore(license_key="KEY", mode="hardware")
4. Adjust Learning Rate
| Scenario | Recommendation |
|---|---|
| Diverging | Lower LR by 2-5x |
| No improvement | Increase LR by 2x |
๐ฌ How It Works
Mobiu-Q is based on Soft Algebra (ฮตยฒ=0):
(a, b) ร (c, d) = (ad + bc, bd)
Evolution Law:
S_{t+1} = (ฮณ ยท S_t) ยท ฮ_t + ฮ_t
The Super-Equation ฮโ detects emergence moments for adaptive scaling.
๐ฐ Pricing
| Tier | Price | Runs |
|---|---|---|
| Free | $0 | 20 runs/month |
| Pro | $19/month | Unlimited |
Get your key at app.mobiu.ai
๐ Summary by Domain
| Domain | Best Result | Avg Improvement |
|---|---|---|
| RL | +129.7% | ~96% |
| Classical Opt | +75.8% | ~56% |
| Condensed Matter | +61.0% | ~38% |
| Quantum Chemistry | +52.4% | ~45% |
| Finance | +52.3% | ~52% |
| QAOA | +45.1% | ~32% |
| Drug Discovery | +12.2% | +12% |
๐งโ๐ฌ Scientific Foundation
- Dr. Moshe Klein โ Soft Logic and Soft Numbers
- Prof. Oded Maimon โ Tel Aviv University
๐ Links
- Website: mobiu.ai
- App: app.mobiu.ai
- PyPI: pypi.org/project/mobiu-q
ยฉ 2025 Mobiu Technologies. All rights reserved.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mobiu_q-2.7.tar.gz.
File metadata
- Download URL: mobiu_q-2.7.tar.gz
- Upload date:
- Size: 26.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2fb82f426228463b70776308100655df858bb2fb903d68e5167bc218edb1e28e
|
|
| MD5 |
22a2a9fbb31e5c337c3ff1b6a9d09c02
|
|
| BLAKE2b-256 |
88cb44602b9a1c1527e6f4fc873b13c50f94348de5466fe03be54e23f2481420
|
File details
Details for the file mobiu_q-2.7-py3-none-any.whl.
File metadata
- Download URL: mobiu_q-2.7-py3-none-any.whl
- Upload date:
- Size: 23.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4929548c4c0c48f295abdf76fd9895ac2663953761ae46aabd318d53b3c53e34
|
|
| MD5 |
46605315079dda8723b5191824e87d99
|
|
| BLAKE2b-256 |
6bf2f7794f140494cbd997d4136138e01ea75a91de3524d59c54e87e94d50cbc
|