From 8a88c90ccb28f2fea15086b93b2379116f4916c0 Mon Sep 17 00:00:00 2001
From: Saikat K <31238298+Aviksaikat@users.noreply.github.com>
Date: Tue, 27 Jan 2026 10:23:01 +0530
Subject: [PATCH 1/2] docs: Add troubleshooting guide for HyperSync
 installation

Added troubleshooting section for HyperSync installation issues, including installation instructions for Ubuntu/Debian and macOS.
---
 README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/README.md b/README.md
index 8ebd466..f1997f1 100644
--- a/README.md
+++ b/README.md
@@ -33,3 +33,44 @@ Next, add your HyperSync token to the `.env` file. You can then run an example u
 ```bash
 python examples/<example>.py
 ```
+
+## Troubleshooting
+
+### HyperSync Installation Issues
+
+If you encounter build errors when installing `hypersync`, ensure Rust and system dependencies are installed.
+
+**Ubuntu/Debian:**
+```bash
+# Install all required dependencies
+sudo apt-get update
+sudo apt-get install build-essential capnproto libcapnp-dev
+
+# Install Rust (if not already installed)
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+source $HOME/.cargo/env
+```
+
+**macOS:**
+```bash
+# Install Xcode command line tools
+xcode-select --install
+
+# Install Cap'n Proto via Homebrew
+brew install capnp
+
+# Install Rust (if not already installed)
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+source $HOME/.cargo/env
+```
+
+**Then install hypersync:**
+```bash
+pip install --no-cache-dir --use-pep517 "hypersync==0.7.17"
+```
+
+Common errors:
+- **"cargo not found"**: Install Rust toolchain
+- **"capnp: No such file or directory"**: Install Cap'n Proto (`apt-get install capnproto libcapnp-dev` on Ubuntu, `brew install capnp` on macOS)
+- **Build fails on Linux**: Install build essentials: `apt-get install build-essential`
+

From 25156914426428bd29ab983a5b4c2c1e84897191 Mon Sep 17 00:00:00 2001
From: Saikat K <31238298+Aviksaikat@users.noreply.github.com>
Date: Tue, 27 Jan 2026 10:44:39 +0530
Subject: [PATCH 2/2] docs: Change hypersync version in installation
 instructions

Updated hypersync installation command to version 0.8.5.
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f1997f1..c5c3d3d 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@ source $HOME/.cargo/env
 
 **Then install hypersync:**
 ```bash
-pip install --no-cache-dir --use-pep517 "hypersync==0.7.17"
+pip install --no-cache-dir --use-pep517 "hypersync==0.8.5"
 ```
 
 Common errors: