docs(README): explain about Wokwi and the library

also add link to the API docs

Author: urish

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.0.3 - 2025-07-01
+
+- feat: add MicroPython + ESP32 example
+- docs: explain about Wokwi and the library
+
 ## 0.0.2 - 2025-06-30
 
 - chore: updated list of classifiers in `pyproject.toml`

README.md

@@ -11,11 +11,19 @@ Typed, asyncio-friendly Python SDK for the **Wokwi Simulation API**
 
 ---
 
+Wokwi is a platform for creating and running simulations of electronic circuits and embedded systems. It supports a wide range of hardware platforms, including ESP32 family, Arduino, Raspberry Pi, STM32 and more.In addition, it supports a [wide range of peripherals](https://docs.wokwi.com/getting-started/supported-hardware), including sensors, displays, motors, and debugging tools.
+
+Wokwi Python Client is a Python SDK for the Wokwi Simulation API. It allows you to run and control your Wokwi simulations from Python in a typed, asyncio-friendly way. You can use it to automate your embedded testing and development workflows.
+
 ## Installation requirements
 
-Python ≥ 3.9
+- Python ≥ 3.9
+- An API token from [https://wokwi.com/dashboard/ci](https://wokwi.com/dashboard/ci).
 
-An API token from [https://wokwi.com/dashboard/ci](https://wokwi.com/dashboard/ci).
+Install the library with:
+```bash
+pip install wokwi-client
+```
 
 ## Running the examples
 
@@ -33,6 +41,12 @@ pip install -e .[dev]
 python -m examples.hello_esp32.main
 ```
 
+For more examples, see the [examples](examples) directory.
+
+## Documentation
+
+The API documentation is available at [https://wokwi.github.io/wokwi-python-client/](https://wokwi.github.io/wokwi-python-client/).
+
 ## License
 
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.