Repolode
nalgeon

nalgeon/pokitoki

OpenAI、Claude、Gemini、またはOpenAI互換モデルを使って質問に答える、セルフホスト型のTelegramチャットボット。

スター
340
フォーク
60
未解決の Issue
0
最終コミット
15 日前

これは何?

Humble AI Telegram BotはTelegram上で動作するチャットアシスタントです。質問をOpenAI、Claude、Geminiや、OpenRouterなどのOpenAI互換プロバイダーが提供する大規模言語モデルに転送します。1対1のチャットとグループの両方で使え、グループでは直接メンションされたときや、質問への返信として投稿されたときに応答します。

設定可能なタイムアウト時間のあいだ会話のコンテキストを保持し、チャットごとにカスタムプロンプトやモデルを設定できます。管理者は/configコマンドを使って、大半の設定をその場で変更できます。校正、翻訳、要約などの組み込みショートカットで、文章やコードに関するよくある作業をこなせるほか、設定ファイルに独自のショートカットを追加することもできます。

OpenAI、Claude、Geminiのプロバイダーでは、サーバーサイドツールを使ってモデルがWebを検索したり、リンクを開いたりできます。それ以外の構成では、リンク先のテキストコンテンツを取得してモデルに渡します。グループではユーザーごとにメッセージ数の上限を設定してAPI利用料を管理でき、Docker Composeでデプロイできます。

主な機能

  • 01個人チャットとグループで動作し、質問や直接のメンションに応答します。
  • 02OpenAI、Claude、Gemini、およびあらゆるOpenAI互換プロバイダーに対応しています。
  • 03会話のコンテキストを保持し、設定したタイムアウト時間内であれば追加の質問にも続けて回答します。
  • 04チャットごとに異なるプロンプトとモデルを設定できます。
  • 05校正、翻訳、要約などのショートカットを備え、独自のショートカットも追加できます。
  • 06/configコマンドで、実行中に大半の設定を変更できます。

ユースケース

  • Telegram上で、自分専用または少人数の友人グループ向けのプライベートなAIアシスタントを運用する。
  • 利用上限を設けたうえで、チーム共用のAIアシスタントをTelegramグループに導入する。
  • チャット上で文章を直接校正、翻訳、要約する。
  • Telegram内でテキストファイルやリンク先のWebページについて質問する。

クイックスタート

  1. 1

    BotFatherからAI APIキーとTelegramボットトークンを取得する

  2. 2

    リポジトリをクローンする

    git clone https://github.com/nalgeon/pokitoki.git
  3. 3

    サンプル設定ファイルをconfig.ymlにコピーし、トークンを追加する

    cp config.example.yml config.yml
  4. 4

    Docker Composeでボットを起動する

    docker compose up --build --detach

使う前に知っておきたいこと

  • AIプロバイダーのAPIキーとTelegramボットトークンはご自身で用意する必要があります。また、プロバイダーの利用料金が発生する場合があります。
  • Web検索やリンクツールの使用には、プロバイダーから追加料金が請求される場合があります。
  • このプロジェクトでは、新機能ではなくバグ修正のコントリビューションのみ受け付けています。

収録されている特集

トピック

よくある質問

pokitoki とは?
OpenAI、Claude、Gemini、またはOpenAI互換モデルを使って質問に答える、セルフホスト型のTelegramチャットボット。 Humble AI Telegram BotはTelegram上で動作するチャットアシスタントです。質問をOpenAI、Claude、Geminiや、OpenRouterなどのOpenAI互換プロバイダーが提供する大規模言語モデルに転送します。1対1のチャットとグループの両方で使え、グループでは直接メンションされたときや、質問への返信として投稿されたときに応答します。
pokitoki は無料で使えますか?ライセンスは?
pokitoki は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
pokitoki は今もメンテナンスされていますか?
活発にメンテナンス中。pokitoki の最終コミットは 2026年10月24日 です。
pokitoki は何に使えますか?
Telegram上で、自分専用または少人数の友人グループ向けのプライベートなAIアシスタントを運用する。 利用上限を設けたうえで、チーム共用のAIアシスタントをTelegramグループに導入する。 チャット上で文章を直接校正、翻訳、要約する。 Telegram内でテキストファイルやリンク先のWebページについて質問する。
pokitoki のインストール方法は?
BotFatherからAI APIキーとTelegramボットトークンを取得する リポジトリをクローンする: git clone https://github.com/nalgeon/pokitoki.git サンプル設定ファイルをconfig.ymlにコピーし、トークンを追加する: cp config.example.yml config.yml Docker Composeでボットを起動する: docker compose up --build --detach
pokitoki はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/nalgeon/pokitoki

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト