Ai-Punk：オープンソースのAI搭載ソフトウェア開発自動化アシスタント

Ai-PunkはGitHubでホストされているオープンソースのAI搭載ソフトウェア開発アシスタントで、開発者のNetskyによって開発された。LangChainのReActモデルをベースとし、最新のAIモデルを組み合わせることで、ユーザーのプログラミング作業の自動化を支援する。Ai-Punkの中心的な特徴は、完全に透明な思考プロセスであり、ユーザーはAIの推論のすべてのステップをリアルタイムで見ることができる。Ai-Punkはセキュリティを重視しており、すべての操作を指定された作業ディレクトリに制限しているため、開発者、プログラマー、タスクを自動化する必要のあるユーザーに適している。コードは公開されており、コミュニティは自由に貢献でき、プロジェクトは活発で頻繁に更新されている。

機能一覧

• 完全に透明化された思考プロセスAIの推論ステップをリアルタイムで表示し、操作のロジックを理解しやすくする。
• 自律的なタスク処理AIは複雑なプログラミング作業を独自に計画し、実行することができる。
• モジュラー・アーキテクチャー明確なコード構造と機能モジュールの分離により、メンテナンスと拡張が容易です。
• 安全なワークスペースすべての操作は、データのセキュリティを確保するために、ユーザーが選択したディレクトリに制限されます。
• リッチ・ツールセットファイル操作、検索、ターミナル・コマンド、コード編集をサポート。
• 美しい端末インターフェース直感的な端末UIを提供し、完全なプロセスを表示します。
• 多言語サポートユーザーの言語を自動的に検出し、英語とロシア語での対話をサポートします。
• インテリジェント文書検索セマンティック検索とファジィマッチングをサポートし、文書検索の効率を向上。
• 高性能インテグレーションLangChain最適化ツールで高速に動作します。

ヘルプの使用

設置プロセス

Ai-Punkを使用するには、GitHubリポジトリからコードを取得し、実行環境を設定する必要があります。詳しい手順は以下の通り：

1. クローンまたはダウンロードコード
   インタビュー https://github.com/netsky-devel/Ai-PunkCode "ボタンをクリックし、"Download ZIP "を選択してソースコードをダウンロードするか、Gitコマンドを使ってクローンする：

   git clone https://github.com/netsky-devel/Ai-Punk.git
   

   クローン作成後、プロジェクト・ディレクトリに移動する：

   cd Ai-Punk
   

2. 依存関係のインストール
   Ai-PunkはPython 3.8+と特定のライブラリに依存しています。Pythonがインストールされていることを確認してから、以下のコマンドを実行して依存関係をインストールしてください：

   pip install -r requirements.txt
   

   依存関係には、LangChain（AIモデル統合用）、Rich（エンドポイント・インターフェイスの美化用）などがある。 requirements.txt.

3. AIサービスプロバイダの設定
   Ai-PunkはAIサービス（OpenAI、Google、Anthropicなど）への接続を必要とします。メインアプリケーションを実行し、設定オプションを選択します：

   python main.py
   

   インターフェイスで「1 - AIプロバイダーの設定」を選択し、APIキーを入力します。キーはAIサービスプロバイダーのウェブサイトから取得する必要があります。設定情報は config/models.py または環境変数で指定する。

4. 作業ディレクトリの選択
   プログラムを実行した後、"2 - 作業ディレクトリの選択 "を選択し、操作のための作業ディレクトリを指定します。Ai-Punkは、セキュリティのために、すべてのファイル操作がこのディレクトリに制限されることを保証します。
5. AIエージェントの初期化
   AI エージェントを初期化するには、"3 - エージェントの初期化 "を選択します。システムが設定をロードし、ツールセットを準備します。
6. インタラクションの開始
   4 - エージェントとチャットを開始」を選択すると、対話モードに入ります。ユーザーはタスクコマンドを入力することができ、AIは自動的に推論プロセスを実行し表示します。

主な機能

Ai-Punkの核となる機能は、プログラミング作業の自動化である：

• 完全に透明化された思考プロセス
  Ai-Punkがユニークなのは、AIの推論ステップがリアルタイムで表示されることだ。例えば、ユーザーがプロジェクトの構造を分析するよう要求すると、端末がそれを表示する：

  ╭─ 🧠 Agent Thinking (Step 1) ───────────────────────────────╮
  │ 需要先分析项目结构，了解代码库内容。开始列出目录文件。│
  ╰──────────────────────────────────────────────────────────╯
  

  次にAIは list_directory カタログの内容をリストアップし、結果を説明するツール。ユーザーは端末のインターフェイスを通じて、操作の各ステップを明確に確認できる。

