From a4f4442832b608ecee3ac797c8f9ef91993ebdfa Mon Sep 17 00:00:00 2001
From: Evgeny Zinoviev <me@ch1p.io>
Date: Tue, 16 Feb 2021 13:15:59 +0300
Subject: update readme

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/README.md b/README.md
index e69de29..357cc97 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,40 @@
+# acmespb-py
+
+Это self-hosted веб-приложение для поиска по базе acmespb.ru. Результаты
+выводятся на карту.
+
+![](./screenshot.png)
+
+## Установка и запуск
+
+Скачать и перейти в папку:
+
+    $ git clone https://git.ch1p.io/acmespb-py.git
+    $ cd acmespb-py
+
+Создать и активировать venv:
+
+    $ python3 -m venv venv
+    $ . ./venv/bin/activate
+
+Скачать зависимости:
+
+    (venv) $ pip install -r requirements.txt
+
+Запустить: 
+
+    (venv) $ python ./app.py
+
+
+## Возможные проблемы
+
+- acmespb.ru может забанить за частые запросы. Чтобы этого избежать, между запросами
+  делается задержка в 1 секунду (можно отключить в `static/app.js`). Если вас забанили,
+  можно прописать и включить прокси. См. `acmespb.py`.
+  
+- Если вдруг у вас сломались Яндекс.Карты, получите свой ключ API и пропишите
+  его в `templates/index.html` (см. параметр `apikey`).
+
+## Лицензия
+
+BSD-2c
\ No newline at end of file
-- 
cgit v1.2.3