---
title: MidasMap
emoji: 🔬
colorFrom: gray
colorTo: blue
sdk: gradio
sdk_version: 4.44.1
app_file: app.py
pinned: false
license: mit
---

# MidasMap Space

Gradio demo for **[MidasMap](https://github.com/AnikS22/MidasMap)** (immunogold particle detection in TEM synapse images).

## Deploy from your laptop

From the **MidasMap** repo root:

```bash
export HF_TOKEN=hf_...   # write token
# Recommended: do not upload the ~100MB checkpoint into the Space (avoids LFS / size issues).
export HF_SPACE_SKIP_CHECKPOINT=1
./scripts/upload_hf_space.sh
```

If **`upload_hf_space.sh` fails**, use **git + LFS** instead (often more reliable):

```bash
brew install git-lfs && git lfs install   # once
export HF_TOKEN=hf_...
./scripts/push_hf_space_git.sh
```

Full options: [docs/DEPLOY.md](../docs/DEPLOY.md) in the main repo.

Create the Space once if needed (Gradio SDK required for auto-create):

```bash
huggingface-cli repo create MidasMap --type space --space_sdk gradio -y
```

Weights are loaded from the **model** repo `AnikS22/MidasMap` at `checkpoints/final/final_model.pth` when the file is not in the Space. Override with Space secrets / env: `MIDASMAP_HF_WEIGHTS_REPO`, `MIDASMAP_HF_WEIGHTS_FILE`.

To bundle the checkpoint in the Space instead (larger upload):

```bash
export HF_SPACE_SKIP_CHECKPOINT=0
./scripts/upload_hf_space.sh
```

## Troubleshooting uploads

| Symptom | What to do |
|--------|----------------|
| **401 / not logged in** | `export HF_TOKEN=hf_...` with a token that has **write** access, or `huggingface-cli login`. |
| **LFS / authorization / upload stuck** | Use `HF_SPACE_SKIP_CHECKPOINT=1` so only code uploads; ensure the **model** repo (not the Space) contains `checkpoints/final/final_model.pth`. |
| **Space does not exist** | Create it in the HF web UI (**New Space** → **Gradio**) or run `huggingface-cli repo create ... --type space --space_sdk gradio`. |
| **“No space_sdk provided”** | The Space repo must be created as **Gradio** (or pass `--space_sdk gradio` when using `repo create`). |
| **Model not found on Space** | First boot downloads weights from the Hub; public repos need no token. Private model repo: add `HF_TOKEN` as a Space **secret** (read). |
| **Still failing** | Try `pip install hf_transfer` and `export HF_HUB_ENABLE_HF_TRANSFER=1` before upload. Or use **git** + **git lfs** clone of the Space, copy files, commit, push. |

## Vercel embed

`https://yoursite.vercel.app/?embed=https://huggingface.co/spaces/YOUR_USER/YOUR_SPACE`