docs: Add troubleshooting guide for HyperSync installation

[Aviksaikat]

Added troubleshooting section for HyperSync installation issues, including installation instructions for Ubuntu/Debian and macOS.

ref: #46

Don't have the full trace info at the moment, but this is how I fixed this on my ubuntu server as well as mac.

Summary by CodeRabbit

• Documentation
  • Added a Troubleshooting section to the README with comprehensive guidance on HyperSync installation: environment prerequisites for Ubuntu/Debian and macOS, step-by-step installation instructions, and a catalog of common errors with recommended fixes.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

Walkthrough

Added a Troubleshooting section to README.md that documents HyperSync installation issues, environment prerequisites for Ubuntu/Debian and macOS, installation steps, and common errors with suggested fixes.

Changes

Cohort / File(s)	Summary
Documentation README.md	Added a Troubleshooting section covering HyperSync installation prerequisites for Ubuntu/Debian and macOS, installation steps, and common error messages with recommended resolutions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 I hopped through docs to lend a paw,
Fixed install bumps and cleared the law,
HyperSync ready, smooth and bright,
Bounce with joy and code tonight! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The pull request title 'docs: Add troubleshooting guide for HyperSync installation' accurately and specifically describes the main change: adding a troubleshooting section to the README documentation for HyperSync installation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@README.md`:
- Around line 67-70: The README currently pins hypersync to an outdated version
"hypersync==0.7.17" in the install command; update that pinned dependency to
"hypersync==0.8.5" in the same install line (the pip install --no-cache-dir
--use-pep517 command) so the README reflects the recommended release.

🧹 Nitpick comments (1)

README.md (1)

49-64: Add a brief safety note for curl | sh installs.

Consider adding a short note to verify the installer or link to the official rustup instructions. This reduces supply‑chain risk in docs.