globalaiplatform · dittos · Sep 4, 2025 · Sep 2, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -13,6 +13,9 @@ jobs:
       fail-fast: false
       matrix:
         python-version: ["3.11", "3.12"]
+    defaults:
+      run:
+        working-directory: ./py
 
     steps:
     - uses: actions/checkout@v4

diff --git a/.python-version b/.python-version
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -17,8 +17,9 @@ build:
       create_environment:
          - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
       install:
+         - cd py
          - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --group docs
 
 # Build documentation with Mkdocs
 mkdocs:
-  configuration: mkdocs.yml
+  configuration: py/mkdocs.yml
diff --git a/README.md b/README.md
@@ -8,7 +8,7 @@
 
 LangDiff is a Python library that solves the hard problems of streaming structured LLM outputs to frontends.
 
-![Diagram](./docs/diagram.png)
+![Diagram](/docs/diagram.png)
 
 LangDiff provides intelligent partial parsing with granular, type-safe events as JSON structures build token by token, plus automatic JSON Patch generation for efficient frontend synchronization. Build responsive AI applications where your backend structures and frontend experiences can evolve independently. Read more about it on the [Motivation](#motivation) section.
 
@@ -112,7 +112,7 @@ Suppose you want to generate a multi-section article with an LLM. Rather than wa
 you can stream the article progressively by first generating section titles as they're determined, 
 then streaming each section's content as it's written.
 
-![Demo Video](./docs/demo.gif)
+![Demo Video](/docs/demo.gif)
 
 Start by defining model classes that specify your streaming structure:
 
@@ -265,8 +265,8 @@ LangDiff enables you to build responsive, maintainable AI applications where the
 
 ## License
 
-Apache-2.0. See the [LICENSE](./LICENSE) file for details.
+Apache-2.0. See the [LICENSE](/LICENSE) file for details.
 
 ## Demo
 
-See [`example.py`](./example.py) for a runnable end-to-end demo using streaming parsing and diff tracking.
+See [`py/example.py`](/py/example.py) for a runnable end-to-end demo using streaming parsing and diff tracking.
diff --git a/.gitignore → py/.gitignore b/.gitignore → py/.gitignore
diff --git a/py/README.md b/py/README.md
@@ -0,0 +1 @@
+../README.md
diff --git a/docs/api/overview.md → py/docs/api/overview.md b/docs/api/overview.md → py/docs/api/overview.md
diff --git a/docs/api/parser.md → py/docs/api/parser.md b/docs/api/parser.md → py/docs/api/parser.md
diff --git a/docs/api/tracker.md → py/docs/api/tracker.md b/docs/api/tracker.md → py/docs/api/tracker.md
diff --git a/py/docs/diagram.png b/py/docs/diagram.png
diff --git a/docs/index.md → py/docs/index.md b/docs/index.md → py/docs/index.md
diff --git a/example.py → py/example.py b/example.py → py/example.py
diff --git a/mkdocs.yml → py/mkdocs.yml b/mkdocs.yml → py/mkdocs.yml
diff --git a/pyproject.toml → py/pyproject.toml b/pyproject.toml → py/pyproject.toml
diff --git a/src/langdiff/__init__.py → py/src/langdiff/__init__.py b/src/langdiff/__init__.py → py/src/langdiff/__init__.py
diff --git a/src/langdiff/parser/__init__.py → py/src/langdiff/parser/__init__.py b/src/langdiff/parser/__init__.py → py/src/langdiff/parser/__init__.py
diff --git a/src/langdiff/parser/decoder.py → py/src/langdiff/parser/decoder.py b/src/langdiff/parser/decoder.py → py/src/langdiff/parser/decoder.py
diff --git a/src/langdiff/parser/model.py → py/src/langdiff/parser/model.py b/src/langdiff/parser/model.py → py/src/langdiff/parser/model.py
diff --git a/src/langdiff/parser/parser.py → py/src/langdiff/parser/parser.py b/src/langdiff/parser/parser.py → py/src/langdiff/parser/parser.py
diff --git a/src/langdiff/py.typed → py/src/langdiff/py.typed b/src/langdiff/py.typed → py/src/langdiff/py.typed
diff --git a/src/langdiff/tracker/__init__.py → py/src/langdiff/tracker/__init__.py b/src/langdiff/tracker/__init__.py → py/src/langdiff/tracker/__init__.py
diff --git a/src/langdiff/tracker/change_tracker.py → py/src/langdiff/tracker/change_tracker.py b/src/langdiff/tracker/change_tracker.py → py/src/langdiff/tracker/change_tracker.py
diff --git a/src/langdiff/tracker/changes.py → py/src/langdiff/tracker/changes.py b/src/langdiff/tracker/changes.py → py/src/langdiff/tracker/changes.py
diff --git a/src/langdiff/tracker/impl.py → py/src/langdiff/tracker/impl.py b/src/langdiff/tracker/impl.py → py/src/langdiff/tracker/impl.py
diff --git a/tests/test_change_tracker.py → py/tests/test_change_tracker.py b/tests/test_change_tracker.py → py/tests/test_change_tracker.py
diff --git a/tests/test_parser.py → py/tests/test_parser.py b/tests/test_parser.py → py/tests/test_parser.py
diff --git a/tests/test_partial_json.py → py/tests/test_partial_json.py b/tests/test_partial_json.py → py/tests/test_partial_json.py
diff --git a/uv.lock → py/uv.lock b/uv.lock → py/uv.lock