התקנה והגדרה

דף זה מכיל הוראות התקנה מפורטות עבור Code Keeper Bot.

דרישות מערכת

דרישות תוכנה:

  • Python 3.9 או גרסה חדשה יותר

  • MongoDB 4.4 או גרסה חדשה יותר

  • Redis 6.0+ (אופציונלי, לקאש)

  • Git

דרישות חומרה מינימליות:

  • RAM: 512MB

  • דיסק: 1GB פנוי

  • מעבד: 1 Core

התקנה מהירה

1. שכפל את הריפוזיטורי

git clone https://github.com/your-repo/code-keeper-bot.git
cd code-keeper-bot

2. התקן תלויות

pip install -r requirements.txt

3. הגדר משתני סביבה

צור קובץ .env עם ההגדרות הבאות:

# Telegram Bot Token
BOT_TOKEN=your_bot_token_here

# MongoDB Connection
MONGODB_URL=mongodb://localhost:27017/code_keeper

# GitHub Integration (אופציונלי)
GITHUB_TOKEN=your_github_token

# Redis Cache (אופציונלי)
REDIS_URL=redis://localhost:6379

4. הפעל את הבוט

python main.py

התקנה עם Docker

1. בנה את ה-Image

docker build -t code-keeper-bot .

2. הפעל עם Docker Compose

docker-compose up -d

הגדרת MongoDB

התקנת MongoDB:

# Ubuntu/Debian
sudo apt-get install mongodb

# macOS
brew install mongodb-community

יצירת אינדקסים:

הבוט יוצר אינדקסים אוטומטית בהפעלה הראשונה.

הגדרת Telegram Bot

  1. צור בוט חדש דרך @BotFather

  2. קבל את ה-Token

  3. הגדר את הפקודות:

/start - התחל שיחה עם הבוט
/save - שמור קוד חדש
/list - הצג רשימת קבצים
/search - חפש בקבצים
/stats - הצג סטטיסטיקות
/help - עזרה

הגדרות מתקדמות

הגדרת הצפנה:

# בקובץ config.py
ENCRYPTION_KEY = os.getenv('ENCRYPTION_KEY')
ENABLE_ENCRYPTION = True

הגדרת גיבויים אוטומטיים:

# בקובץ config.py
BACKUP_ENABLED = True
BACKUP_INTERVAL = 3600  # בשניות
BACKUP_PATH = '/path/to/backups'

הגדרת Rate Limiting:

# בקובץ config.py
RATE_LIMIT_ENABLED = True
MAX_REQUESTS_PER_MINUTE = 30

בדיקת התקנה

לאחר ההתקנה, ודא שהכל עובד:

# בדוק חיבור למונגו
python -c "from database import db; print(db.test_connection())"

# בדוק את הבוט
python test_basic.py

פתרון בעיות

הבוט לא מתחבר לטלגרם:

  • ודא שה-Token נכון

  • בדוק חיבור לאינטרנט

  • ודא שאין חומת אש חוסמת

MongoDB לא זמין:

  • ודא שהשירות פועל: sudo systemctl status mongodb

  • בדוק את ה-URL בקובץ .env

שגיאות בהתקנת תלויות:

# נסה עם pip מעודכן
pip install --upgrade pip
pip install -r requirements.txt

תמיכה

לתמיכה נוספת:

  • פתח Issue ב-GitHub

  • שלח הודעה בקבוצת התמיכה

  • עיין בתיעוד המלא