Spaces:

MakiAi
/

pic-to-header

Running

App Files Files Community

Maki commited on Oct 18

Commit

2b5ca13

•

0 Parent(s):

Initial commit

Browse files

Files changed (8) hide show

.aira/config.IRIS.yml +71 -0
.aira/config.dev.commit.yml +26 -0
.env.example +7 -0
.gitignore +162 -0
LICENSE +21 -0
README.md +245 -0
docs/README.en.md +245 -0
requirements.txt +2 -0

.aira/config.IRIS.yml ADDED Viewed

	@@ -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 ADDED Viewed

	@@ -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 ADDED Viewed

	@@ -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 ADDED Viewed

	@@ -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 ADDED Viewed

	@@ -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 ADDED Viewed

	@@ -0,0 +1,245 @@

+<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/graphs/commit-activity">
+    <img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/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>
+  <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="Development Status" src="https://img.shields.io/badge/status-active-success.svg">
+  <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/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">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/graphs/contributors">
+    <img alt="GitHub contributors" src="https://img.shields.io/github/contributors/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/issues?q=is%3Aissue+is%3Aclosed">
+    <img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/pulls?q=is%3Apr+is%3Aclosed">
+    <img alt="GitHub closed PRs" src="https://img.shields.io/github/issues-pr-closed/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <img alt="GitHub language count" src="https://img.shields.io/github/languages/count/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="GitHub search hit counter" src="https://img.shields.io/github/search/Sunwood-ai-labs/HarmonAI_III/goto">
+  <img alt="GitHub code size" src="https://img.shields.io/github/languages/code-size/Sunwood-ai-labs/HarmonAI_III">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/CONTRIBUTING.md">
+    <img src="https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg" alt="Contributor Covenant">
+  </a>
+  <a href="https://twitter.com/intent/tweet?text=Check%20out%20this%20awesome%20project%3A&url=https%3A%2F%2Fgithub.com%2FSunwood-ai-labs%2FHarmonAI_III">
+    <img alt="Twitter" src="https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FSunwood-ai-labs%2FHarmonAI_III">
+  </a>
+  <img alt="GitHub Created At" src="https://img.shields.io/github/created-at/Sunwood-ai-labs/HarmonAI_III">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/deployments">
+    <img alt="GitHub deployments" src="https://img.shields.io/github/deployments/Sunwood-ai-labs/HarmonAI_III/Production">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/discussions">
+    <img alt="GitHub Discussions" src="https://img.shields.io/github/discussions/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <img alt="GitHub followers" src="https://img.shields.io/github/followers/Sunwood-ai-labs?style=social">
+  <img alt="GitHub Release Date" src="https://img.shields.io/github/release-date/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="GitHub commit activity (branch)" src="https://img.shields.io/github/commit-activity/y/Sunwood-ai-labs/HarmonAI_III/main">
+  <img alt="GitHub commits since latest release (by date)" src="https://img.shields.io/github/commits-since/Sunwood-ai-labs/HarmonAI_III/latest">
+  </a>
+</p>
+<p align="center">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/actions/workflows/generate-release-notes.yml">
+  <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/Sunwood-ai-labs/HarmonAI_III/generate-release-notes.yml?label=generate-auto-release-notes">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/actions/workflows/translate-readme.yml">
+  <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/Sunwood-ai-labs/HarmonAI_III/generate-release-notes.yml?label=auto-translate-readme">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/actions/workflows/issue-review.yml">
+  <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/Sunwood-ai-labs/HarmonAI_III/generate-release-notes.yml?label=auto-issue-review">
+</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>
+> [!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.2.0`
+## 🆕 最新情報
+- 🎉 v1.2.0リリース: READMEへのGitHub Shieldsの追加、コラボレーター招待機能の追加、ドキュメントの更新を行いました。
+## ✨ 主な機能
+1. **統合AIツールセット**: AIRAとIRISの機能を1つのパッケージで提供
+2. **即時利用可能**: テンプレートとして使用することで、高品質な初期構造を持つリポジトリを簡単に作成
+3. **自動化された開発ワークフロー**: コミットメッセージ生成、リリースノート作成、イシュー管理の自動化
+4. **多言語サポート**: READMEの自動翻訳機能により、国際的なプロジェクト展開をサポート
+5. **柔軟なカスタマイズ**: プロジェクトのニーズに合わせて容易に調整可能
+6. **コラボレーター自動招待**: GitHub APIを利用したコラボレーター招待スクリプト
+## 🔧 使用方法
+### 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プロジェクトの開発を始めましょう！

docs/README.en.md ADDED Viewed

	@@ -0,0 +1,245 @@

+<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/graphs/commit-activity">
+    <img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/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>
+  <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="Development Status" src="https://img.shields.io/badge/status-active-success.svg">
+  <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/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">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/graphs/contributors">
+    <img alt="GitHub contributors" src="https://img.shields.io/github/contributors/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/issues?q=is%3Aissue+is%3Aclosed">
+    <img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/pulls?q=is%3Apr+is%3Aclosed">
+    <img alt="GitHub closed PRs" src="https://img.shields.io/github/issues-pr-closed/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <img alt="GitHub language count" src="https://img.shields.io/github/languages/count/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="GitHub search hit counter" src="https://img.shields.io/github/search/Sunwood-ai-labs/HarmonAI_III/goto">
+  <img alt="GitHub code size" src="https://img.shields.io/github/languages/code-size/Sunwood-ai-labs/HarmonAI_III">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/blob/main/CONTRIBUTING.md">
+    <img src="https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg" alt="Contributor Covenant">
+  </a>
+  <a href="https://twitter.com/intent/tweet?text=Check%20out%20this%20awesome%20project%3A&url=https%3A%2F%2Fgithub.com%2FSunwood-ai-labs%2FHarmonAI_III">
+    <img alt="Twitter" src="https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FSunwood-ai-labs%2FHarmonAI_III">
+  </a>
+  <img alt="GitHub Created At" src="https://img.shields.io/github/created-at/Sunwood-ai-labs/HarmonAI_III">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/deployments">
+    <img alt="GitHub deployments" src="https://img.shields.io/github/deployments/Sunwood-ai-labs/HarmonAI_III/Production">
+  </a>
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/discussions">
+    <img alt="GitHub Discussions" src="https://img.shields.io/github/discussions/Sunwood-ai-labs/HarmonAI_III">
+  </a>
+  <img alt="GitHub followers" src="https://img.shields.io/github/followers/Sunwood-ai-labs?style=social">
+  <img alt="GitHub Release Date" src="https://img.shields.io/github/release-date/Sunwood-ai-labs/HarmonAI_III">
+  <img alt="GitHub commit activity (branch)" src="https://img.shields.io/github/commit-activity/y/Sunwood-ai-labs/HarmonAI_III/main">
+  <img alt="GitHub commits since latest release (by date)" src="https://img.shields.io/github/commits-since/Sunwood-ai-labs/HarmonAI_III/latest">
+  </a>
+</p>
+<p align="center">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/actions/workflows/generate-release-notes.yml">
+  <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/Sunwood-ai-labs/HarmonAI_III/generate-release-notes.yml?label=generate-auto-release-notes">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/actions/workflows/translate-readme.yml">
+  <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/Sunwood-ai-labs/HarmonAI_III/generate-release-notes.yml?label=auto-translate-readme">
+  <a href="https://github.com/Sunwood-ai-labs/HarmonAI_III/actions/workflows/issue-review.yml">
+  <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/Sunwood-ai-labs/HarmonAI_III/generate-release-notes.yml?label=auto-issue-review">
+</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>
+> [!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 release notes, README, and commit messages are generated using the latest AI technologies.
+## 🚀 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.2.0`
+## 🆕 Latest News
+- 🎉 v1.2.0 released: Added GitHub Shields to the README, added collaborator invitation functionality, and updated documentation.
+## ✨ Key Features
+1. **Integrated AI Toolset**: Provides the functionality 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 automatic README translation.
+5. **Flexible Customization**: Easily adaptable to the needs of your project.
+6. **Automated Collaborator Invitation**: Collaborator invitation script using the GitHub API.
+## 🔧 How to Use
+### 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 for 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.
+## 🌿 Setting up the Environment
+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 suggestions
+- 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 as follows:
+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 list them 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 a collaborator:
+   ```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 appropriate permissions (the `repo` scope).
+- When using it for an organization's repository, ensure that appropriate permissions are granted in the organization's settings.
+- For security reasons, update tokens regularly and grant only the minimum necessary permissions.
+- Never commit information including the `.env` file or tokens to a public repository.
+This feature simplifies the process of adding new contributors to the project. You can efficiently expand your team while maintaining security.
+## 🐈 Process 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 Generation]
+    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.  Help improve this template repository through bug reports, feature requests, and pull requests.
+## 📄 License
+HarmonAI III is released under the [MIT License](LICENSE).
+## 🙏 Acknowledgments
+HarmonAI III has been inspired by many open-source projects. We especially thank the developers of AIRA and IRIS.  We also thank iris-s-coon and Maki.
+---
+HarmonAI III is an excellent starter kit for achieving an AI-driven development process. Let's start developing innovative AI projects based on this template!

requirements.txt ADDED Viewed

	@@ -0,0 +1,2 @@


1	+ aira
2	+ sourcesage