TelegramBot OpenAI API
1.0.0
holidaysモジュールによる休日通知@BotFatherボットを使用してボットをセットアップし、そのための Telegram Bot API トークンを取得します3.10.12 ～ 3.12.2でテスト済み、動作中pip install -r requirements.txtを使用して必要な Python パッケージをインストールします (requirements.txt にリストされているバージョンでテストされ、動作します)pydubでは通常、 ffmpeg個別にインストールする必要があります。音声メッセージ/WhisperAPI 機能を利用していない場合、 pydubもffmpeg実際には必要ありませんが、利用している場合は、インストールすることをお勧めします (Debian/Ubuntu Linux): sudo apt-get install ffmpeglynxがインストールされている必要があります。サブプロセスとして実行する必要があります。 (Debian/Ubuntu Linux にインストールするには: sudo apt-get install lynx )git clone https://github.com/FlyingFathead/TelegramBot-OpenAI-API/ &&
cd TelegramBot-OpenAI-API/pip install -r requirements.txtsudo apt-get install -y ffmpeg lynxTELEGRAM_BOT_TOKEN環境変数として設定するか、 config/ディレクトリ内のbot_token.txtという名前のテキスト ファイル (= config/bot_token.txt ) に配置します。OPENAI_API_KEY環境変数として、またはメイン プログラム ディレクトリ内のapi_token.txtという名前のテキスト ファイルに配置します。OPENWEATHERMAP_API_KEYとMAPTILER_API_KEY環境変数を設定します。 API キーは OpenWeather と MapTiler から取得できます。WEATHERAPI_KEY環境変数を設定します。OPENROUTESERVICE_API_KEY環境変数を設定します。PERPLEXITY_API_KEYに設定します。config/config.ini好みに合わせて編集して、構成と設定を調整します。python src/main.pyでプログラムを実行します。Docker がマシンにインストールされている必要があります。
Telegram Bot API キーとOpenAI API キー:
まず、GitHub からリポジトリのクローンを作成します。
git clone https://github.com/FlyingFathead/TelegramBot-OpenAI-API.git
cd TelegramBot-OpenAI-APIこのプロジェクトには、API キーの入力と.envファイルの生成をガイドするセットアップ スクリプトが含まれています。
スクリプトを実行します。
./docker_setup.shスクリプトによって提供される指示に従います。 OpenAI API キーと Telegram Bot API キーを要求し、それらを検証して、資格情報を含む.envファイルを作成します。
.envファイルが作成されたら、Docker イメージをビルドする必要があります。
注目のdocker_deploy.shを実行して、Docker イメージを構築できます。
sudo ./docker_deploy.shまたは、手動でビルドすることもできます。
sudo docker build -t telegrambot-openai-api .これにより、リポジトリ内のDockerfileに基づいてイメージがローカルに構築されます。
イメージが正常に構築されたら、Docker コンテナーでボットを起動できます。
次のコマンドを使用してコンテナを実行します。
sudo docker run --env-file .env --name telegrambot-openai-api -d telegrambot-openai-api-dフラグは、コンテナーをデタッチ モード (バックグラウンド) で実行します。--env-file .envフラグは、API キーをコンテナーに挿入します。以下を使用して、コンテナーが実行されているかどうかを確認できます。
sudo docker psこれにより、実行中のすべてのコンテナが一覧表示されます。ボットが正しく実行されている場合は、リストに表示されるはずです。
ボットを停止する必要がある場合は、次のコマンドを実行して停止できます。
sudo docker stop < container_id > <container_id> 、 docker ps出力から取得できる実際のコンテナ ID に置き換えます。
ログ: 問題のトラブルシューティングを行うためにボットのログを表示する必要がある場合は、以下を使用できます。
sudo docker logs < container_id >コンテナを再起動する: コンテナを停止し、再度起動したい場合は、 docker runコマンドを再度実行するか、次のコマンドを使用して既存のコンテナを再起動します。
sudo docker start < container_id >リポジトリが更新を受信し、それを適用する場合は、次の手順に従います。
GitHub から最新の変更を取得します。
git pull origin mainDocker イメージを再構築します。
sudo docker build -t telegrambot-openai-api .現在実行中のコンテナを停止します。
sudo docker stop < container_id >更新されたイメージを使用して新しいコンテナを開始します。
sudo docker run --env-file .env --name telegrambot-openai-api -d telegrambot-openai-api再構築とデプロイの手間を軽減することを目的としたdocker_deploy.shスクリプトも含まれています。
これで、TelegramBot-OpenAI-API が Docker コンテナ内で実行され、Telegram と OpenAI の両方に完全に接続されるようになりました。ボットをお楽しみください!
問題が発生した場合は、ログを参照するか、リポジトリの問題ページに問い合わせてください。
config.ini更新するconfigmerger.py使用して、古い構成ファイルを新しいバージョンのconfig.iniに更新します。これを行うには、既存の構成のコピーをmyconfig.txtという名前のファイルに保存し、その中に新しいバージョン用に保持したい行を含めます。
その後、ie python src/configmerger.py myconfig.txt実行するだけで、既存のすべての設定行が新しい設定行に移行されます。ほとんどの場合は機能しますが、 ie diffを使用して移行の問題が発生した場合は注意して再確認することを忘れないでください。
(例) 既存の構成をマージおよび更新する方法:
python3 src/configmerger.py myconfig.txtcalc_module.pyでキャッチされるその他のエラーconfig.iniのNWSセクションで設定できます。config.ini更新config.iniで US NWS の気象警報をオンのままにすることを強くお勧めします。残念ではなく安全です。docker_setup.shを追加しましたDockerfileと401 Unauthorized受信時のエラー捕捉の改善python src/main.pyconfig.ini経由で設定できるようになりましたsource追加されるようになり、外部データの取得がより明確に記録されるようになりました。config/の下に移動されたテキストファイルとして API キーが処理される可能性config/下にあります。whisper-transcriber-telegram-botからボットトークンを読み取るための新しいロジックをインポートしましたbot_token.py変更および更新されましたconfig_paths.pyは、構成ファイル パス ( config.iniなど) のプロジェクト全体の構成が含まれるようになりました。bot_token.txt (使用されている場合) をconfig/に移動します。configmerger.py使用してカスタム構成で更新しますllama-3.1-sonar-small-128k-online ) に変更されました。EnableAgenticBrowsing = Trueを介してconfig.iniから有効化api_get_duckduckgo_search.py に対する小さな修正。 WIP 後のエージェント リンクmodules.pyのmarkdown_to_html )calc_module.pyが追加されました。rss_parser.pyを参照してください)perplexity_handler.py )yfinance pip パッケージが必要)gpt-3.5-turboの代わりにgpt-4o-miniに切り替えました (より新しく、安価で、優れています)langdetectから OpenAI API に切り替えられました。api_perplexity_search.py のdetect_language関数)langdetectよりもはるかに正確で、モデルの選択でさらに活用できます。api_key.pyモジュールの修正config.iniに追加しましたholidaysモジュールを介した休日の言及 (拡張可能)yt-dlpなど)config.iniでElasticsearchEnabledフラグを使用します (有効または無効にするためにTrueまたはFalseに設定します)langdetectと処理の修正langdetect/usagechart機能が追加されました ( matplotlibが必要)/setsystemmessage <message> (ボットが再起動するまで有効) および/resetsystemmessage ( config.iniからリセット)/resetコマンドが追加されました。それに応じて、 config.iniでResetCommandEnabledフラグとAdminOnlyResetフラグを設定します。text_message_handler.pyに、音声メッセージ処理はvoice_message_handler.pyにconfig.ini => SessionTimeoutMinutes 、 MaxRetainedMessagesを参照)log_messageおよびrotate_log_file (ログ ファイル処理) => modules.pycheck_global_rate_limit => modules.pymodules.py参照してください。token_usage.jsonをクリアする必要があります。ファイル構造は以前のバージョンから変更されています)bot_commands.pyに、 configmerger.pyバージョンを修正configmerger.pyを追加しました (古い構成フラグを新しいバージョンにマージします)config.ini参照してください。config.iniでカスタマイズ可能な/startグリーティング/usageコマンドを追加しました (ボット所有者のみ、 config.iniで無効にする場合は 0)config.ini参照)config.iniを参照してください。utils.pyにモジュール化しました。config.iniの新しいログ オプションを参照してください。escape_markdown別の.pyファイルに移動されましたが、とにかく未使用でしたapi_key.py 、 bot_token.py )config.iniにTimeout値を追加config.iniで設定できるようになりました/help & /about
