miosa-modal-shim

Drop-in replacement for the Modal Python SDK that routes all compute to MIOSA instead. Existing Modal scripts run on MIOSA with zero code changes.

Installation

# Replace modal with the MIOSA shim
pip uninstall modal
pip install miosa-modal-shim

The package installs a modal Python module that shadows the real Modal SDK. All import modal statements resolve to this shim.

Configuration

Set your MIOSA API key:

export MIOSA_API_KEY="mki_..."

The shim also reads MODAL_TOKEN_ID as a fallback, so existing CI configurations that set Modal credentials continue to work after you swap the key value.

Usage

Your existing Modal code works unchanged:

import modal

app = modal.App("my-app")

@app.function(gpu="any", image=modal.Image.debian_slim().pip_install("torch"))
def train(data):
    import torch
    return torch.tensor(data).sum().item()

# Runs on a MIOSA sandbox with a GPU
result = train.remote(data=[1, 2, 3])
print(result)  # 6.0

Execution modes

Image builder

image = (
    modal.Image.debian_slim(python_version="3.11")
    .apt_install("git", "ffmpeg")
    .pip_install("torch", "transformers")
    .run_commands("echo 'setup done'")
)

Secrets

# From explicit dict
secret = modal.Secret.from_dict({"HF_TOKEN": "hf_..."})

# From environment (reads MYAPP_* env vars)
secret = modal.Secret.from_name("myapp")

@app.function(secrets=[secret])
def inference():
    ...

Volumes

vol = modal.Volume.from_name("training-data", create_if_missing=True)

@app.function(volumes={"/data": vol})
def process():
    ...

Volumes provide API compatibility. Persistent cross-sandbox storage is on the roadmap.

What is supported

Not yet supported

• modal.web_endpoint / modal.asgi_app / modal.wsgi_app
• modal.Cron
• modal.Dict / modal.Queue
• Class method-level .remote() dispatch

License

MIT