Known Issues

Known Issues & Workarounds

This page documents known issues, limitations, and potential workarounds for the Hugging Face Backup Tool.

Table of Contents

1. Single File Upload
2. Output Logging in Terminal
3. Repository Creation Issues
4. Spacing and UI Glitches
5. Multiple File Selection Not Implemented
6. macOS Development Challenges
7. Other Issues
8. How to Report Issues

1. Single File Upload

Issue: The current version of the tool only supports uploading one file at a time. Selecting multiple files will only upload the first selected file.

• Status: Planned Enhancement.
• Impact: Requires manual uploading of multiple files if you need to backup many files.
• Workaround: Upload files one at a time.

2. Output Logging in Terminal

Issue: The output and progress updates from the upload process are primarily displayed in the terminal logs and not fully in the GUI's output window.

• Status: Planned Enhancement.
• Impact: Users must check the terminal for detailed progress information and error messages.
• Workaround: Monitor the terminal output while the upload is in progress.

3. Repository Creation Issues

Issue: There have been reports of issues creating new repositories directly from within the tool.

• Status: Investigating.
• Impact: Users might not be able to create a new repository directly from the GUI, but may need to create a repository via the Hugging Face Hub interface first.
• Workaround:
  1. Create the repository manually on the Hugging Face Hub website (https://huggingface.co/new).
  2. Enter the repository details (owner/username, repository name, and type) in the tool.

4. Spacing and UI Glitches

Issue: Minor UI layout or spacing issues may be present in certain themes or on specific operating systems.

• Status: Cosmetic.
• Impact: Minor display inconsistencies.
• Workaround: None. This will be fixed as a part of UI updates.

5. Multiple File Selection Not Implemented

Issue: The tool does not support selecting and uploading multiple files. Only one file at a time may be uploaded.

• Status: Planned Enhancement.
• Impact: Requires manual uploading of multiple files if you need to backup many files.
• Workaround: Upload files one at a time.

6. macOS Development Challenges

Issue: The development process on macOS may be tricky.

• Status: General Challenge
• Impact: Development and testing of this tool is harder on macOS machines.
• Workaround: None.

7. Other Issues

• Unspecified: If there are any other issues, they will be added to this page.

8. How to Report Issues

If you encounter an issue not listed here, please:

1. Open an Issue: Create a new issue on the project's GitHub repository ([Link to your Issues page]).
2. Provide Details: Include the following information in your issue:
   • A clear description of the problem.
   • Steps to reproduce the issue.
   • Your operating system and version.
   • The tool's version.
   • Any relevant error messages or screenshots.