Pywen: ソフトウェア開発のために作られたPythonコマンドラインAIアシスタント

Pywenの中核は、Pythonで構築されたコマンドラインインターフェイス（CLI）ツールであり、AliCloudの最新のコードのビッグモデルであるQwen3-Coderの機能を開発者の端末に直接統合します。Qwen3-Coderは、あらゆる種類のインテリジェントソフトウェアエンジニアリングタスクを処理するために特別に設計されており、開発者に効率的でインテリジェントなコードアシスタントを提供します。Pywenプロジェクトの設計理念は、実用的な開発ツールであるだけでなく、理想的な研究プラットフォームでもある透明でモジュール化されたアーキテクチャを提供することです。研究プラットフォームでもある。研究者や開発者は、その内部構造を簡単に変更、拡張、分析することができるため、AI知能のアーキテクチャを研究したり、アブレーション実験を行ったり、新しい知能機能を開発したりするのに理想的である。

機能一覧

• Qwen3-コーダー ドライバーQwen3-Coder-Plusは、Aliyun社の最新のコード特化型大規模言語モデルで、コード生成、理解、デバッグを強力にサポートします。
• コマンドライン・インタラクション複雑なソフトウェア開発タスクを実行するために、端末に自然言語コマンドを入力することでインテリジェンスと対話する。
• モジュラー・アーキテクチャー拡張やカスタマイズが容易なモジュール設計により、新しいAIインテリジェンス機能の研究開発を促進する。
• 豊富なツールセット内蔵ファイル操作（作成、編集、読み込み）、Bashコマンド実行、構造化問題分解、その他一連のユーティリティ。
• YOLOモードワンタッチ確認」モードの提供Ctrl+Y)、インテリジェンスがコマンドラインからすべての操作を自動化し、ワークフローをスピードアップすることを可能にする。
• 実績知的身体（エージェント）の思考や操作を詳細に記録し、デバッグや行動解析のための軌跡ファイルを生成します。
• インテリジェント・コンフィギュレーション初回実行時に設定ウィザードが自動的に起動し、APIキーなど必要な設定を案内します。
• セッション統計APIコール数、トークンの消費量、各種ツールの利用状況をリアルタイムで把握できます。

ヘルプの使用

このヘルプは公式のドキュメントに基づいており、ユーザーがすぐにPywenを使い始め、使いこなせるようになることを目的としています。

1.インストール

Pywen は Python パッケージとしてpipコマンドでPyPIリポジトリから直接インストールできます。ターミナルを開き、以下のコマンドを実行してください：

pip install pywen

インストールが完了したら、ターミナルで任意のパスを使用できるようになります。pywen命令だ。

2.初めての使用と設定

インストール後、ターミナルに直接次のように入力する。pywenコマンドでプログラムを開始する：

pywen

初めて実行する場合は、Pywenは設定ファイルがないことを検出し、自動的に設定ウィザードを起動します。

Configuration file not found, starting setup wizard...
API Key: [在这里输入你的Qwen API Key]
Base URL: https://dashscope.aliyuncs.com/compatible-mode/v1
Model: qwen3-coder-plus
...
✅ Configuration saved to pywen_config.json

プロンプトに従って、AliCloud Dashscope (Tongyi Qianqian)から取得したAPI Keyを入力するだけで、基本的な設定が完了します。設定ファイルpywen_config.jsonはカレント・ディレクトリに保存される。

3.基本的な使い方

一度設定すると、Pywenは対話型のコマンドラインインターフェイスに移行する。まるで人間と会話しているかのように、自然言語で直接タスクを与えることができる。
例えば、こうしてみてはどうだろう：

> 创建一个Python脚本来计算斐波那契数列
> 重构 main.py 里的函数，让它们更高效
> 修复这个项目里的bug，并为主要功能添加单元测试
> 创建一个新的Flask Web应用，并包含合理的文件结构

Pywenのインテリジェンスは、あなたのニーズを分析し、ファイル操作、コード生成、シェルコマンドなどのツールを呼び出して、ステップバイステップでタスクを完了します。

4.システムコマンド

Pywenには、以下のような関数が用意されている。/番組管理や情報照会用のコマンドを最初から内蔵：

• /helpヘルプ情報を表示します。
• /toolsスマートボディが現在使用可能なすべてのツールをリストアップ。
• /statsAPIコール数やTokenの使用状況など、現在のセッションに関する統計情報を表示します。
• /clear画面と現在の対話履歴を消去します。
• /memoryインテリジェンスの記憶内容の閲覧と管理。
• /quitパイウェンのプログラムを終了する。
• !<命令>Pywenを終了せずに直接シェル/CMDコマンドを実行する。 !ls -l.

5.YOLOモード（使用には注意が必要）

これは、実行効率を向上させるための高度な機能である。

