diff --git a/japan-geoid-py/README.md b/japan-geoid-py/README.md
new file mode 100644
index 0000000..6e2ea72
--- /dev/null
+++ b/japan-geoid-py/README.md
@@ -0,0 +1,102 @@
+# japan-geoid
+
+[![Test](https://github.com/MIERUNE/japan-geoid/actions/workflows/test.yml/badge.svg)](https://github.com/MIERUNE/japan-geoid/actions/workflows/test.yml)
+[![Maturin](https://github.com/MIERUNE/japan-geoid/actions/workflows/maturin.yml/badge.svg)](https://github.com/MIERUNE/japan-geoid/actions/workflows/maturin.yml)
+[![codecov](https://codecov.io/gh/MIERUNE/japan-geoid/graph/badge.svg?token=c9T2ayChfw)](https://codecov.io/gh/MIERUNE/japan-geoid)
+![Crates.io Version](https://img.shields.io/crates/v/japan-geoid)
+![PyPI - Version](https://img.shields.io/pypi/v/japan-geoid)
+![NPM Version](https://img.shields.io/npm/v/japan-geoid)
+
+A Rust, Python and JavaScript (WASM) library for calculating geoid heights for Japan using [GSI's geoid model](https://fgd.gsi.go.jp/download/geoid.php). This library contains geoid data based on `gsigeo2011_ver2_2.asc`, created with permission: 「測量法に基づく国土地理院長承認（使用）R 5JHs 560」.
+
+Rust および Python で日本のジオイド高を計算するためライブラリです。国土地理院のジオイドモデル「[日本のジオイド2011](https://fgd.gsi.go.jp/download/geoid.php)」を用いて、国土地理院による C++ のサンプルコードに準拠した補間計算を行います。本ライブラリは、日本のジオイド2011 v.2.2 (`gsigeo2011_ver2_2.asc`) を元にしたジオイドデータを含んでいます（測量法に基づく国土地理院長承認（使用）R 5JHs 560）。
+
+License: MIT
+
+本ライブラリは、国土地理院が提供するものではありません。
+
+## Python
+
+### Installation
+
+```
+pip install japan-geoid -U
+```
+
+### Usage
+
+```python
+from japan_geoid import load_embedded_gsigeo2011
+
+geoid = load_embedded_gsigeo2011()
+
+(lng, lat) = (138.2839817085188, 37.12378643088312)
+height = geoid.get_height(lng, lat)
+print(f"{lng=} {lat=} {height=}")
+
+# Returns NaN if the input is outside the domain.
+geoid.get_height(10.0, 10.0)) # => nan
+```
+
+## Rust
+
+### Installation
+
+```
+cargo add japan-geoid
+```
+
+### Usage
+
+```rust
+use japan_geoid::gsi::load_embedded_gsigeo2011;
+use japan_geoid::Geoid;
+
+fn main() {
+    // Load the embedded GSIGEO2011 model.
+    let geoid = load_embedded_gsigeo2011();
+
+    // Calculate the geoid height.
+    let (lng, lat) = (138.2839817085188, 37.12378643088312);
+    let height = geoid.get_height(lng, lat);
+    println!("Input: (lng: {lng}, lat: {lat}) -> Geoid height: {height}");
+
+    // Returns NaN if the input is outside the domain.
+    assert!(f64::is_nan(geoid.get_height(10.0, 10.0)))
+}
+```
+
+## JavaScript (WASM)
+
+### Installation
+
+```
+npm add japan-geoid
+```
+
+### Usage
+
+```javascript
+import { load_embedded_gsigeo2011 } from 'japan-geoid';
+
+const geoid = load_embedded_gsigeo2011();
+
+geoid.get_height(138.2839817085188, 37.12378643088312); // => 39.47387115961899
+
+geoid.get_heights(
+  [138.2839817085188, 141.36199967724426],
+  [37.12378643088312, 43.06539278249951]
+); // => Float64Array(2) [ 39.47387115961899, 31.90071200378531 ]
+```
+
+
+## License
+
+MIT License
+
+測量法に基づく国土地理院長承認（使用）R 5JHs 560
+
+## Authors
+
+- Taku Fukada
+- [MIERUNE Inc.](https://www.mierune.co.jp/)
diff --git a/japan-geoid-py/pyproject.toml b/japan-geoid-py/pyproject.toml
index 69b8fb2..260ede9 100644
--- a/japan-geoid-py/pyproject.toml
+++ b/japan-geoid-py/pyproject.toml
@@ -5,7 +5,7 @@ build-backend = "maturin"
 [project]
 name = "japan-geoid"
 description = "Calculate geoid heights for Japan using GSI's geoid model."
-readme = "../README.md"
+readme = "README.md"
 authors = [
   { name = "Taku Fukada", email = "naninunenor@gmail.com" },
   { name = "MIERUNE Inc.", email = "info@mierune.co.jp" },