deploy_process.md

Hugging Face Space Deployment Process

If uploads through the Hugging Face web UI keep failing with package errors, use this Git-based flow instead. It preserves correct file line endings and avoids CRLF conversion issues.

Why this is needed

When files are uploaded via UI from Windows, line endings may become CRLF (\r\n). In Linux build containers, this can break packages.txt parsing and cause errors like:

• E: Unable to locate package texlive-latex-base
• E: Unable to locate package texlive-latex-extra

Step-by-step deployment

1) Clone your Hugging Face Space

git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME

You will be prompted for credentials:

• Username: your Hugging Face username
• Password: use a Hugging Face Access Token (not account password)

Create token here: https://huggingface.co/settings/tokens (with write permission)

2) Copy your local project files into the cloned Space repo

xcopy /E /Y "D:\Projects\Personal_assistant\*" "D:\Projects\YOUR_SPACE_NAME\"

3) Enforce LF line endings before commit

Inside the cloned Space folder:

cd D:\Projects\YOUR_SPACE_NAME
git add --renormalize .

This ensures files are normalized with .gitattributes rules.

4) Commit and push

git add .
git commit -m "Deploy app with correct line endings"
git push

The Space rebuild starts automatically after push.

Recommended ongoing workflow

For all future updates:

1. Update files locally.
2. Copy changes into the cloned Space repo.
3. Run git add ., git commit, and git push.

Prefer Git push over web UI uploads for deployment reliability.