Git Product home page Git Product logo

zundagpt2's Introduction

ZundaGPT2

Copyright (c) 2024 led-mirage

概要

AIとチャットするアプリなのだ。質問と回答を音声で読み上げてくれるのが特徴なのだ。

使用できるAIは以下の通りなのだ。

  • OpenAI GPT (Azure OpenAI Serviceも利用可能)
  • Google Gemini

最新情報 バージョン 0.11.0

Google Gemini APIに対応したのだ!

スクリーンショット

v0.11.0 紹介動画

その1

ZundaGPT2_0.11.0A.mp4

その2

ZundaGPT2_0.11.0B.mp4

過去のバージョンの紹介動画はこちらを見て欲しいのだ。

動作確認環境

  • Windows 11 Pro 23H2
  • Python 3.12.0
  • VOICEVOX 0.18.0
  • A.I.VOICE Editor 1.4.9.0
  • COEIROINK v.2.3.4

必要なもの

このアプリを動作させるには以下のものが必要になるのだ。ここでは軽く触れておくだけにするけど、詳しいことはこっちを見てほしいのだ。

✅ OpenAIアカウントとAPIキー

このアプリ自体は無料だけど、OpenAIのアカウントとAPIの利用登録(課金およびAPIキーの作成)が必要なのだ。

✅ Google Gemini APIのAPIキー

バージョン0.11.0からGoogle Gemini APIにも対応したので、OpenAIの代わりにGoogle Gemini APIを使用することもできるのだ。

現時点でGoogle Gemini APIには無料プランが設定されているので、OpenAIのAPIよりも気軽に利用することができるのだ。Google Gemini APIを使用したい場合は、専用の資料を用意したので、それを参照して欲しいのだ。

✅ テキスト読み上げソフトウェア

このアプリは以下のテキスト読み上げソフトウェアに対応しているのだ。どれか一つでいいからPCにインストールしておく必要があるのだ。

用意ができたら、次の実行方法にゴーなのだ。

実行方法

🛩️ 準備:OSの環境変数を追加

OpenAIのAPIキー、もしくはGoogle Gemini APIのAPIキーをOSの環境変数に登録しておく必要があるのだ。

AI 変数名
OpenAI OPENAI_API_KEY OpenAIで取得したAPIキー
Google Gemini GEMINI_API_KEY Googleで取得したAPIキー

Windowsの場合は、Windowsの検索窓で「環境変数を編集」で検索すると設定画面が立ち上がるので、そこでユーザー環境変数を追加すればいいのだ。

🛩️ 実行方法①:実行ファイル(EXEファイル)を使う方法

1. プロジェクト用のフォルダの作成

任意の場所にプロジェクト用のフォルダを作成するのだ。

2. アプリのダウンロード

以下のリンクから ZundaGPT2.ZIP をダウンロードして、作成したフォルダに展開するのだ。

https://github.com/led-mirage/ZundaGPT2/releases/tag/v0.11.0

3. 実行

ZundaGPT2.exeをダブルクリックすればアプリが起動するのだ。

4. 注意事項

この実行ファイル(EXEファイル)は PyInstaller というライブラリを使って作成しているんだけど、割と頻繁にウィルス対策ソフトにマルウェアとかウィルスとかに誤認されるのだ。ネットとかを見るとこの問題が結構書かれているので、よくある事象のようだけど、残念なことに根本的な解決策は見つかっていないのだ。

もちろん、このアプリに悪意のあるプログラムは入っていないのだけど、気になる人は下の「Pythonで実行する方法」で実行してほしいのだ。

🛩️ 実行方法②:Pythonで実行する方法

1. Pythonのインストール

あらかじめ Python 3.12.0 が動く環境を作っておくのだ。他のバージョンでも動くかもしれないけど、確認はしていないのだよ。

ボクは pyenv-win + venv で仮想環境を作ってそこで開発しているから、そういった方法でも問題ないのだ。

2. プロジェクト用のフォルダの作成

任意の場所にプロジェクト用のフォルダを作成するのだ。

3. ターミナルの起動

