spaceforge / README_HF.md
2Btainment's picture
feat(ui): labels/ordering/platform hints for Linux AppImage, Arch PKGBUILD, MCP; API tests; README
d6faa34
|
Raw History Blame Contribute Delete
2.09 kB
metadata
title: SpaceForge
emoji: πŸ› οΈ
colorFrom: indigo
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Package HF Spaces as widgets, PWAs, extensions

SpaceForge

Paste a Hugging Face Space URL β†’ analyze runtime β†’ choose packaging targets β†’ download artifacts.

Delivery modes

Mode Meaning
Local Project/app you build or run on your machine (e.g. Tauri project zip)
Hybrid Local shell + live hosted Space (PWA, extensions, HTML widget)
Hosted Wrapper Thin client that always needs the Space URL β€” never labeled Local

MVP targets

  • HTML Widget (zip) β€” Hybrid

  • PWA (zip) β€” Hybrid

  • Firefox Extension (.xpi) β€” Hybrid

  • Chromium Extension MV3 (zip) β€” Hybrid

  • Tauri project generator (zip) β€” Local project (no binary claimed on HF)

  • Android Capacitor β€” Hosted Wrapper debug APK when SDK build succeeds (unsigned); project zip fallback if APK build fails

  • Linux AppImage (x86_64 .AppImage) β€” Hosted Wrapper: pinned prebuilt Neutralinojs 6.10.0 window loading the live Space; packed with pinned appimagetool 1.9.1 (no FUSE needed to build). Needs webkit2gtk-4.1 + gtk3 on the host.

  • Arch Linux (PKGBUILD) (-pkgbuild.tar.gz) β€” Hosted Wrapper for Arch/CachyOS/Manjaro: tar xf …; cd …; makepkg -si installs /opt/<pkg>, /usr/bin/<pkg>, desktop entry + icon.

  • MCP Server / Config (zip) β€” Gradio Spaces with mcp_server=True β†’ Cursor / Claude Desktop / generic configs for the Space's own /gradio_api/mcp/sse; otherwise a small Python MCP stdio server (one tool per Gradio API endpoint via gradio_client, or a generic call_space HTTP tool for Docker Spaces). Optional HF_TOKEN env.

Stub (clear message): Windows portable β€” not buildable inside HF CPU.

See ANDROID.md for Android install steps and labeling.

Privacy

Optional HF_TOKEN for private Spaces is used only for the request and never logged. Docs use [ERSATZ_KEY].

Built for 2Btainment (Rob Boss).