diff --git a/README.md b/README.md
new file mode 100644
index 0000000..dedefec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Tarantool temporal
+[![License](https://poser.pugx.org/tarantool/temporal/license.png)](https://packagist.org/packages/tarantool/temporal)
+[![Testing](https://github.com/tarantool-php/temporal/actions/workflows/tests.yml/badge.svg)](https://github.com/tarantool-php/temporal/actions/workflows/tests.yml)
+[![Latest Version](https://img.shields.io/github/release/tarantool-php/temporal.svg?style=flat-square)](https://github.com/tarantool-php/temporal/releases)
+[![Total Downloads](https://img.shields.io/packagist/dt/tarantool/temporal.svg?style=flat-square)](https://packagist.org/packages/tarantool/temporal)
+[![Telegram](https://img.shields.io/badge/Telegram-join%20chat-blue.svg)](https://t.me/tarantool_php)
+
+## Getting started
+Supported versions are php 8.1+ and tarantool 2+.\
+The recommended way to install the library is through [Composer](http://getcomposer.org):
+```bash
+composer require tarantool/temporal
+```
+
+See tests folder for usage examples.