149 lines
3.7 KiB
Markdown
149 lines
3.7 KiB
Markdown
# 🚀 Быстрый старт
|
||
|
||
Запустите ChatBot за 5 минут!
|
||
|
||
## ⚡ Минимальные требования
|
||
|
||
- **.NET 9.0 SDK** ([скачать](https://dotnet.microsoft.com/download/dotnet/9.0))
|
||
- **PostgreSQL 14+** ([скачать](https://www.postgresql.org/download/))
|
||
- **Ollama** с установленной моделью ([установить](https://ollama.ai/))
|
||
- **Telegram Bot Token** ([создать через @BotFather](https://t.me/botfather))
|
||
|
||
## 📋 Шаги установки
|
||
|
||
### 1️⃣ Клонирование репозитория
|
||
|
||
```bash
|
||
git clone https://github.com/mrleo1nid/ChatBot.git
|
||
cd ChatBot
|
||
```
|
||
|
||
### 2️⃣ Установка Ollama и модели
|
||
|
||
```bash
|
||
# Установите Ollama с официального сайта
|
||
# https://ollama.ai/
|
||
|
||
# Загрузите модель (например, gemma2)
|
||
ollama pull gemma2:2b
|
||
```
|
||
|
||
### 3️⃣ Настройка PostgreSQL
|
||
|
||
```bash
|
||
# Создайте базу данных
|
||
psql -U postgres
|
||
CREATE DATABASE chatbot;
|
||
\q
|
||
```
|
||
|
||
### 4️⃣ Создание .env файла
|
||
|
||
Создайте файл `.env` в папке `ChatBot/`:
|
||
|
||
```env
|
||
# Database Configuration
|
||
DB_HOST=localhost
|
||
DB_PORT=5432
|
||
DB_NAME=chatbot
|
||
DB_USER=postgres
|
||
DB_PASSWORD=your_password
|
||
|
||
# Telegram Bot Configuration
|
||
TELEGRAM_BOT_TOKEN=your_bot_token_here
|
||
|
||
# Ollama Configuration
|
||
OLLAMA_URL=http://localhost:11434
|
||
OLLAMA_DEFAULT_MODEL=gemma2:2b
|
||
```
|
||
|
||
### 5️⃣ Запуск приложения
|
||
|
||
```bash
|
||
# Восстановление зависимостей
|
||
dotnet restore
|
||
|
||
# Применение миграций (автоматически при первом запуске)
|
||
# или вручную:
|
||
dotnet ef database update --project ChatBot
|
||
|
||
# Запуск
|
||
dotnet run --project ChatBot
|
||
```
|
||
|
||
## 🎉 Готово!
|
||
|
||
Теперь откройте Telegram и найдите вашего бота. Отправьте `/start` для начала общения.
|
||
|
||
## 📱 Первые команды
|
||
|
||
```
|
||
/start - Начать работу с ботом
|
||
/help - Показать все команды
|
||
/clear - Очистить историю диалога
|
||
/settings - Текущие настройки
|
||
/status - Статус бота
|
||
```
|
||
|
||
## 🐳 Альтернатива: Docker
|
||
|
||
```bash
|
||
# Сборка образа
|
||
docker build -t chatbot .
|
||
|
||
# Запуск с docker-compose
|
||
docker-compose up -d
|
||
```
|
||
|
||
## 🔧 Проверка работы
|
||
|
||
### Проверка Ollama
|
||
```bash
|
||
curl http://localhost:11434/api/tags
|
||
```
|
||
|
||
### Проверка PostgreSQL
|
||
```bash
|
||
psql -U postgres -d chatbot -c "SELECT * FROM chat_sessions;"
|
||
```
|
||
|
||
### Просмотр логов
|
||
Логи находятся в папке `ChatBot/logs/`:
|
||
```bash
|
||
tail -f ChatBot/logs/telegram-bot-*.log
|
||
```
|
||
|
||
## ❓ Проблемы?
|
||
|
||
### Ollama недоступен
|
||
```bash
|
||
# Проверьте статус
|
||
systemctl status ollama # Linux
|
||
# или запустите вручную
|
||
ollama serve
|
||
```
|
||
|
||
### Ошибка подключения к БД
|
||
```bash
|
||
# Проверьте PostgreSQL
|
||
pg_isready -h localhost -p 5432
|
||
```
|
||
|
||
### Неверный токен бота
|
||
- Получите новый токен через [@BotFather](https://t.me/botfather)
|
||
- Обновите `TELEGRAM_BOT_TOKEN` в `.env`
|
||
|
||
## 📚 Следующие шаги
|
||
|
||
- [Полная установка и настройка](./installation.md)
|
||
- [Конфигурация](./configuration.md)
|
||
- [Архитектура проекта](./architecture/overview.md)
|
||
- [Разработка](./development/project-structure.md)
|
||
|
||
## 💡 Полезные ссылки
|
||
|
||
- [Ollama Models](https://ollama.ai/library)
|
||
- [Telegram Bot API](https://core.telegram.org/bots/api)
|
||
- [PostgreSQL Documentation](https://www.postgresql.org/docs/)
|
||
- [.NET Documentation](https://docs.microsoft.com/dotnet/)
|