• 自律的なタスク処理
  AIは自分で複雑なタスクを実行できる。例えば、ユーザーが "main.pyにエラー処理を追加する "と入力すると、AIは次のように実行する：
  1. 取り出す main.py ファイルを使用する read_file (道具）。
  2. コードの構造を分析し、エラー処理を追加する必要がある箇所を特定する。
  3. 利用する edit_file ツールはtry-catch文を挿入する。
  4. 変更されたコードを表示し、変更ロジックを説明します。
• インテリジェント文書検索
  Ai-Punkはセマンティック検索とファジーマッチングを提供する。ユーザーが「すべてのプロフィールを検索」と入力すると、AIが検索結果を呼び出す。 file_search このツールは、ディレクトリをスキャンし、関連するファイル（例えば config.json).検索は正規表現と意味解析をサポートしています。例

  python main.py --search "config.*\.json"
  

  結果は関連性でソートされ、ファイルパスとコンテンツの概要が表示されます。

• ファイル操作
  Ai-Punkは幅広いファイル操作に対応している：
  • カタログ一覧走る list_directory ディレクトリの内容とファイルの詳細を表示するツール。
  • ファイルを読む使用 read_fileまた、コードのシンタックスハイライトをサポートしている。
  • 編集ファイルスルー edit_file検索と置換、バッチ修正をサポートしています。
  • ファイルの削除使用 delete_fileこのシステムは、安全な削除と自動バックアップを保証します。
    例えば、古いバックアップファイルの削除など：

  python main.py --delete "backup_*.bak"
  

  AIはファイルを検証し、ユーザーに確認を求める。

• ターミナル・コマンドの実行
  ユーザーは run_terminal ツールを使ってターミナル・コマンドを実行する。例

  python main.py --terminal "git status"
  

  誤操作を防ぐため、コマンドは管理された環境で実行される。

注目の機能操作

• 美しい端末インターフェース
  Ai-PunkはRichライブラリを使用して、推論プロセス、操作結果、エラーメッセージを表示する直感的な端末UIを作成します。インターフェイスはカラーハイライトと構造化出力をサポートしています。例えば、ファイル検索を実行すると、結果はファイル名、パス、関連性スコアとともに表に表示されます。
• 多言語サポート
  Ai-Punkはユーザー入力の言語を自動的に検出し、英語とロシア語の両方をサポートします。例えば、ユーザーが "создай новый файл config.json "と入力すると、AIはロシア語で応答し、ファイルを作成します：

  python main.py --create "config.json"
  

  言語は src/localization/ カタログ管理、他言語拡張のサポート。

• 安全なワークスペース
  すべての操作は、ユーザーが選択した作業ディレクトリに制限されます。 src/workspace/manager.py 外部ファイルにアクセスされないように、パス検証を行う。例えば ../sensitive.txt エラーメッセージが表示される。

ほら

• 従属性チェック実行する前に、すべての依存関係がインストールされていることを確認してください。 requirements.txt 完全性。
• API設定APIキーが未設定の場合、実行は失敗します。詳細は env.example 環境変数の設定。
• エラー検出ランタイムエラーが報告された場合は、ターミナル出力で詳細なエラーメッセージを確認するか、あるいは logs/ ログファイルを作成する。
• 更新コード通常運転 git pull 最新のコードを入手し、公式リポジトリと同期を保つ。

アプリケーションシナリオ

1. コードベース解析
   開発者が大規模なプロジェクトの構造を素早く理解する必要がある場合、Ai-Punkは自動的にディレクトリをスキャンし、ファイル構造に関するレポートを作成する。
2. コード変更の自動化
   プログラマーがエラー処理の追加やコードのリファクタリングを一括して行う必要がある場合、Ai-Punkは複数のファイルを素早く編集し、標準的なコードスニペットを挿入し、手作業にかかる時間を節約します。
3. 文書管理と後始末
   開発チームが古いバックアップファイルを整理したり、プロジェクトのディレクトリを整理したりする必要がある場合、Ai-Punkの安全なファイル操作ツールは効率的に仕事をこなします。
4. 多言語開発サポート
   多国籍チームが英語やロシア語でやり取りする場合、Ai-Punkは自動的に言語を適応させ、一貫した開発体験を提供します。
5. 学習とデバッグ
   プログラミング初心者は、透明な思考プロセスを通じて、AIがどのように問題を分析し、解決するのかを学ぶことができ、教育現場に適している。

品質保証

1. Ai-PunkはどのようなAIモデルをサポートしていますか？
   OpenAI、Google、Anthropicのモデルのサポートは、以下のように設定されている。 src/config/models.py セット・イン
2. 安全な運転を確保するには？
   Ai-Punkはすべての操作を選択されたディレクトリに制限し、外部ファイルへのアクセスを防ぐために相対パス検証を使用します。すべてのファイル操作はログに記録されます。
3. 新機能を拡張する方法は？
   フォークリポジトリの src/tools/ 新しいツールモジュールの追加、アップデート src/agent/wrappers/factory.pyそしてPull Requestを提出する。
4. ゆっくり走るのは？
   ネットワーク接続を確認し（AI APIコールは安定したネットワークを必要とする）、最適化された依存関係（最新バージョンのLangChainなど）がインストールされていることを確認する。
5. 言語を切り替えるには？
   Ai-Punkは自動的に入力言語を検出するので、手動で切り替える必要はありません。言語ファイルは src/localization/messages/ 中間管理職。