diff --git a/README.md b/README.md
index b8e32a9..4702073 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,26 @@
 # MyPkg - Менеджер пакетов для Linux
 
-Курсовая работа.
\ No newline at end of file
+## Описание
+
+**MyPkg** — это консольный менеджер пакетов для Linux, разработанный в рамках курсовой работы. Он позволяет устанавливать, удалять, искать пакеты и автоматически разрешать зависимости.
+
+## Возможности
+
+- ✅ Установка пакетов с автоматическим разрешением зависимостей
+- ✅ Удаление пакетов
+- ✅ Просмотр списка установленных пакетов
+- ✅ Информация о пакете (версия, зависимости, файлы)
+- ✅ Поиск пакетов в репозитории
+- ✅ Режим песочницы (`--sandbox`) — безопасная установка
+- ✅ Режим dry-run (`--dry-run`) — предварительный просмотр
+- ✅ Цветной вывод с эмодзи
+
+## Установка
+
+```bash
+# Клонирование репозитория
+git clone https://iux-gitea.myddns.me/24_ChernovaSS/mypkg.git
+cd mypkg
+
+# Установка (рекомендуется в режиме разработки)
+pip3 install --user -e .
\ No newline at end of file