1 files changed, 40 insertions, 0 deletions
diff --git a/packages/python/README.md b/packages/python/README.md
new file mode 100644
index 0000000..4eb329e
--- /dev/null
+++ b/packages/python/README.md
@@ -0,0 +1,40 @@
+# Language Server Protocol Types implementation for Python
+
+`lsprotocol` is a python implementation of object types used in the Language Server Protocol (LSP). This repository contains the code generator and the generated types for LSP.
+
+## Overview
+
+LSP is used by editors to communicate with various tools to enables services like code completion, documentation on hover, formatting, code analysis, etc. The intent of this library is to allow you to build on top of the types used by LSP. This repository will be kept up to date with the latest version of LSP as it is updated.
+
+## Installation
+
+`python -m pip install lsprotocol`
+
+## Usage
+
+### Using LSP types
+
+```python
+from lsprotocol import types
+
+position = types.Position(line=10, character=3)
+```
+
+### Using built-in type converters
+
+```python
+# test.py
+import json
+from lsprotocol import converters, types
+
+position = types.Position(line=10, character=3)
+converter = converters.get_converter()
+print(json.dumps(converter.unstructure(position, unstructure_as=types.Position)))
+```
+
+Output:
+
+```console
+> python test.py
+{"line": 10, "character": 3}
+```