Elysia(MyElysia)Telegramボット

AI/ML

概要

Elysia Telegram Botは、Honkai Impact 3rdのキャラクター「Elysia」に着想を得た会話型AIボットです。Claude系モデル(OpenRouter経由)を利用した自然言語応答と、クラス(授業)スケジュールの登録・管理機能を備えています。実装はPython(python-telegram-bot)で、モジュール化された構成により機能拡張が容易。Dockerやdocker-composeファイルが同梱されており、環境変数でトークンやAPIキーを設定するだけでコンテナ化された状態で起動できます。小規模な実験や学習用途に適したシンプルかつ実用的なリポジトリです。

GitHub

リポジトリの統計情報

  • スター数: 1
  • フォーク数: 0
  • ウォッチャー数: 1
  • コミット数: 2
  • ファイル数: 6
  • メインの言語: Python

主な特徴

  • Claude系(OpenRouter経由)AIとの統合による自然言語応答
  • 授業(クラス)スケジュールの登録・表示などの管理機能
  • Docker / docker-compose によるコンテナ起動サポート
  • python-telegram-botでのモジュール化されたハンドラ構成

技術的なポイント

このプロジェクトは比較的シンプルな構成ながら、実用的なボット開発に必要な要素が揃っています。メッセージ処理はpython-telegram-botライブラリのハンドラを利用しており、コマンド(例: /start やスケジュール関連)ごとに処理を分離する設計になっています。AI応答部分はOpenRouter APIを通じてClaude系モデルにリクエストを送り、受け取った生成テキストをユーザーに返すフローです。プロジェクトは環境変数でTelegram Bot TokenやOpenRouterのAPIキーを受け取り、Dockerfileとdocker-compose.ymlにより環境依存のセットアップを簡素化しています。

データ保存は小規模用途を想定しており、シンプルなファイルベースやメモリ上の管理で済む設計になっている可能性が高く、永続性やスケールを求める場合はSQLite/Postgresなどの追加が必要です。エラーハンドリング、APIレート制限対応、並列処理(Long polling か Webhook)の選択肢も実装次第で拡張できます。コードはモジュール化されているため、会話プロンプトの調整やキャラクター性(ペルソナ)の改良、外部機能(カレンダー連携やDB保存等)の追加がしやすい点も特徴です。セキュリティ面ではAPIキーやトークンを環境変数に置く基本形を取っているため、Gitに直接含めない運用が前提になります。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • Dockerfile: file
  • README.md: file
  • docker-compose.yml: file
  • requirements.txt: file

…他 1 ファイル

まとめ

小規模なAIチャットボット開発の入門とプロトタイプに最適です。

リポジトリ情報:

READMEの抜粋:

🌸 Elysia Telegram Bot 🌸

An enchanting AI companion inspired by Elysia from Honkai Impact 3rd

Python Telegram Bot API Docker License

[Featu…