• スイッチング方式プレスCtrl+YYOLOモードはオン／オフの切り替えが可能。
• デフォルトの動作通常モードでは、スマートボディは、潜在的にリスクのある操作（例えば、ファイルの変更、コマンドの実行）を実行する必要があるときはいつでも、ユーザーに確認を求める。
• YOLOモデルの行動オンにすると、すべてのツールコールが自動的に承認され、ユーザーによる手動確認が不要になります。これにより、タスクが大幅にスピードアップしますが、セキュリティもなくなります。
• リスク警告YOLOモードでは、AIが指示を誤認し、誤った操作や破壊的な操作を行う可能性があります。明確なミッション目標と管理可能なリスクをもって、このモードを使用してください。

6.環境と構成

パイウェン・スルーpywen_config.jsonファイルでのコンフィギュレーションが可能で、環境変数もサポートされている。

• 設定ファイルプログラムが起動すると、カレント・ディレクトリのpywen_config.json.
• 環境変数環境変数を設定してAPIキーを提供することも可能で、CI/CD（継続的インテグレーション）やDocker環境では特に便利です。

  # Qwen API Key (必需)
  export QWEN_API_KEY="your-qwen-api-key"
  # 工具API Key (推荐配置，用于增强功能)
  export SERPER_API_KEY="your-serper-api-key"  # 用于网页搜索
  export JINA_API_KEY="your-jina-api-key"      # 用于读取网页内容
  

• 優先順位の設定コマンドライン引数＞プロファイル＞環境変数＞デフォルト。

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

1. ラピッドプロトタイピング
   新しいアイデアが浮かんだら、コマンドラインで直接Pywenに伝えることができます。「FastAPIでToDoリストアプリケーションのバックエンドサービスを作成し、データベースモデルと追加、削除、チェックAPIを含む。
2. コードのリファクタリングと最適化
   プロジェクト内の古いコードや非効率なコードは、Pywenにお任せください。data_processor.pyファイルのパフォーマンスのボトルネックを分析し、その中の関数をリファクタリングして効率を改善する。インテリジェンスは、関数はそのままに、コードを読み、分析し、修正する。
3. 自動テストとデバッグ
   Pywenはテストフレームワークを呼び出し、テストを実行し、エラーレポートを分析し、自動的にバグを修正しようとします。
4. AI インテリジェント・ボディ・アーキテクチャーの研究
   AI研究者にとって、Pywenは実験に最適なプラットフォームです。そのモジュール設計と透過的な軌跡ロギング機能は、新しいエージェント決定ロジック、ツールの組み合わせ、記憶メカニズムをテストしたり、軌跡ファイルを分析することで研究仮説を検証したりするのに簡単に利用できます。

品質保証

1. Q: PywenとQwen3-Coderの関係は？
   A: Pywenは上位のアプリケーションツールです。 Qwen3-コーダー は、その基盤となる駆動エンジンです。Qwen3-Coderは、コンテンツを考えたり生成したりする「頭脳」であり、Pywenは、この「頭脳」がコンピュータのファイルシステムやコマンドラインとやりとりできるようにする「体」や「手足」を提供し、ユーザーフレンドリーなコマンドラインインターフェイスを提供するものである、と理解することができます。Pywenは、"脳 "があなたのコンピュータのファイルシステムやコマンドラインとやりとりするための "身体 "と "手足 "を提供し、ユーザーフレンドリーなコマンドラインインターフェイスを提供する。
2. Q：パイウェンの利用は無料ですか？
   A: Pywen ソフトウェア自体はオープンソースでフリーです（MITライセンスに準拠）。ただし、Aliyun Tongyi Qianqian (Dashscope)が提供するQwenモデルAPIの呼び出しによって動作します。これらのAPI呼び出しにはコストがかかり、Aliyunの公式価格に従ってAPI Keyの使用料を支払う必要があります。
3. Q: なぜSERPER_API_KEYやJINA_API_KEYを設定する必要があるのですか？
   A: これらはオプションの強化ツールです。SERPER_API_KEYインテリジェンスにウェブ検索機能を持たせることで、インテリジェンスが自分の知識外の問題に遭遇したときや、最新の情報を必要とするときに、オンラインで情報を検索できるようにする。JINA_API_KEYこれにより、インテリジェンスはウェブコンテンツを効率的に「読み取り」、理解することができる。これらを設定することで、インテリジェンスの能力の限界を大きく広げることができる。
4. Q：YOLOモデルの具体的なリスクは？
   A: AIがあなたの指示を誤って解釈する危険性があります。例えば、「古いログファイルをクリーンアップしてください」と指示した場合、その指示が十分に明確でないと、AIは重要な設定ファイルも「古いファイル」と誤って認識し、削除を実行してしまう可能性があります。YOLOモードでは、この削除はあなたの確認なしに行われるため、プロジェクトの破損やデータ損失を引き起こす可能性があります。