Instructions to use FelixCoooper/Echo-DM with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use FelixCoooper/Echo-DM with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline from diffusers.utils import load_image # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("FelixCoooper/Echo-DM", dtype=torch.bfloat16, device_map="cuda") prompt = "Turn this cat into a dog" input_image = load_image("https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/cat.png") image = pipe(image=input_image, prompt=prompt).images[0] - Notebooks
- Google Colab
- Kaggle
Download README.md from FelixCoooper/Echo-DM: direct link, hf CLI and curl.
- Browser
- Download file 4.45 kB
-
https://huggingface.co/FelixCoooper/Echo-DM/resolve/main/README.md
- Command line
-
hf download hf://FelixCoooper/Echo-DM/README.md
-
curl -L -H "Authorization: Bearer $HF_TOKEN" -o README.md https://huggingface.co/FelixCoooper/Echo-DM/resolve/main/README.md
license: other
license_name: echo-dm-non-commercial-research-access
license_link: https://huggingface.co/FelixCoooper/Echo-DM/blob/main/USE_CONDITIONS.md
pipeline_tag: image-to-image
tags:
- ultrasound
- image-restoration
- diffusion
- marker-removal
extra_gated_heading: Request access for non-commercial research
extra_gated_description: >-
Requests are reviewed manually. Provide your institutional affiliation, an
institutional email address you control, and a specific research purpose.
extra_gated_button_content: Submit access request
extra_gated_prompt: >-
By submitting an application, you acknowledge the use conditions and agree
that your application and shared Hugging Face account information may be used
to assess and administer your access request.
extra_gated_fields:
Full name: text
Institution / organization: text
Department / laboratory: text
Institutional email address: text
Institutional profile / laboratory URL: text
Role:
type: select
options:
- Student
- Researcher
- Faculty
- Clinician
- Other
Research project and intended non-commercial use: text
I confirm that I control the institutional email address provided: checkbox
I have read the use conditions and agree to non-commercial research use only: checkbox
Echo-DM-V (Efficient)
Checkpoint bundle for Echo-DM: Ultrasound Marker Removal via Conditional Latent Diffusion and Region-Aware Fusion. Only the Efficient configuration is included.
| Setting | Value |
|---|---|
| DiT input size | 512 x 512 |
| VAE compression | 8x |
| Sampling steps | 50 |
| Latent multiplier | 0.932 |
| RAF | 2x-resolution fusion with residual refinement |
Files
vae/8x/config.json
vae/8x/diffusion_pytorch_model.safetensors
v-efficient/dit.pt
v-efficient/raf.pt
manifest.json
The four checkpoint/config files total approximately 859 MB. The manifest records their byte sizes and SHA-256 checksums. This repository supplies component weights; run the pipeline using the GitHub code rather than loading this repository as a standalone Diffusers pipeline.
Download and run after approval
From the inference-code repository root, with huggingface_hub installed:
hf auth login
hf download FelixCoooper/Echo-DM --repo-type model --local-dir weights
python -m echo_dm.inference --input /path/to/marked.png --output outputs/example --seed 42
Inference requires only marked images, and output PNGs retain their original dimensions. See the GitHub README for installation and usage.
Use conditions and upstream components
Non-commercial research access is subject to USE_CONDITIONS.md. The Apache 2.0 license for original code contributions in the GitHub repository does not license this checkpoint bundle. Upstream component terms remain applicable; this bundle uses an adapted SD VAE.
Request access
- Sign in to your individual Hugging Face account and submit the application.
- Supply your institution, institutional email, official profile and a specific non-commercial research purpose. Accept the use conditions.
- Wait for manual review. Verification of institutional affiliation and control of the institutional mailbox is required before approval. Additional verification instructions may be provided privately during review.
- Once approved, authenticate downloads with the approved account. Approval is per individual user and per repository; model and dataset permissions are separate.
The institutional-email form field is self-reported; submitting the form does not itself verify ownership of that mailbox. Do not post application details in public GitHub Issues or share your account tokens.
Application information
The publisher uses the submitted information and shared HF username/account email for access review and administration. Application records should be accessible only to authorized reviewers. Additional privacy/retention details will be provided before applications are opened publicly.