ターミナルかコマンドプロンプトを起動して、作成したプロジェクトフォルダに移動するのだ。

4. ソースファイルのダウンロード

ZIPファイルをダウンロードして作成したフォルダに展開するのだ。
または、Gitが使える方は以下のコマンドを実行してクローンしてもOKなのだ。

git clone https://github.com/led-mirage/ZundaGPT2.git

5. ライブラリのインストール

コマンドプロンプトから以下のコマンドを実行して、必要なライブラリをインストールするのだ。

pip install -r requirements.txt

6. 実行

コマンドプロンプトから以下のコマンドを実行するとアプリが起動するのだ。

python app\main.py

注意事項

⚡ OpenAIの利用料金について

このアプリは無料だけど、OpenAI APIを使うには別途料金が発生するのだ(お試し用の無料枠もあるけど)。なので、使い過ぎには注意するのだ。定期的にOpenAIのサイトで現在の利用状況を確認するなどして自己管理して欲しいのだ。

そもそも自動チャージ設定を有効にしなければチャージされた分しか課金されないはずなので、そこまで心配する必要はないけれど、OpenAIのサイトでは月毎の利用上限なども設定できるのでそれらを活用して思わぬ出費を防ぐといいのだ。

⚡ Google Gemini APIの利用料金について

この資料にも書いたけど、現時点でGoogle Gemini APIには無料枠があるのだ。だから、基本的には無料枠を使ってアプリを利用すればいいと思うけど、もっとハードに使いたい場合は有料プランを考えてみるのもいいのだ。ただ、有料プランにした場合は、先に書いたOpenAIと同じように使い過ぎには注意して欲しいのだ。

⚡ APIキーの重要性について

OpenAIやGoogle GeminiのAPIキーはあなただけのものなので、人に教えたらダメなのだ。流出すると悪い人に勝手に使われてしまう可能性があるのだ。もし流出してしまったら、OpenAIやGoogleのサイトで現在使っているAPIキーを削除して、別のAPIキーを作ればいいのだ。

ただOpenAIでは、APIキーをひとつしか持っていない場合、新しいAPIキーを作ってからじゃないと古いAPIキーを削除できないようなのだ。これはOpenAIの仕様のようなんだけど、ボク的にはちょっといただけない仕様だと思っているのだ。将来的に改善することを願っているけれど、最悪支払い情報(クレジットカード情報)を削除してしまえばいいような気もするのだ。

なにわともあれ、APIキーと利用料金には注意を払って欲しいのだ。

⚡ ウィルス対策ソフトの誤認問題

上でも書いているけれど、配布している実行ファイル(EXEファイル)が、マルウェアやウィルスに誤認されてしまうことがあるのだ。問題はPythonのプログラムを一つの実行ファイル(EXEファイル)にまとめることにあるようなのだが、回避方法がないためどうしようもないのだ。

これが嫌な人は(ボクも嫌だけど)、Python本体をインストールしてPythonから普通に実行して欲しいのだ。実行ファイルのほうが手軽だし、そのほうがPythonに詳しくない人にとっては簡単なんだけど、誤認問題がついて回ることは覚えておいて欲しいのだ。

VirusTotalでのチェック結果は以下の通りなのだ。
(72個中2個のアンチウィルスエンジンで検出 :2024/05/19 v0.11.0)。

⚡ 免責事項

いまのところ特に問題点は見つかっていないけど、バグなんてものは潜在的に必ずあるし、0になるなんてことはあり得ないのだ。また、もしバグがあってそのせいで貴方に損害を与えたとしても、著作権者はいかなる責任も負いかねるのでその点を理解して使って欲しいのだ。

使用しているライブラリ

🔖 pywebview 4.4.1

ホームページ: https://github.com/r0x0r/pywebview
ライセンス:BSD-3-Clause license

🔖 openai 1.23.2

ホームページ: https://github.com/openai/openai-python
ライセンス:Apache License 2.0

🔖 google-generativeai 0.5.4

ホームページ: https://github.com/google-gemini/generative-ai-python
ライセンス:Apache License 2.0

🔖 requests 2.31.0

