Update language files

README.md

@@ -101,3 +101,37 @@ python download_and_compare.py
 ```
 
 The script will automatically load your `.env` file for local testing.
+
+## Troubleshooting
+
+### Git Authentication Issues
+
+If you encounter authentication errors like "could not read Username", try these steps:
+
+1. **Verify your `.env` file** contains all required variables:
+   ```bash
+   GIT_REPO_URL=https://github.com/yourusername/yourrepo.git
+   GIT_USERNAME=yourusername
+   GIT_EMAIL=your.email@example.com
+   GITHUB_TOKEN=ghp_your_token_here
+   ```
+
+2. **Test Git configuration** in the container:
+   ```bash
+   docker-compose run --rm download-compare python test_git_config.py
+   ```
+
+3. **Check Personal Access Token permissions**:
+   - Ensure the token has `repo` scope
+   - Verify the token hasn't expired
+   - Check that the token belongs to the correct GitHub account
+
+4. **Verify repository access**:
+   - Ensure your GitHub account has access to the repository
+   - Check if the repository is private and requires authentication
+
+### Common Issues
+
+- **"No such device or address"**: Usually means Git is trying to prompt for credentials interactively
+- **"Authentication failed"**: Check your Personal Access Token and repository permissions
+- **"Repository not found"**: Verify the repository URL and your access permissions