Files
ChatBot/docs/quickstart.md
Leonid Pershin e5e69470f8
All checks were successful
SonarQube / Build and analyze (push) Successful in 3m22s
add docs
2025-10-21 05:08:40 +03:00

3.7 KiB
Raw Blame History

🚀 Быстрый старт

Запустите ChatBot за 5 минут!

Минимальные требования

📋 Шаги установки

1 Клонирование репозитория

git clone https://github.com/mrleo1nid/ChatBot.git
cd ChatBot

2 Установка Ollama и модели

# Установите Ollama с официального сайта
# https://ollama.ai/

# Загрузите модель (например, gemma2)
ollama pull gemma2:2b

3 Настройка PostgreSQL

# Создайте базу данных
psql -U postgres
CREATE DATABASE chatbot;
\q

4 Создание .env файла

Создайте файл .env в папке ChatBot/:

# 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 Запуск приложения

# Восстановление зависимостей
dotnet restore

# Применение миграций (автоматически при первом запуске)
# или вручную:
dotnet ef database update --project ChatBot

# Запуск
dotnet run --project ChatBot

🎉 Готово!

Теперь откройте Telegram и найдите вашего бота. Отправьте /start для начала общения.

📱 Первые команды

/start   - Начать работу с ботом
/help    - Показать все команды
/clear   - Очистить историю диалога
/settings - Текущие настройки
/status  - Статус бота

🐳 Альтернатива: Docker

# Сборка образа
docker build -t chatbot .

# Запуск с docker-compose
docker-compose up -d

🔧 Проверка работы

Проверка Ollama

curl http://localhost:11434/api/tags

Проверка PostgreSQL

psql -U postgres -d chatbot -c "SELECT * FROM chat_sessions;"

Просмотр логов

Логи находятся в папке ChatBot/logs/:

tail -f ChatBot/logs/telegram-bot-*.log

Проблемы?

Ollama недоступен

# Проверьте статус
systemctl status ollama  # Linux
# или запустите вручную
ollama serve

Ошибка подключения к БД

# Проверьте PostgreSQL
pg_isready -h localhost -p 5432

Неверный токен бота

  • Получите новый токен через @BotFather
  • Обновите TELEGRAM_BOT_TOKEN в .env

📚 Следующие шаги

💡 Полезные ссылки