diff --git a/.gitignore b/.gitignore
index 633e675f..651f3957 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,6 @@
+# JetBrains IDE
+.idea/
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..ab38eb89
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+[![Join the chat at https://gitter.im/griganton/telepy](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/griganton/telepy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+# About this repo
+This is Telegram API for python. 
+Main aim is to implement MTProto protocol Telegram API on pure Python (not wrapped CLI)
+
+### Future plan
+- [ ] We'll try to make it work on Python 2 as well as 3.
+- [ ] Follow up the same functionality of CLI API.
+  - [ ] Serialize/Deserialize
+  - [ ] Send and receive PQ authorization with server  [doc] (https://core.telegram.org/mtproto/samples-auth_key)
+  - [ ] Send and receive service messages with server like logging in to server [doc] (https://core.telegram.org/mtproto/service_messages)
+
+### Useful start points to join
+Detailed description of API and protocol can be found here:
+* https://core.telegram.org/api
+* https://core.telegram.org/mtproto
+
+API registration is needed to be done by yourself at http://my.telegram.org
+Follow Structure - Credentials for provide it your API information.
+
+# Structure
+
+- mtproto.py 
+- testing.py
+- prime.py
+- credentials
+- rsa.pub
+
+## Credentials
+Repo doesn't contain any credentials to connect Telegram servers.
+You can get yours from http://my.telegram.org
+
+You should place 2 files in the root of your repo:
+- credentials
+- rsa.pub
+
+Config example for "credentials" file:
+
+```
+[App data]
+api_id: 12345
+api_hash: 1234567890abcdef1234567890abcdef
+ip_address: 112.134.156.178
+port: 443
+```
+rsa.pub contains your RSA key.
+
+## mtproto.py
+
+Contains functions to work with MTproto protocol:
+- TL schema parsing
+- serializing and deserializing
+- manage connections to server
+- send and receive messages
+
+## testing.py
+
+testing.py is used to test functionality of modules.
+Now it makes steps from https://core.telegram.org/mtproto/samples-auth_key:
+- sends PQ request to server
+- parses the result
+- factorizes PQ
+
+## prime.py
+prime.py is used in PQ factorization. It has been copied from https://stackoverflow.com/questions/4643647/fast-prime-factorization-module
+
+## TL schema
+We use JSON format TL Shema. TL Schema file contains information about objects and methods, it is located in TL_schema.JSON file in the root of repo. It is fully equivalent to JSON TL Schema from
+https://core.telegram.org/schema/mtproto-json