README.md

markdown
---
title: Space Builder
emoji: 🛠️
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.44.0 
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

# Space Builder

A Gradio app to create, view, browse, and update Hugging Face Spaces.
Authenticate using an API token directly or by loading it from a KeyLock Wallet image.

## Features
- Create a new Hugging Face Space with a specified file structure via markdown input.
- Browse files in an existing Space.
- View and edit file contents directly on the Space.
- Update files in a Space with custom commit messages.
- Option to load HF_TOKEN from a KeyLock Wallet image.
- Modern Gradio UI with tabs and improved layout.

## Usage
1.  **Authentication**:
    *   Go to the "Authentication Methods" section.
    *   Either enter your Hugging Face API token (needs 'write' access) directly in the textbox.
    *   Or, upload a KeyLock Wallet image (PNG) and provide its password to load the `HF_TOKEN`. The token loaded from the image will be prioritized.
2.  **To Create a Space**:
    *   Go to the "Create New Space" tab.
    *   Provide the Space Name, Owner (optional, defaults to your username), SDK.
    *   Paste markdown defining the file structure and content. The markdown's `# Space: user/name` line is ignored; UI fields are used for the repository ID.
3.  **To Browse & Edit Files**:
    *   Go to the "Browse & Edit Space Files" tab.
    *   Enter the Space Name and Owner (optional).
    *   Click "Load Files List from Space".
    *   Select a file from the list to view its content in the editor.
    *   Modify the content if needed, provide a commit message, and click "Update File in Space".
#