Initial commit

.SourceSageignore

@@ -0,0 +1,67 @@
+.git
+__pycache__
+LICENSE
+output.md
+assets
+Style-Bert-VITS2
+output
+streamlit
+SourceSage.md
+data
+.gitignore
+.SourceSageignore
+*.png
+Changelog
+SourceSageAssets
+SourceSageAssetsDemo
+__pycache__
+.pyc
+**/__pycache__/**
+modules\__pycache__
+.svg
+sourcesage.egg-info
+.pytest_cache
+dist
+build
+.env
+example
+
+.gaiah.md
+.Gaiah.md
+tmp.md
+tmp2.md
+.SourceSageAssets
+tests
+template
+aira.egg-info
+aira.Gaiah.md
+README_template.md
+
+egg-info
+oasis_article.egg-info
+.harmon_ai
+.aira
+
+article_draft
+issue_creator.log
+oasis.log
+
+debug_output
+*.log
+
+html_replacement1.html
+html_raw.html
+html_content.html
+html_with_placeholders.html
+markdown_html.html
+markdown_text.md
+markdown_text2.md
+
+saved_article.html
+memo.md
+content.md
+
+.SourceSageAssets
+docs
+.github
+.venv

.aira/config.IRIS.yml

@@ -0,0 +1,71 @@
+aira:
+  gaiah:  # 共通設定
+    run: true
+    repo:
+      repo_name: "IRIS"
+      description: "I.R.I.S（Intelligent Repository Issue Solver）"
+      private: false
+    local:
+      repo_dir: "C:/Prj/IRIS"
+      no_initial_commit: false
+    commit:
+      commit_msg_path: ".Gaiah.md"
+      branch_name: null
+
+    dev:  # 開発時の設定 (必要に応じて上書き)
+      repo:
+        create_repo: false
+      local:
+        init_repo: false
+      commit:
+        process_commits: true
+
+    init:  # 初期化時の設定 (必要に応じて上書き)
+      repo:
+        create_repo: true
+      local:
+        init_repo: true
+      commit:
+        process_commits: false
+
+  llm:
+    model: "gemini/gemini-1.5-pro-latest"  # 利用するLLMモデル
+
+  repository_summary_output_dir: .aira  # リポジトリ概要の出力ディレクトリ
+  readme_prompt_template_path: .aira/readme_prompt_template.txt  # README生成のプロンプトテンプレートのパス
+  
+  harmon_ai:
+    run: true
+    environment:
+      repo_name: "IRIS"
+      owner_name: "Sunwood-ai-labs"
+      package_name: "IRIS"
+      icon_url: "https://huggingface.co/datasets/MakiAi/IconAssets/resolve/main/IRIS.png"
+      title: "IRIS"
+      subtitle: "～ Intelligent Repository Issue Solver ～"
+      website_url: "https://hamaruki.com/"
+      github_url: "https://github.com/Sunwood-ai-labs"
+      twitter_url: "https://x.com/hAru_mAki_ch"
+      blog_url: "https://hamaruki.com/"
+
+    product:
+      important_message_file: "important_template.md"
+      sections_content_file: "sections_template.md"
+      output_file: "README_template.md"
+      cicd_file_path: "publish-to-pypi.yml"
+      cicd_main_path: "publish-to-pypi.yml"
+      github_cicd_dir: ".github/workflows"
+    
+    llm_product:
+      sections_content_file: "sections_template_llm.md"
+
+    development:
+      output_dir: "C:/Prj/IRIS/.harmon_ai"
+
+    main:
+      main_dir: "C:/Prj/IRIS/"
+      replace_readme: true
+
+    instructions_prompt: .aira/instructions.IRIS.md
+
+# aira --mode=make --config=.aira\config.IRIS.yml

.aira/config.dev.commit.yml

@@ -0,0 +1,26 @@
+aira:
+  gaiah:  # 共通設定
+    run: true
+    repo:
+      repo_name: "AIRA-Sample04"
+      description: ""
+      private: True
+    local:
+      repo_dir: "./"
+      no_initial_commit: false
+    commit:
+      commit_msg_path: ".SourceSageAssets/COMMIT_CRAFT/llm_output.md"
+      branch_name: null
+
+    dev:  # 開発時の設定 (必要に応じて上書き)
+      repo:
+        create_repo: false
+      local:
+        init_repo: false
+      commit:
+        process_commits: true
+
+# aira --mode sourcesage commit  --config=.aira\config.dev.commit.yml --ss-model-name="gemini/gemini-1.5-pro-latest" --llm-output="llm_output.md" --ignore-file=".iris.SourceSageignore"
+# aira --mode sourcesage commit  --config=.aira\config.dev.commit.yml --ss-model-name="gemini/gemini-1.5-flash-002" --llm-output="llm_output.md"
+# aira --mode sourcesage commit  --config=.aira\config.dev.commit.yml --ss-model-name="gpt-4o-mini" --llm-output="llm_output.md"
+# sourcesage --ignore-file=".iris.SourceSageignore"

.env.example

@@ -0,0 +1,7 @@
+# GitHubアクセストークン（コラボレーター招待用）
+GITHUB_TOKEN=your_github_personal_access_token_here
+
+# 以下は他の機能で使用する可能性のあるトークンの例です。記載しておくと後々便利です。
+# GITHUB_ACCESS_TOKEN=ghp_xxxxx
+# YOUR_PERSONAL_ACCESS_TOKEN_IRIS=ghp_yyyyy
+# GEMINI_API_KEY=AIzzzzz

.gitignore

@@ -0,0 +1,162 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Maki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,236 @@
+---
+title: HarmonAI III
+emoji: 🦀
+colorFrom: green
+colorTo: blue
+sdk: streamlit
+sdk_version: 1.39.0
+app_file: app.py
+pinned: false
+license: mit
+---
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sunwood-ai-labs/HarmonAI_III/refs/heads/main/docs/HarmonAI-III.png" width="100%">
+  <h1 align="center">🌟 HarmonAI III 🌟</h1>
+</p>
+<p align="center">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III">
+    <img alt="GitHub Repo" src="https://img.shields.io/badge/github-HarmonAI__III-blue?logo=github">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/LICENSE">
+    <img alt="License" src="https://img.shields.io/github/license/Sunwood-ai-labs/HarmonAI_III?color=green">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/stargazers">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/Sunwood-ai-labs/HarmonAI_III?style=social">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/releases">
+    <img alt="GitHub release" src="https://img.shields.io/github/v/release/Sunwood-ai-labs/HarmonAI_III?include_prereleases&style=flat-square">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/issues">
+    <img alt="GitHub issues" src="https://img.shields.io/github/issues/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/pulls">
+    <img alt="PRs Welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/network/members">
+    <img alt="GitHub forks" src="https://img.shields.io/github/forks/Sunwood-ai-labs/HarmonAI_III?style=social">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/watchers">
+    <img alt="GitHub watchers" src="https://img.shields.io/github/watchers/Sunwood-ai-labs/HarmonAI_III?style=social">
+  </a>
+  <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="GitHub top language" src="https://img.shields.io/github/languages/top/Sunwood-ai-labs/HarmonAI_III">
+</p>
+<h2 align="center">
+  ～ AI-Powered Automated Repository Management Template ～
+
+<a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/README.md"><img src="https://img.shields.io/badge/ドキュメント-日本語-white.svg" alt="JA doc"/></a>
+<a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/docs/README.en.md"><img src="https://img.shields.io/badge/english-document-white.svg" alt="EN doc"></a>
+</h2>
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python" alt="Python">
+  <img src="https://img.shields.io/badge/OpenAI-412991?style=for-the-badge&logo=openai" alt="OpenAI">
+  <img src="https://img.shields.io/badge/Gemini-8E75B2?style=for-the-badge&logo=google" alt="Google Gemini">
+  <img src="https://img.shields.io/badge/Git-F05032?style=for-the-badge&logo=git" alt="Git">
+  <img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github" alt="GitHub">
+  <img src="https://img.shields.io/badge/Actions-2088FF?style=for-the-badge&logo=github-actions" alt="GitHub Actions">
+  <img src="https://img.shields.io/badge/YAML-CB171E?style=for-the-badge&logo=yaml" alt="YAML">
+  <img src="https://img.shields.io/badge/pip-3775A9?style=for-the-badge&logo=pypi" alt="pip">
+  <img src="https://img.shields.io/badge/Markdown-000000?style=for-the-badge&logo=markdown" alt="Markdown">
+  <img src="https://img.shields.io/badge/GitHub_API-181717?style=for-the-badge&logo=github" alt="GitHub API">
+</p>
+<p align="center">
+  <a href="https://github.com/Sunwood-ai-labs/AIRA">
+    <img src="https://img.shields.io/badge/AIRA-FF4500?style=for-the-badge&logo=github" alt="AIRA">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/IRIS">
+    <img src="https://img.shields.io/badge/IRIS-9370DB?style=for-the-badge&logo=github" alt="IRIS">
+  </a>
+</p>
+
+
+> [!IMPORTANT]
+>  HarmonAI IIIは、[cline (旧:Claude Dev)](https://github.com/clinebot/cline), [SourceSage](https://github.com/Sunwood-ai-labs/SourceSage), [claude.ai](https://claude.ai/)を活用して開発されたテンプレートリポジトリです。リリースノート、README、コミットメッセージの大部分は、最新のAI技術を用いて生成されています。
+
+## 🚀 プロジェクト概要
+
+HarmonAI IIIは、AIRAとIRISを統合した革新的な**AIリポジトリスターターキット**です。このリポジトリは、LLMを活用したAI開発プロジェクトの構造とワークフローを提供し、開発者の作業効率を劇的に向上させることを目的としています。バージョン: `v1.3.0`
+
+
+## 🆕 最新情報
+
+- 🎉 **v1.3.0リリース**: Streamlitアプリの基本構造作成、READMEファイルのデザイン改善、いくつかのバグ修正、およびドキュメントの更新を行いました。  StreamlitアプリではREADME.mdファイルを読み込んで表示する機能を実装しました。  README.mdファイルが存在しない場合のエラー処理も追加されています。  さらに、GitHubリポジトリへのコラボレーター追加スクリプト、Hugging Face Hubへの自動同期ワークフロー、PyPIへの自動デプロイワークフローを追加しました。
+
+
+## ✨ 主な機能
+
+1. **統合AIツールセット**: AIRAとIRISの機能を1つのパッケージで提供
+2. **即時利用可能**: テンプレートとして使用することで、高品質な初期構造を持つリポジトリを簡単に作成
+3. **自動化された開発ワークフロー**: コミットメッセージ生成、リリースノート作成、イシュー管理の自動化
+4. **多言語サポート**: READMEの自動翻訳機能により、国際的なプロジェクト展開をサポート
+5. **柔軟なカスタマイズ**: プロジェクトのニーズに合わせて容易に調整可能
+6. **コラボレーター自動招待**: GitHub APIを利用したコラボレーター招待スクリプト
+7. **Streamlitアプリ**: README.mdファイルを表示する基本的なStreamlitアプリケーション
+
+
+## 🔧 使用方法
+
+### Streamlitアプリの実行
+1. `pip install -r requirements.txt` で必要なパッケージをインストールします。
+2. `streamlit run app.py` を実行します。
+
+### AIRAの使用例：
+```bash
+aira --mode sourcesage commit  --config=.aira\config.dev.commit.yml --ss-model-name="gpt-4o-mini" --llm-output="llm_output.md"
+```
+
+### IRISの使用例：
+
+詳細な使用方法については、各コンポーネントのドキュメンテーションを参照してください。
+
+
+## 📦 インストール手順
+
+1. このリポジトリをテンプレートとして使用し、新しいリポジトリを作成します。
+2. リポジトリをローカルにクローンします。
+3. 必要な依存関係をインストールします：
+   ```bash
+   pip install -r requirements.txt
+   ```
+4. AIRAとIRISの設定ファイルをカスタマイズします。
+5. GitHub Actionsの設定を確認し、必要に応じて環境変数を設定します。
+6. `.github/release_notes/.sourcesage_releasenotes_iris.yml`ファイルを開き、`repo-name:`の値を新しいリポジトリ名に修正します。
+
+
+## 🌿 環境構築
+
+HarmonAI IIIの環境を構築するには、以下の手順に従ってください：
+
+1. 仮想環境を作成します：
+   ```bash
+   python3 -m venv .venv
+   ```
+   これにより、`.venv`ディレクトリに仮想環境が作成されます。
+
+2. 仮想環境をアクティベートします：
+   ```bash
+   source .venv/bin/activate  # Linux/macOS
+   .venv\Scripts\activate  # Windows
+   ```
+
+3. 依存関係をインストールします：
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+これらの手順により、HarmonAI IIIの開発環境が整います。
+
+
+## 📚 主要コンポーネント
+
+### 🤖 [AIRA (AI-Integrated Repository for Accelerated Development)](https://github.com/Sunwood-ai-labs/AIRA)
+- リポジトリ作成の自動化
+- コミットメッセージの自動生成
+
+### 🌈 [IRIS (Intelligent Repository Issue Solver)](https://github.com/Sunwood-ai-labs/IRIS)
+- イシューの自動分類
+- 解決策の自動提案
+- リリースノートの自動生成
+- READMEの自動翻訳
+
+## 🤝 コラボレーターの自動招待
+
+HarmonAI IIIには、GitHubリポジトリにコラボレーターを自動で招待するスクリプトが含まれています。以下の手順で使用できます：
+
+1. `.env` ファイルを作成し、必要なトークンを設定します：
+   ```
+   # GitHubアクセストークン（コラボレーター招待用）
+   GITHUB_TOKEN=your_github_personal_access_token_here
+
+   # 以下は他の機能で使用する可能性のあるトークンの例です。記載しておくと後々便利です。
+   # GITHUB_ACCESS_TOKEN=ghp_xxxxx
+   # YOUR_PERSONAL_ACCESS_TOKEN_IRIS=ghp_yyyyy
+   # GEMINI_API_KEY=AIzzzzz
+   ```
+
+   注意: `.env` ファイルは `.gitignore` に含めて、リポジトリにコミットしないようにしてください。
+
+2. 以下のコマンドを実行してコラボレーターを招待します：
+   ```bash
+   python .github/github_add_collaborator.py Sunwood-ai-labs/HarmonAI_III username_to_invite
+   ```
+
+   `username_to_invite` は招待したいGitHubユーザー名に置き換えてください。
+
+3. スクリプトが正常に実行されると、指定したユーザーにコラボレーター招待が送信されます。
+
+注意事項：
+- このスクリプトを使用するには、GitHubトークンに適切な権限（`repo` スコープ）が必要です。
+- 組織のリポジトリに対して使用する場合は、組織の設定で適切な権限が付与されていることを確認してください。
+- セキュリティのため、トークンは定���的に更新し、必要最小限の権限のみを付与するようにしてください。
+- `.env` ファイルやトークンを含む情報は、決して公開リポジトリにコミットしないでください。
+
+この機能により、プロジェクトへの新しいコントリビューターの追加プロセスが簡素化されます。セキュリティを維持しながら、効率的にチームを拡大することができます。
+
+## 🐈 処理フロー
+
+
+```mermaid
+%%{init:{'theme':'base','themeVariables':{'primaryColor':'#024959','primaryTextColor':'#F2C335','primaryBorderColor':'#F2AE30','lineColor':'#A1A2A6','secondaryColor':'#593E25','tertiaryColor':'#F2C335','noteTextColor':'#024959','noteBkgColor':'#F2C335','textColor':'#024959','fontSize':'18px'}}}%%
+
+graph LR
+    A[開始] --> B[リポジトリの構想とネーミング]
+    B -->|人間が実施| C[HarmonAI IIIによる<br>リポジトリ初期化]
+    C -->|自動化| D[開発作業]
+    D -->|人間が実施| E[AIRAによる<br>コミット自動化]
+    E --> H[IRISによる<br>リリースノート作成]
+    H --> I[IRISによる<br>ドキュメント翻訳]
+    I --> J[リリース]
+    J --> K[終了]
+
+    class B,D,G human;
+    class E aira;
+    class F,H,I iris;
+    class C auto;
+    class A,J,K process;
+
+```
+
+
+
+## 🤝 コントリビューション
+
+HarmonAI IIIは、オープンソースプロジェクトとしてコミュニティからの貢献を歓迎しています。バグ報告、機能リクエスト、プルリクエストを通じて、このテンプレートリポジトリの改善にご協力ください。
+
+## 📄 ライセンス
+
+HarmonAI IIIは、[MITライセンス](LICENSE)の下で公開されています。
+
+## 🙏 謝辞
+
+HarmonAI IIIの開発にあたり、多くのオープンソースプロジェクトからインスピレーションを得ています。特に、AIRAとIRISの開発者の皆様に深く感謝申し上げます。iris-s-coon、Maki様にも感謝いたします。
+
+---
+
+HarmonAI IIIは、AI駆動の開発プロセスを実現する優れたスターターキットです。このテンプレートを基に、革新的なAIプロジェクトの開発を始めましょう！

app.py

@@ -0,0 +1,9 @@
+import streamlit as st
+import os
+
+try:
+    with open("README.md", "r", encoding="utf-8") as f:
+        readme_content = f.read()
+    st.markdown(readme_content, unsafe_allow_html=True)
+except FileNotFoundError:
+    st.error("README.mdが見つかりませんでした。")

docs/README.en.md

@@ -0,0 +1,236 @@
+---
+title: HarmonAI III
+emoji: 🦀
+colorFrom: green
+colorTo: blue
+sdk: streamlit
+sdk_version: 1.39.0
+app_file: app.py
+pinned: false
+license: mit
+---
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sunwood-ai-labs/HarmonAI_III/refs/heads/main/docs/HarmonAI-III.png" width="100%">
+  <h1 align="center">🌟 HarmonAI III 🌟</h1>
+</p>
+<p align="center">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III">
+    <img alt="GitHub Repo" src="https://img.shields.io/badge/github-HarmonAI__III-blue?logo=github">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/LICENSE">
+    <img alt="License" src="https://img.shields.io/github/license/Sunwood-ai-labs/HarmonAI_III?color=green">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/stargazers">
+    <img alt="GitHub stars" src="https://img.shields.io/github/stars/Sunwood-ai-labs/HarmonAI_III?style=social">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/releases">
+    <img alt="GitHub release" src="https://img.shields.io/github/v/release/Sunwood-ai-labs/HarmonAI_III?include_prereleases&style=flat-square">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/issues">
+    <img alt="GitHub issues" src="https://img.shields.io/github/issues/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/pulls">
+    <img alt="PRs Welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/network/members">
+    <img alt="GitHub forks" src="https://img.shields.io/github/forks/Sunwood-ai-labs/HarmonAI_III?style=social">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/watchers">
+    <img alt="GitHub watchers" src="https://img.shields.io/github/watchers/Sunwood-ai-labs/HarmonAI_III?style=social">
+  </a>
+  <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="GitHub top language" src="https://img.shields.io/github/languages/top/Sunwood-ai-labs/HarmonAI_III">
+</p>
+<h2 align="center">
+  ～ AI-Powered Automated Repository Management Template ～
+
+<a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/README.md"><img src="https://img.shields.io/badge/ドキュメント-日本語-white.svg" alt="JA doc"/></a>
+<a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/docs/README.en.md"><img src="https://img.shields.io/badge/english-document-white.svg" alt="EN doc"></a>
+</h2>
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python" alt="Python">
+  <img src="https://img.shields.io/badge/OpenAI-412991?style=for-the-badge&logo=openai" alt="OpenAI">
+  <img src="https://img.shields.io/badge/Gemini-8E75B2?style=for-the-badge&logo=google" alt="Google Gemini">
+  <img src="https://img.shields.io/badge/Git-F05032?style=for-the-badge&logo=git" alt="Git">
+  <img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github" alt="GitHub">
+  <img src="https://img.shields.io/badge/Actions-2088FF?style=for-the-badge&logo=github-actions" alt="GitHub Actions">
+  <img src="https://img.shields.io/badge/YAML-CB171E?style=for-the-badge&logo=yaml" alt="YAML">
+  <img src="https://img.shields.io/badge/pip-3775A9?style=for-the-badge&logo=pypi" alt="pip">
+  <img src="https://img.shields.io/badge/Markdown-000000?style=for-the-badge&logo=markdown" alt="Markdown">
+  <img src="https://img.shields.io/badge/GitHub_API-181717?style=for-the-badge&logo=github" alt="GitHub API">
+</p>
+<p align="center">
+  <a href="https://github.com/Sunwood-ai-labs/AIRA">
+    <img src="https://img.shields.io/badge/AIRA-FF4500?style=for-the-badge&logo=github" alt="AIRA">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/IRIS">
+    <img src="https://img.shields.io/badge/IRIS-9370DB?style=for-the-badge&logo=github" alt="IRIS">
+  </a>
+</p>
+
+
+> [!IMPORTANT]
+> HarmonAI III is a template repository developed using [cline (formerly Claude Dev)](https://github.com/clinebot/cline), [SourceSage](https://github.com/Sunwood-ai-labs/SourceSage), and [claude.ai](https://claude.ai/).  The majority of the release notes, README, and commit messages were generated using the latest AI technology.
+
+## 🚀 Project Overview
+
+HarmonAI III is an innovative **AI repository starter kit** integrating AIRA and IRIS. This repository aims to dramatically improve developer efficiency by providing the structure and workflow for AI development projects leveraging LLMs. Version: `v1.3.0`
+
+
+## 🆕 Latest News
+
+- 🎉 **v1.3.0 Released**:  Created a basic Streamlit app structure, improved README file design, fixed several bugs, and updated the documentation. The Streamlit app now includes a feature to display the contents of the README.md file. Error handling for cases where the README.md file is missing has also been added.  Furthermore, we've added a collaborator addition script for the GitHub repository, an automated synchronization workflow with Hugging Face Hub, and an automated deployment workflow to PyPI.
+
+
+## ✨ Main Features
+
+1. **Integrated AI Toolset**: Provides the functionalities of AIRA and IRIS in a single package.
+2. **Ready to Use**: Easily create a repository with a high-quality initial structure by using it as a template.
+3. **Automated Development Workflow**: Automates commit message generation, release note creation, and issue management.
+4. **Multilingual Support**: Supports international project deployment through automated README translation.
+5. **Flexible Customization**: Easily adjustable to suit the needs of your project.
+6. **Automated Collaborator Invitation**: Collaborator invitation script using the GitHub API.
+7. **Streamlit App**: A basic Streamlit application that displays the README.md file.
+
+
+## 🔧 How to Use
+
+### Running the Streamlit App
+1. Install the necessary packages with `pip install -r requirements.txt`.
+2. Run `streamlit run app.py`.
+
+### AIRA Example:
+```bash
+aira --mode sourcesage commit  --config=.aira\config.dev.commit.yml --ss-model-name="gpt-4o-mini" --llm-output="llm_output.md"
+```
+
+### IRIS Example:
+
+Refer to the documentation of each component for detailed usage instructions.
+
+
+## 📦 Installation Instructions
+
+1. Use this repository as a template to create a new repository.
+2. Clone the repository locally.
+3. Install the necessary dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+4. Customize the AIRA and IRIS configuration files.
+5. Check the GitHub Actions settings and configure environment variables as needed.
+6. Open the `.github/release_notes/.sourcesage_releasenotes_iris.yml` file and change the value of `repo-name:` to your new repository name.
+
+
+## 🌿 Environment Setup
+
+Follow these steps to set up the HarmonAI III environment:
+
+1. Create a virtual environment:
+   ```bash
+   python3 -m venv .venv
+   ```
+   This creates a virtual environment in the `.venv` directory.
+
+2. Activate the virtual environment:
+   ```bash
+   source .venv/bin/activate  # Linux/macOS
+   .venv\Scripts\activate  # Windows
+   ```
+
+3. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+These steps will prepare your development environment for HarmonAI III.
+
+
+## 📚 Main Components
+
+### 🤖 [AIRA (AI-Integrated Repository for Accelerated Development)](https://github.com/Sunwood-ai-labs/AIRA)
+- Automated repository creation
+- Automated commit message generation
+
+### 🌈 [IRIS (Intelligent Repository Issue Solver)](https://github.com/Sunwood-ai-labs/IRIS)
+- Automated issue classification
+- Automated solution suggestion
+- Automated release note generation
+- Automated README translation
+
+## 🤝 Automated Collaborator Invitation
+
+HarmonAI III includes a script to automatically invite collaborators to the GitHub repository.  Use it with the following steps:
+
+1. Create a `.env` file and set the necessary tokens:
+   ```
+   # GitHub access token (for collaborator invitation)
+   GITHUB_TOKEN=your_github_personal_access_token_here
+
+   # The following are examples of tokens that may be used by other functions.  It's convenient to have them written down for later use.
+   # GITHUB_ACCESS_TOKEN=ghp_xxxxx
+   # YOUR_PERSONAL_ACCESS_TOKEN_IRIS=ghp_yyyyy
+   # GEMINI_API_KEY=AIzzzzz
+   ```
+
+   Note: Include the `.env` file in `.gitignore` to prevent it from being committed to the repository.
+
+2. Run the following command to invite collaborators:
+   ```bash
+   python .github/github_add_collaborator.py Sunwood-ai-labs/HarmonAI_III username_to_invite
+   ```
+
+   Replace `username_to_invite` with the GitHub username you want to invite.
+
+3. Once the script runs successfully, a collaborator invitation will be sent to the specified user.
+
+Cautions:
+- This script requires the GitHub token to have the appropriate permissions (`repo` scope).
+- When using it for an organization's repository, ensure that appropriate permissions are granted in the organization's settings.
+- For security, update tokens regularly and grant only the minimum necessary permissions.
+- Never commit information, including the `.env` file and tokens, to a public repository.
+
+This feature simplifies the process of adding new contributors to your project.  You can efficiently expand your team while maintaining security.
+
+## 🐈 Processing Flow
+
+
+```mermaid
+%%{init:{'theme':'base','themeVariables':{'primaryColor':'#024959','primaryTextColor':'#F2C335','primaryBorderColor':'#F2AE30','lineColor':'#A1A2A6','secondaryColor':'#593E25','tertiaryColor':'#F2C335','noteTextColor':'#024959','noteBkgColor':'#F2C335','textColor':'#024959','fontSize':'18px'}}}%%
+
+graph LR
+    A[Start] --> B[Repository Conception and Naming]
+    B -->|Human Action| C[HarmonAI III Repository Initialization]
+    C -->|Automated| D[Development Work]
+    D -->|Human Action| E[AIRA Automated Commits]
+    E --> H[IRIS Release Note Creation]
+    H --> I[IRIS Documentation Translation]
+    I --> J[Release]
+    J --> K[End]
+
+    class B,D,G human;
+    class E aira;
+    class F,H,I iris;
+    class C auto;
+    class A,J,K process;
+
+```
+
+
+
+## 🤝 Contributions
+
+HarmonAI III welcomes contributions from the community as an open-source project. Please help improve this template repository through bug reports, feature requests, and pull requests.
+
+## 📄 License
+
+HarmonAI III is licensed under the [MIT License](LICENSE).
+
+## 🙏 Acknowledgements
+
+HarmonAI III has drawn inspiration from many open-source projects during its development. We extend our deepest gratitude to the developers of AIRA and IRIS, in particular.  We also thank iris-s-coon and Maki.
+
+---
+
+HarmonAI III is an excellent starter kit for achieving an AI-driven development process.  Start developing innovative AI projects based on this template!

requirements.txt

@@ -0,0 +1,2 @@
+aira
+sourcesage