import gradio as gr from huggingface_hub import HfApi from huggingface_hub.utils import HfHubHTTPError, RepositoryNotFoundError import os import uuid # --- State Management and API Client --- def get_hf_api(token): """Initializes the HfApi client. Allows read-only operations if no token is provided.""" return HfApi(token=token if token else None) # --- UI Functions --- def handle_token_change(token): """ Called when the token is entered. Fetches user info and updates UI interactivity. """ if not token: # No token, disable write actions and clear user-specific info update_dict = { manage_files_btn: gr.update(interactive=False), delete_repo_btn: gr.update(interactive=False), commit_btn: gr.update(interactive=False), author_input: gr.update(value=""), whoami_output: gr.update(value=None, visible=False) } return (None, "", *update_dict.values()) try: api = get_hf_api(token) user_info = api.whoami() username = user_info.get('name') # Token is valid, enable write actions and set author update_dict = { manage_files_btn: gr.update(interactive=True), delete_repo_btn: gr.update(interactive=True), commit_btn: gr.update(interactive=True), author_input: gr.update(value=username), whoami_output: gr.update(value=user_info, visible=True) } return (token, username, *update_dict.values()) except HfHubHTTPError as e: gr.Warning(f"Invalid Token: {e}. You can only perform read-only actions.") update_dict = { manage_files_btn: gr.update(interactive=False), delete_repo_btn: gr.update(interactive=False), commit_btn: gr.update(interactive=False), whoami_output: gr.update(value=None, visible=False) } return (token, "", *update_dict.values()) def list_repos(token, author, repo_type): """Lists repositories for a given author and type.""" if not author: gr.Info("Please enter an author (username or organization) to list repositories.") return gr.update(choices=[], value=None), gr.update(visible=False), gr.update(visible=False) try: api = get_hf_api(token) # Use the dedicated list functions for clarity e.g. api.list_models, api.list_spaces list_fn = getattr(api, f"list_{repo_type}s") repos = list_fn(author=author) repo_ids = [repo.id for repo in repos] return gr.update(choices=repo_ids, value=None), gr.update(visible=False), gr.update(visible=False) except HfHubHTTPError as e: gr.Error(f"Could not list repositories: {e}") return gr.update(choices=[], value=None), gr.update(visible=False), gr.update(visible=False) def handle_repo_selection(repo_id): """Called when a repo is selected. Makes action buttons visible.""" if repo_id: return gr.update(visible=True), gr.update(visible=False) # Show actions, hide editor return gr.update(visible=False), gr.update(visible=False) # Hide everything def delete_repo(token, repo_id, repo_type): """Deletes the selected repository.""" if not token: gr.Error("A write-enabled Hugging Face token is required to delete a repository.") return repo_id, gr.update(visible=True), gr.update(visible=False) if not repo_id: gr.Warning("No repository selected to delete.") return repo_id, gr.update(visible=True), gr.update(visible=False) try: api = get_hf_api(token) api.delete_repo(repo_id=repo_id, repo_type=repo_type) gr.Info(f"Successfully deleted '{repo_id}'.") return None, gr.update(visible=False), gr.update(visible=False) except HfHubHTTPError as e: gr.Error(f"Failed to delete repository: {e}") return repo_id, gr.update(visible=True), gr.update(visible=False) # --- File Editor Functions --- def show_file_manager(token, repo_id, repo_type): if not repo_id: gr.Warning("No repository selected.") return gr.update(visible=False), gr.update(), gr.update(), gr.update() try: api = get_hf_api(token) repo_files = api.list_repo_files(repo_id=repo_id, repo_type=repo_type) filtered_files = [f for f in repo_files if not f.startswith('.')] return ( gr.update(visible=True), gr.update(choices=filtered_files, value=None), gr.update(value="## Select a file to view or edit.", language='markdown'), "" ) except Exception as e: gr.Error(f"Could not list files: {e}") return gr.update(visible=False), gr.update(), gr.update(), gr.update() def load_file_content(token, repo_id, repo_type, filepath): if not filepath: return gr.update(value="## Select a file to view its content.", language='markdown') try: api = get_hf_api(token) local_path = api.hf_hub_download(repo_id=repo_id, repo_type=repo_type, filename=filepath, token=token) with open(local_path, 'r', encoding='utf-8') as f: content = f.read() language = os.path.splitext(filepath)[1].lstrip('.').lower() if language == 'py': language = 'python' if language == 'js': language = 'javascript' if language == 'md': language = 'markdown' else: language = 'python' return gr.update(value=content, language=language) except Exception as e: return gr.update(value=f"Error loading file: {e}", language='plaintext') def commit_file(token, repo_id, repo_type, filepath, content, commit_message): if not token: gr.Error("A write-enabled token is required."); return if not filepath: gr.Warning("No file selected."); return if not commit_message: gr.Warning("Commit message cannot be empty."); return try: api = get_hf_api(token) api.upload_file( path_or_fileobj=bytes(content, 'utf-8'), path_in_repo=filepath, repo_id=repo_id, repo_type=repo_type, commit_message=commit_message, ) gr.Info(f"Successfully committed '{filepath}' to '{repo_id}'!") except Exception as e: gr.Error(f"Failed to commit file: {e}") # --- Gradio UI Layout --- with gr.Blocks(theme=gr.themes.Soft(primary_hue="blue"), title="Hugging Face Hub Toolkit") as demo: # State management hf_token_state = gr.State(None) author_state = gr.State("") selected_repo_id = gr.State(None) selected_repo_type = gr.State("space") # Default gr.Markdown("# Hugging Face Hub Dashboard") gr.Markdown("An intuitive interface to manage your Hugging Face repositories. **Enter a write-token for full access.**") with gr.Sidebar(): hf_token = gr.Textbox(label="Hugging Face API Token", type="password", placeholder="hf_...", scale=3) whoami_output = gr.JSON(label="Authenticated User", visible=False, scale=1) with gr.Row(equal_height=False): with gr.Column(scale=1): gr.Markdown("### 1. Select a Repository") author_input = gr.Textbox(label="Author (Username or Org)", interactive=True) repo_selector = gr.Radio(label="Select a Repository", interactive=True, value=None) with gr.Tabs() as repo_type_tabs: for repo_type, label in [("space", "Spaces"), ("model", "Models"), ("dataset", "Datasets")]: with gr.Tab(label, id=repo_type): btn = gr.Button(f"List {label}") btn.click( fn=list_repos, inputs=[hf_token_state, author_input, gr.State(repo_type)], outputs=[repo_selector, gr.Column(), gr.Column()] # Dummy outputs for panels to hide them ).then(fn=lambda author: author, inputs=author_input, outputs=author_state) with gr.Column(scale=3): with gr.Column(visible=False) as action_panel: gr.Markdown("### 2. Choose an Action") with gr.Row(): manage_files_btn = gr.Button("Manage Files", interactive=False, scale=1) delete_repo_btn = gr.Button("Delete This Repo", variant="stop", interactive=False, scale=1) with gr.Column(visible=False) as editor_panel: gr.Markdown("### 3. Edit Files") file_selector = gr.Dropdown(label="Select File", interactive=True) code_editor = gr.Code(label="File Content", language="markdown", interactive=True) commit_message_input = gr.Textbox(label="Commit Message", placeholder="e.g., Update README.md", interactive=True) commit_btn = gr.Button("Commit Changes", variant="primary", interactive=False) # --- Event Handlers --- hf_token.change( fn=handle_token_change, inputs=hf_token, outputs=[hf_token_state, author_state, manage_files_btn, delete_repo_btn, commit_btn, author_input, whoami_output] ) repo_type_tabs.select( fn=lambda rt: (rt, None, gr.update(choices=[], value=None), gr.update(visible=False), gr.update(visible=False)), inputs=repo_type_tabs, outputs=[selected_repo_type, selected_repo_id, repo_selector, action_panel, editor_panel] ) repo_selector.select( fn=lambda repo_id: (repo_id, *handle_repo_selection(repo_id)), inputs=repo_selector, outputs=[selected_repo_id, action_panel, editor_panel] ) manage_files_btn.click( fn=show_file_manager, inputs=[hf_token_state, selected_repo_id, selected_repo_type], outputs=[editor_panel, file_selector, code_editor, commit_message_input] ) delete_repo_btn.click( fn=delete_repo, inputs=[hf_token_state, selected_repo_id, selected_repo_type], outputs=[selected_repo_id, action_panel, editor_panel], js="() => confirm('Are you sure you want to permanently delete this repository? This action cannot be undone.')" ).then( # On successful deletion, refresh the repo list. # THIS IS THE CORRECTED PART: Pass Gradio components to inputs, not a lambda. fn=list_repos, inputs=[hf_token_state, author_state, selected_repo_type], outputs=[repo_selector, action_panel, editor_panel] ) file_selector.change( fn=load_file_content, inputs=[hf_token_state, selected_repo_id, selected_repo_type, file_selector], outputs=code_editor ) commit_btn.click( fn=commit_file, inputs=[hf_token_state, selected_repo_id, selected_repo_type, file_selector, code_editor, commit_message_input] ) if __name__ == "__main__": demo.launch(debug=False)