diff --git a/README.md b/README.md
index f12e3cd..0e1d14f 100644
--- a/README.md
+++ b/README.md
@@ -206,7 +206,7 @@ See [docs.rs/vtracer](https://docs.rs/vtracer/1.0.0-alpha.2/vtracer/) for the fu
 [`vtracer`](https://pypi.org/project/vtracer/) is also packaged as a Python native extension.
 
 ```sh
-pip install --pre vtracer
+pip install vtracer==1.0.0a2
 ```
 
 ```python
diff --git a/crates/vtracer-py/Cargo.toml b/crates/vtracer-py/Cargo.toml
index 2f014d6..44129bf 100644
--- a/crates/vtracer-py/Cargo.toml
+++ b/crates/vtracer-py/Cargo.toml
@@ -5,6 +5,7 @@ version = "1.0.0-alpha.2"
 authors = ["Chris Tsang <tyt2y7@gmail.com>"]
 edition = "2024"
 license = "MIT OR Apache-2.0"
+readme = "README.md"
 homepage = "http://www.visioncortex.org/vtracer"
 repository = "https://github.com/visioncortex/vtracer/"
 
diff --git a/crates/vtracer-py/README.md b/crates/vtracer-py/README.md
index 49adf29..d7bb737 100644
--- a/crates/vtracer-py/README.md
+++ b/crates/vtracer-py/README.md
@@ -8,7 +8,7 @@ this crate adds image decoding and a Pythonic API.
 ## Install
 
 ```sh
-pip install vtracer
+pip install vtracer==1.0.0a2
 ```
 
 ## Usage
diff --git a/crates/vtracer-py/pyproject.toml b/crates/vtracer-py/pyproject.toml
index fa9eb30..3d954f5 100644
--- a/crates/vtracer-py/pyproject.toml
+++ b/crates/vtracer-py/pyproject.toml
@@ -5,6 +5,7 @@ build-backend = "maturin"
 [project]
 name = "vtracer"
 description = "Raster to vector graphics converter — Python bindings for the vtracer framework."
+readme = "README.md"
 requires-python = ">=3.8"
 license = { text = "MIT OR Apache-2.0" }
 authors = [{ name = "Chris Tsang", email = "tyt2y7@gmail.com" }]