diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index f71e5b1..77dc8b5 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,6 +73,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          submodules: true
 
       - name: Setup Nix
         uses: ./.github/actions/setup-nix
diff --git a/flake.nix b/flake.nix
index 6f87dd1..509a98f 100644
--- a/flake.nix
+++ b/flake.nix
@@ -108,6 +108,12 @@
             shellHook = ''
               echo "StackOne AI Python SDK development environment"
 
+              # Initialize git submodules if not already done
+              if [ -f .gitmodules ] && [ ! -f vendor/stackone-ai-node/package.json ]; then
+                echo "📦 Initializing git submodules..."
+                git submodule update --init --recursive
+              fi
+
               # Install Python dependencies only if .venv is missing or uv.lock is newer
               if [ ! -d .venv ] || [ uv.lock -nt .venv ]; then
                 echo "📦 Installing Python dependencies..."