HF Spaces

# No extra needed: the Hub API is reached over aiohttp, a core dependency.
uv add mirage-ai

import os

from mirage import MountMode, Workspace
from mirage.vfs.hf_spaces import HfSpacesConfig, HfSpacesVFS

config = HfSpacesConfig(
    repo_id=os.environ["HF_SPACE_REPO"],   # "namespace/space-name"
    token=os.environ.get("HF_TOKEN"),
    # Optional:
    # endpoint="https://huggingface.co",
    # revision="main",
)
vfs = HfSpacesVFS(config)
ws = Workspace({"/s": vfs}, mode=MountMode.READ)

/s/
  README.md
  app.py
  requirements.txt
  Dockerfile

import asyncio

from mirage import MountMode, Workspace
from mirage.vfs.hf_spaces import HfSpacesConfig, HfSpacesVFS


async def main() -> None:
    vfs = HfSpacesVFS(
        HfSpacesConfig(repo_id="HuggingFaceBio/carbon-demo"))
    ws = Workspace({"/s": vfs}, mode=MountMode.READ)

    r = await ws.shell("ls /s/")
    print(await r.stdout_str())

    r = await ws.shell("cat /s/README.md | head -n 20")
    print(await r.stdout_str())

    r = await ws.shell("grep -l import /s/*.py 2>/dev/null")
    print(await r.stdout_str())


if __name__ == "__main__":
    asyncio.run(main())