ホームページ: https://requests.readthedocs.io/en/latest/
ライセンス:Apache License 2.0

🔖 PyAudio 0.2.14

ホームページ: https://people.csail.mit.edu/hubert/pyaudio/
ライセンス:MIT License

🔖 pythonnet 3.0.3

ホームページ:https://github.com/pythonnet/pythonnet
ライセンス:MIT License

🔖 MathJax 3.2.2

ホームページ: https://github.com/mathjax/MathJax
ライセンス:Apache License 2.0

🔖 Highlight.js 11.9.0

ホームページ:https://github.com/highlightjs/highlight.js
ライセンス:BSD-3-Clause license

🔖 Marked 12.0.0

ホームページ:https://github.com/markedjs/marked
ライセンス:MIT license

🔖 mark.js 8.11.1

ホームページ:https://github.com/julkue/mark.js
ライセンス:MIT license

ライセンス

© 2024 led-mirage

本アプリケーションは MITライセンス の下で公開されているのだ。詳細については、プロジェクトに含まれる LICENSE ファイルを参照して欲しいのだ。

バージョン履歴

0.1.0 (2024/2/12)

  • ファーストリリース

0.1.1 (2024/2/13)

  • ソース添付のsettings.jsonを変更。プログラムに変更なし。

0.2.0 (2024/2/18)

  • ログに記録した以前のチャットに移動する機能を追加(prev、next)
  • 新しいチャットを開始している機能を追加(new)
  • チャットを削除する機能を追加
  • TeX形式の数式を表示する機能を追加
  • ログファイルの形式を変更
  • チャットリクエスト時のタイムアウト処理の追加
  • その他バグ修正など

0.3.0 (2024/2/23)

  • 表示しているチャットのログファイル名をタイトルバーに表示するようにした
  • 数式を左寄せ表示するように修正
  • 発声時のエラー処理を修正

0.4.0 (2024/3/3)

  • 設定ファイルをappConfig.jsonとsettings.jsonに分離
  • settings.jsonを配置するフォルダをsettingsフォルダに変更
  • 設定の切り替えを行うUIを追加
  • 画面左上に現在の設定のdisplay_nameを表示するように変更
  • ウィンドウがフォーカスを失った後に再度戻ってくると、IMEの変換がうまくいかなくなる問題に対処
  • チャットリクエスト時のタイムアウト処理を変更
  • スピーカーのON/OFFを切り替えれるように変更
  • ウィンドウサイズの初期値を設定ファイルで指定できるように変更
  • その他、バグ修正、微調整など

0.5.0 (2024/3/9)

  • マークダウン形式のテキストをHTMLに変換するように変更
  • チャットリクエストがタイムアウトした際、リトライするかユーザーに選択してもらうように修正

0.5.1 (2024/3/16)

  • 0.5.0で発生した数式が正しくレンダリングされないバグ(デグレード)を修正

0.6.0 (2024/3/23)

  • メッセージの削除ボタンを追加
  • PyInstallerの更新(6.4.0を使用)

0.7.0 (2024/3/30)

  • 再回答ボタンを追加
  • チャットログが1つしかない場合に、そのログを削除できないバグを修正

0.8.0 (2024/4/6)

  • メッセージ送信中止機能を追加
  • Ctrl + F でテキストを検索する機能を追加(F3 or Shift + F3で候補移動)
  • Welcomeメッセージの追加
  • 設定ファイルのフォーマット変更(Welcome関連項目追加)
  • Copyrightを動的に設定するように修正
  • 英文が右端で折り返さない問題を修正

0.9.0 (2024/4/21)

  • Readmeの使用しているライブラリ欄に、pywebviewの記載が洩れていたため追記
  • openaiのバージョンを1.12.0から1.23.2に更新
  • ChatAPIのタイムアウト値を設定ファイル(app_config.json)に持つように変更
  • AIの回答中にあるURLが正しくリンク表示にならない問題に対処

0.10.0 (2024/4/29)

  • Tex形式の行列式が正しく表示されない問題を解消

0.11.0 (2024/5/19)

  • Google Gemini APIに対応

zundagpt2's People

Contributors

led-mirage avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.